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.

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'une trace 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. Copiez le domaine tel quel depuis la page du trunk au lieu de le reconstituer.

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 qui ne pointe vers aucune destination. 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 l'Inbound route 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 ne pointait vers rien, ce qui est aussi l'état d'un numéro après la suppression de son trunk ou la désactivation des appels entrants.
2. Vérifiez que le trunk possède une passerelle. Un trunk sans passerelle de livraison refuse chaque appel vers les numéros qu'il dessert, et l'enregistrement indique no_route_found. Ajoutez-en une sous Inbound calling sur la page du trunk.
3. Vérifiez l'adresse de la passerelle. Bird contacte les passerelles par ordre de priorité 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.

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.

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.

Étapes suivantes