Dépannage Voice

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

Un appel sortant est absent du journal d'appels

Un appel que Bird ne peut pas accepter est refoulé au niveau de la couche SIP, avant qu'un enregistrement n'existe. Cinq causes expliquent cela :

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.

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 :

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.
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.
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.
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.

Page	Contenu
Journal d'appels	Chaque champ d'un enregistrement d'appel et chaque motif de rejet
Trunks SIP	La liste d'autorisation IP, les clés, les identifiants de session et Digest
Configuration client SIP	Les paramètres demandés par chaque softphone et PBX
Passer des appels	Ce que Bird attend sur le INVITE, et le déroulement du handshake
Recevoir des appels	Pointer un numéro vers un trunk ou un renvoi, et ce qui est enregistré

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Comprendre le conceptWhat is a voice API?Explorer la fonctionnalitéVoice Guide d'implémentationVoice overview

Obtenir un guide d'implémentation