Dépannage Voice

Commencez par le journal d'appels. La présence d'un enregistrement et ses champs déterminent les vérifications à suivre.

Pour les appels lancés via l'API, vérifiez d'abord la réponse Create Call et l'historique des exécutions. Consultez le dépannage des séquences pour la prévisualisation, la publication, les parcours au clavier et les routes de séquences entrantes. Les vérifications de connexion ci-dessous concernent les appels passant par des trunks SIP.

Si vous ne voyez aucun enregistrement d'appel, vérifiez d'abord ces points :

1. Vous êtes dans le bon espace de travail. Les enregistrements d'appels appartiennent à l'espace de travail qui détient le numéro ou le trunk. Basculez vers celui-ci, puis ouvrez Voice > Legs.
2. L'appel a atteint Bird. Pour un appel entrant, l'opérateur de l'appelant décide où va l'appel, et un numéro pointé vers un trunk sans passerelle enregistrée refuse l'appel avant qu'un enregistrement n'existe. Pour un appel sortant, consultez Un appel sortant est absent du journal d'appels : une admission refusée ne laisse aucun enregistrement.
3. Les filtres ne le masquent pas. Effacez le filtre de statut et élargissez la plage de dates.

Un appel sortant est absent du journal d'appels

Pour un appel passé via un trunk SIP, un échec d'admission peut survenir avant qu'un enregistrement de segment n'existe. Vérifiez ces causes courantes :

• Le trunk ne prend pas encore en charge les appels sortants. Un nouveau trunk ne transporte aucun appel tant que vous n'avez pas activé les appels sortants sur sa page, et il refuse chaque tentative jusque-là, quels que soient les identifiants présentés par l'appel.
• Le trunk n'a pas encore de moyen de vous reconnaître. Un nouveau trunk rejette chaque appel tant que vous n'ajoutez pas une plage d'adresses IP, une clé API autorisée, ou des identifiants de session.
• L'appel provenait d'une adresse extérieure à la liste d'autorisation IP du trunk. Derrière un NAT, comparez l'adresse publique du routeur avec la liste d'autorisation IP du trunk. L'adresse privée du système téléphonique n'atteint pas Bird.
• L'authentification par mot de passe a échoué. Vérifiez que le nom d'utilisateur est bird. Le mot de passe doit être le secret d'une clé API autorisée ou un identifiant de session non expiré. Le trunk doit aussi proposer l'algorithme Digest utilisé par votre système téléphonique.
• L'appel était adressé à un domaine SIP que Bird ne reconnaît pas. Votre équipement doit placer le domaine SIP du trunk dans l'hôte de la Request-URI. Copiez le domaine tel quel depuis la page du trunk au lieu de le reconstituer. Un appel adressé à un autre nom d'hôte ou une autre adresse Bird n'atteint pas votre trunk.

La réponse que reçoit votre équipement indique le contrôle qui a échoué. 407 Proxy Authentication Required signifie que le trunk demande un mot de passe ; avec les identifiants de session activés, il le demande à chaque appelant. 403 Forbidden signifie que le trunk n'a pas admis l'appel : un hôte de Request-URI qui n'est pas le domaine SIP de votre trunk, des appels sortants désactivés, une adresse hors de la liste d'autorisation ou un mot de passe non vérifié. 503 Auth Unavailable signifie que Bird n'a pas pu contrôler l'appel : réessayez-le.

Pour un appel de séquence, vérifiez d'abord si la demande d'appel a été acceptée et si une exécution existe. Une prévisualisation dans le simulateur ne passe aucun appel. Un test réel nécessite un brouillon enregistré ou une publication active, les permissions d'écriture pour la gestion et les appels Voice, un identifiant d'appelant éligible et une destination activée. Le guide du concepteur de séquences explique ces vérifications.

L'appel est rejeté avec un motif de rejet

Bird a refusé l'appel avant de contacter un opérateur, et le motif indique le contrôle qui a échoué. Ouvrez l'appel et utilisez le lien du panneau de rejet vers le paramètre concerné. Appels rejetés liste chaque motif et sa correction.

caller_id_not_verified est celui qu'un nouveau client rencontre le plus souvent, généralement parce que le client met le nom d'utilisateur digest là où l'identifiant de l'appelant doit figurer : ce sont deux champs distincts.

L'appel a échoué plutôt qu'être rejeté

Failed n'est pas un refus. L'appel a été tenté sans succès, et SIP response contient le code renvoyé. Un 486 correspond à un numéro occupé, un 404 à un numéro non attribué. Cela pointe généralement vers le numéro composé plutôt que vers votre configuration.

Un appel refusé par Bird est Rejected, et non Failed : filtrez donc le journal sur Rejected quand vous cherchez un appel qui a échoué à l'un des contrôles de Bird.

L'appel est rejeté sans motif de rejet

Sur un appel sortant, le correspondant l'a refusé directement et SIP response contient son code.

Sur un appel entrant, le numéro composé a refoulé l'appel, ce qui n'échoue à aucun contrôle et ne nomme donc aucun motif. Ouvrez l'appel et lisez Inbound route : une route reject est un numéro configuré pour refuser, ou un numéro sans route propre alors que la route par défaut de l'espace de travail est le rejet. Réception des appels détaille chaque refus entrant selon sa route et son motif.

La personne que vous avez appelée a vu un numéro différent

L'appel possède un enregistrement et aucun motif de rejet, il a donc passé tous les contrôles de Bird. Le problème se situe en aval de Bird : l'opérateur de terminaison a remplacé l'identifiant de l'appelant, ou a refusé un appel qui le présente. La même cause se manifeste par un numéro qui aboutit dans un pays et n'aboutit jamais dans un autre.

