Journal d'appels

Le journal des segments sous Voice > Legs liste chaque connexion que votre espace de travail a passée ou reçue, de la plus récente à la plus ancienne. Un appel peut contenir plusieurs segments, comme les connexions entrante et renvoyée. Chaque entrée est un enregistrement détaillé d'appel (CDR), y compris les connexions restées sans réponse ou refusées. Utilisez-le pour examiner la durée, la réponse SIP finale et le coût.

Bird écrit chaque enregistrement à la fin du segment, de sorte que chaque entrée du journal a un résultat définitif. L'onglet Live à côté contient les segments encore en cours.

Pour l'interaction complète, ouvrez Voice > Calls. Un appel regroupe les segments et les participants associés. Conservez le Call ID pour la corrélation et le Leg ID pour examiner une connexion précise ; ils identifient des enregistrements différents.

La liste d'appels

Chaque ligne correspond à un segment. Un appel comportant plusieurs segments occupe plusieurs lignes :

Colonne	Ce qu'elle affiche
Status	Comment le segment s'est terminé (voir Statuts)
From	Le numéro appelant, l'identifiant de l'appelant présenté par votre équipement
To	Le numéro appelé
Direction	Sortant pour les segments émis par votre équipement, entrant pour ceux arrivés sur vos numéros
Duration	Durée totale du segment, depuis le moment où Bird l'a reçu jusqu'au raccroché
Started	Quand Bird a reçu le segment

La liste est paginée, 25 segments par page. Sélectionnez une ligne pour ouvrir l'enregistrement du segment.

Appels en cours

L'onglet Live liste les segments en cours en ce moment et affiche un compteur pour voir combien sont actifs sans l'ouvrir. Un segment en cours porte l'un des deux statuts suivants :

Statut	Ce qui se passe
Ringing	Une tentative d'appel active attend une réponse ; cela ne confirme pas que la destination a sonné
In progress	La destination a décroché et l'appel est connecté

Les colonnes correspondent au journal des segments, à l'exception de Elapsed, qui remplace Duration. Il compte à partir de la réponse pour un segment connecté et à partir du début pour un segment en sonnerie. L'onglet se rafraîchit toutes les quelques secondes. Quand un segment se termine, il passe dans le journal des segments avec son résultat définitif.

Recherche et filtrage

La page commence par une recherche par numéro et ses filtres. Ils se combinent : un filtre de statut associé à une plage de dates restreint les résultats aux segments correspondant aux deux critères.

Recherche par numéro. Le champ de recherche compare un numéro aux deux extrémités du segment, de sorte qu'une seule requête trouve les segments vers ce numéro et ceux provenant de ce numéro.

Direction. Filtrez par segments sortants ou entrants.

Status. Filtrez par answered, no answer, failed, rejected ou unknown. Chacun est défini dans Statuts. Dans l'onglet Live, les choix sont ringing et in progress.

Date. Dans le journal d'appels, choisissez un préréglage (les dernières 24 heures, 7 jours ou 30 jours) ou sélectionnez une plage personnalisée dans le calendrier.

Utilisation du mois

Le résumé mensuel contient trois tuiles pour le mois calendaire en cours en UTC :

Tuile	Ce qu'elle compte
Legs	Enregistrements de segments terminés dans le mois, y compris ceux sans réponse et refusés
Total duration	Durée totale de chaque segment cumulée, depuis le moment où Bird l'a reçu jusqu'au raccroché
Billable time	Durée cumulée entre la réponse et la fin de chaque segment

La différence entre la durée totale et le temps facturable correspond au temps de sonnerie sans réponse. Un segment sans réponse n'a pas de temps facturable.

Chaque tarif de destination arrondit le temps facturable à son incrément de facturation. Consultez Coût et facturation pour le détail des tarifs.

Ces tuiles couvrent l'intégralité du mois, quel que soit le filtre appliqué à la liste.

Statuts

Un segment dans le journal s'est terminé avec l'un de ces résultats :

Statut	Ce qui s'est passé
Answered	La destination a décroché. Le temps facturable va du décrochage au raccroché
No answer	La tentative a expiré sans réponse ; cela ne prouve pas que le téléphone de destination a sonné
Rejected	L'appel a été refusé au lieu d'être acheminé
Failed	L'appel a été tenté sans aboutir, et `SIP response` est la réponse obtenue
Unknown	Le résultat n'a pas pu être déterminé, par exemple quand aucune réponse finale n'est arrivée

Rejected couvre deux types de refus, et la raison du rejet les distingue. Soit Bird a refusé l'appel avant qu'un opérateur ne soit impliqué, auquel cas la raison nomme le contrôle échoué, soit l'interlocuteur distant l'a décliné directement, auquel cas SIP response contient sa réponse et il n'y a pas de raison. Un appel entrant rejeté par le numéro composé est également Rejected sans raison, car il n'a échoué à aucun contrôle : son Inbound route indique ce que le numéro devait faire. Voir Appels rejetés.

Un appel ayant atteint la durée maximale d'appel de la plateforme, soit 3 heures, est Answered, car il a été connecté puis coupé à la limite. Son temps facturable court du décrochage au moment où Bird a raccroché. Si l'appel exécutait une séquence, sa chronologie affiche Time limit reached comme fin du segment.

Failed n'est pas un refus. Il signifie que l'appel a été tenté sans aboutir : un numéro occupé est Failed avec la réponse opérateur 486, et un numéro non attribué est Failed avec 404.

Si vous lisez ces valeurs depuis vos propres outils, traitez ceux que vous gérez et considérez tout autre comme un statut non géré plutôt qu'une erreur. La liste contient aussi busy et canceled, réservés aux appels entrants acheminés vers vos propres numéros. Aucun des deux n'est émis pour l'instant, et les deux résultats sont signalés comme failed.

Inspecter un appel

L'ouverture d'un segment affiche ce que Bird a enregistré sur cette connexion :

Champ	Ce qu'il vous indique
Status	Le résultat du segment (voir Statuts). Un segment refusé par Bird affiche aussi la raison et la marche à suivre
Réponse SIP	Le code SIP final du segment, par exemple `200` ou `486`. Un segment refusé par Bird porte `503`, sans opérateur impliqué
From / To	Les deux numéros, chacun copiable
Inbound route	Sur un appel entrant, la route sélectionnée pour le numéro, comme un trunk, un transfert, une séquence ou un rejet. Lien vers ce numéro
Trunk	Le trunk SIP par lequel l'appel est arrivé ou a été acheminé, utile quand plusieurs sites partagent un espace de travail
Started	Quand Bird a reçu le segment
Answered	Quand le segment a obtenu réponse, ou Not answered
Ended	Quand le segment a été coupé
Leg ID	L'identifiant propre à l'enregistrement de connexion (`vcl_…`). Utilisez-le avec `GET /v1/voice/legs/{leg_id}` et communiquez-le au support.
Call ID	Partagé par tous les segments d'un même appel (`vcs_…`). Utilisez le filtre `call_id` pour trouver les segments associés. Un appel renvoyé a deux segments partageant le même identifiant.
Billing	Temps facturable, durée totale et coût du segment une fois tarifé

Inbound route apparaît sur les appels entrants et indique la route sélectionnée. Un acheminement vers un trunk sur un appel rejeté signifie que l'appel n'a pas abouti à une réponse effective. Réception d'appels décrit les routes et ce que chacune enregistre.

Appels rejetés

Un appel rejeté a été refusé au lieu d'être acheminé, et deux situations distinctes produisent ce résultat.

Bird l'a refusé avant qu'un opérateur ne soit impliqué. Avant de lancer l'appel, Bird vérifie l'identifiant d'appelant, la destination, les limites du compte et le solde du portefeuille, et refuse tout appel qui échoue à l'un de ces contrôles. Votre système téléphonique reçoit SIP 503, tandis que l'enregistrement d'appel authentifié stocke la raison précise. Cela empêche les appelants non authentifiés d'obtenir des détails sur le compte. Ouvrez l'appel pour voir la cause et un lien vers le paramètre concerné.

Le numéro composé a refusé l'appel. Un appel entrant vers un numéro configuré pour rejeter, ou vers un numéro que personne n'a pointé quelque part, est rejeté sans aucune raison : il n'a échoué à aucun de nos contrôles. C'est Inbound route qui l'indique. Réception d'appels détaille ces refus.

Les raisons ci-dessous relèvent du premier cas. Elles s'appliquent aussi bien aux appels entrants qu'aux appels sortants, car les limites du compte et le portefeuille sont vérifiés dans les deux sens.

Raisons que vous pouvez corriger