La vérification prouve que vous contrôlez un identifiant d'appelant. Elle n'oblige pas l'opérateur qui achemine l'appel à l'accepter, et les opérateurs appliquent leurs propres règles nationales à un numéro qui n'a pas été acquis via Bird. Consultez la clause de non-responsabilité sur la vérification et la livraison CLI pour les pratiques concernées, qui incluent les exigences CLI nationales, le blocage basé sur l'origine et les listes de numéros interdits à l'émission.

Pour savoir quel type de numéro vous avez présenté, ouvrez-le sous Voice > Numbers et lisez le panneau en haut de sa page. Un numéro acheté auprès de Bird affiche son abonnement, tout comme un numéro que vous avez acheté et également vérifié. Seul un numéro que vous possédez ailleurs affiche uniquement une vérification. Un abonnement signifie que le numéro a été acquis via Bird, et la clause de non-responsabilité ne s'y applique donc pas. Présenter un numéro acquis via Bird est ce qui améliore les taux de livraison et d'aboutissement vers les destinations qui rejettent un numéro vérifié.

Un appel entrant n'atteint jamais votre système téléphonique

Le numéro a répondu à l'appel, et c'est la livraison qui a échoué. Vérifiez dans cet ordre :

1. Lisez la route entrante de l'appel. Elle indique vers quel trunk ou renvoi le numéro pointait au moment de l'appel. Une route reject signifie que le numéro a sa propre route définie sur rejeter, ou qu'il n'a pas de route propre alors que la route par défaut de l'espace de travail est rejeter. Ouvrez le numéro pour voir lequel des deux : un numéro défini sur rejeter ignore la route par défaut. Un numéro dont le trunk a été supprimé ou dont les appels entrants sont désactivés revient à la route par défaut, et une route par défaut qui désigne ce trunk revient à rejeter.
2. Vérifiez que le trunk peut livrer. Ouvrez l'Inbound routing du trunk. Une passerelle doit faire partie d'un groupe, et la Default route (ou une règle) doit envoyer les appels vers ce groupe. Une route par défaut définie sur Reject refuse chaque appel sans motif de rejet, et un trunk sans passerelle enregistrée refuse l'appel avant qu'un enregistrement n'existe. Corrigez l'avertissement Calls never reach some gateways si le tableau de bord l'affiche lors de l'enregistrement.
3. Vérifiez l'adresse de la passerelle. Bird contacte les passerelles du groupe dans l'ordre défini par le groupe et abandonne quand aucune ne répond. Confirmez l'hôte de l'URI SIP, son port, et que votre système téléphonique accepte les appels provenant de Bird sur celui-ci.
4. Pour un renvoi, vérifiez que la cible est toujours vérifiée. La cible du renvoi est revérifiée à chaque appel ; un identifiant d'appelant que vous avez supprimé cesse donc de transférer à partir de ce moment.
5. Vérifiez la réponse de votre équipement. Un appel qui a atteint votre passerelle et y a été refusé est généralement Failed (une réponse 6xx apparaît comme Rejected), et SIP response contient le code de votre équipement, par exemple 403 ou 412. Bird a tenté l'appel, la correction se fait donc de votre côté : vérifiez que votre SBC accepte les appels provenant des adresses de signalisation de Bird et le format de numéro envoyé par la passerelle.

Si le numéro utilise Run a sequence, inspectez la séquence liée et l'entrée d'appel au lieu du trunk. Confirmez une publication active, une entrée qui accepte des données vides, et si l'appelant est un testeur de brouillon. Examinez le résultat d'exécution de la séquence et sa branche d'échec. Modifier un brouillon ne change pas la version utilisée par les appelants ordinaires.

Le téléphone dans le navigateur ne sonne pas ou ne peut pas composer

Vérifiez d'abord le statut en bas du téléphone :

1. Choisissez Online pour recevoir des appels. Un groupe de sonnerie ignore les membres Offline, Busy, déjà en communication, ou Not accepting calls après trois appels manqués consécutifs. Votre statut explique chacun d'eux.
2. Passez en ligne pour appeler. Un téléphone Offline ne peut pas passer d'appels. Les statuts Online, Busy et Not accepting calls le permettent.
3. Ramenez les appels dans ce navigateur. Dans chaque espace de travail, vous êtes en ligne sur un seul appareil et dans un seul onglet à la fois. Offline · Active on another device propose Take over, et Offline · Calls are handled in another tab propose Use here.
4. Vérifiez la limite d'utilisateurs en ligne. Offline · Limit of users online reached signifie que votre organisation compte déjà autant d'utilisateurs en ligne qu'elle en autorise. Consultez Limite d'utilisateurs en ligne.
5. Activez le son. Après un rechargement, votre navigateur peut bloquer la sonnerie tant que vous n'avez pas interagi avec la page. Le menu de statut propose alors Turn on sound.

Si le téléphone est en ligne et qu'un appel ne vous fait toujours pas sonner, lisez Inbound route de l'appel dans le journal d'appels. Ce champ indique le groupe de sonnerie que l'appel a fait sonner : vous pouvez ainsi vérifier que vous en êtes membre et que le numéro est routé vers ce groupe.

Votre client répond en MD5 et n'aboutit pas

Certains équipements gèrent mal un défi qui commence par SHA-256. Réglez le trunk sur MD5 uniquement.

Les appels se connectent mais le son est unidirectionnel

Votre client est derrière un NAT, et son flux média est dirigé vers une adresse privée. Activez la gestion NAT ou STUN dans le client.

Si votre équipement est joignable et que le son ne passe toujours pas dans un sens, vérifiez que votre pare-feu autorise les adresses média de Bird sur les ports UDP 2500 à 32499.

Étapes suivantes