Raison	Ce qui s'est passé	Marche à suivre
`source_not_allowed`	L'appel est arrivé depuis une adresse non couverte par la liste d'adresses IP autorisées du trunk	Ajoutez l'adresse depuis laquelle votre système téléphonique émet au trunk
`caller_id_not_verified`	Le numéro dans l'en-tête `From` n'est ni un numéro Bird éligible ni un identifiant d'appelant externe vérifié dans cet espace de travail	Utilisez un numéro Bird éligible, ou vérifiez le numéro externe
`destination_not_enabled`	Les appels vers ce pays sont désactivés pour votre espace de travail	Activez le pays sous Destinations
`insufficient_balance`	Votre portefeuille ne couvrait pas l'appel, Bird l'a donc refusé d'emblée	Rechargez, ou activez les rechargements automatiques pour qu'un solde bas n'interrompe pas les appels
`daily_spend_exceeded`	L'appel aurait dépassé le plafond de dépenses vocales quotidien de votre organisation	Attendez la réinitialisation du plafond au début du jour UTC suivant, ou demandez à Bird de l'augmenter
`concurrent_calls_exceeded`	Vous avez autant d'appels simultanés que votre compte le permet	Attendez la fin d'un appel, ou contactez le support pour augmenter le plafond
`calls_per_second_exceeded`	Vous avez passé de nouveaux appels plus vite que votre compte ne le permet	Réduisez votre cadence de numérotation, puis réessayez. Réessayer immédiatement donne la même réponse
`number_ownership_not_verified`	Vous avez acheté ce numéro, mais le pays qui l'a émis n'a pas accepté les documents prouvant que vous en êtes propriétaire	Complétez ce que le champ `ownership` du numéro demande, puis relancez l'appel

Un automate d'appels peut atteindre calls_per_second_exceeded bien avant le plafond d'appels simultanés : vérifiez lequel des deux vous avez reçu avant de modifier quoi que ce soit.

Raisons que Bird résout pour vous

Celles-ci relèvent du côté de Bird. Contactez le support et indiquez le Leg ID figurant dans l'enregistrement :

Raison	Ce qui s'est passé
`routing_not_configured`	Le routage de votre espace de travail est encore en cours de rattachement, ce qui est normal pendant la finalisation d'une nouvelle configuration vocale
`no_route_found`	Le routage est rattaché, mais ne couvre pas le numéro que vous avez composé. Contactez le support avec l'ID du segment pour vérifier la route
`destination_blocked`	La configuration de routage de Bird bloque les appels vers cette destination
`call_not_permitted`	Bird n'a pas pu finaliser l'appel pour votre compte et l'a donc refusé plutôt que de le passer à des conditions inconnues

Comment lire un refus

Lisez le statut et la raison du rejet ensemble :

Rejected avec une raison de rejet. Bird a refusé l'appel, et la raison identifie le contrôle échoué. Le SIP response est le 503 que votre système téléphonique a reçu. Suivez la résolution compte ou routage indiquée par la raison.
Rejected sans raison de rejet. Sur un appel sortant, l'interlocuteur distant l'a décliné directement et SIP response contient son code. Sur un appel entrant, le numéro composé l'a refusé, et Inbound route indique ce que ce numéro devait faire.
Failed. L'appel a été tenté sans aboutir, et SIP response contient le code obtenu en retour. Un 486 signifie occupé, tandis qu'un 404 signifie que le numéro n'est pas attribué. Cela pointe généralement vers le numéro plutôt que vers votre configuration.

Un appel que Bird ne peut pas du tout admettre est rejeté avant qu'un enregistrement n'existe : il n'apparaît jamais dans le journal. Dépannage vocal couvre ces appels.

Extraire les enregistrements

Quatre façons d'exploiter ces enregistrements en dehors du tableau de bord :

Export CSV. Download CSV dans l'onglet Leg log exporte les enregistrements correspondant à vos filtres actuels, toutes pages confondues, jusqu'à 10 000 segments. Une sélection plus large renvoie une erreur sans fichier ; réduisez votre plage de dates ou vos filtres et exportez chaque sélection séparément. Utilisez-le pour le rapprochement et les rapports ponctuels.
Lecture via API. GET /v1/voice/legs renvoie la liste filtrée, et GET /v1/voice/legs/{leg_id} renvoie un seul enregistrement. Les deux nécessitent une clé API avec le scope voice au niveau read. Consultez la référence API pour les opérations publiées relatives aux autres ressources Voice et leurs scopes requis.
Lecture depuis le terminal. Le Bird CLI fournit bird voice legs list, bird voice legs get et bird voice stats. Le serveur MCP expose les mêmes lectures aux agents.
S'abonner aux événements. voice_call.initiated, voice_call.answered et voice_call.ended sont poussés vers votre endpoint au fil des appels, pour que vos systèmes restent à jour sans interrogation périodique. Voir Événements vocaux.

Étapes suivantes

Page	Ce qu'elle couvre
Événements vocaux	Les trois événements d'appel, leurs payloads et comment les consommer
Passer des appels	Ce que Bird attend sur le `INVITE`, et comment un appel est tarifé
Recevoir des appels	Pointer un numéro vers un trunk ou un transfert, et ce qui est enregistré
Trunks SIP	La liste d'adresses IP autorisées, les clés API autorisées et les paramètres Digest
Destinations vocales	Activer des pays et ce que signifie la disponibilité
Erreurs	La réponse d'erreur API et ses champs de reprise

Poursuivez avec la documentation, les guides et les exemples sur ce sujet.

Obtenir un guide d'implémentation

Ressources associées