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 :

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 :

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 :

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 :

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 qui atteint la durée maximale d'appel de la plateforme, soit 4 heures, a le statut Answered, car il a été connecté, puis s'est terminé à cette limite. Son temps facturable va du décrochage au moment où Bird a raccroché. Si l'appel a exécuté une séquence, sa chronologie affiche Time limit reached comme motif de 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 :

Inbound route apparaît sur les appels entrants et indique la route sélectionnée. Une route vers un trunk sur un appel rejeté signifie que l'appel n'a pas abouti à une réponse effective. Recevoir des 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 sans route propre alors que la route par défaut de l'espace de travail est le rejet, est rejeté sans aucune raison : il n'a échoué à aucune de nos vérifications. C'est le champ Inbound route qui l'indique. Recevoir des 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

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 :

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 indique le contrôle qui a échoué. Le champ SIP response contient le code 503 reçu par votre système téléphonique. Appliquez la solution indiquée pour cette raison, concernant le compte ou le routage. Sur un appel sortant, cette réponse 503 comporte un en-tête X-BIRD-CALL-ID contenant le Leg ID de l'enregistrement. Vous pouvez ainsi relier le refus à son enregistrement sans recouper les heures et les numéros.
• 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 :

• Exporter au format CSV. Le bouton Download CSV de l'onglet Leg log exporte les enregistrements correspondant à vos filtres actuels, toutes pages confondues, jusqu'à 10 000 segments. Une sélection plus volumineuse renvoie une erreur sans fichier ; réduisez la plage de dates ou affinez les filtres et exportez chaque sélection séparément. Le fichier contient les durées et le temps facturable, mais aucune colonne de coût. Consultez les frais dans Consommation, dépenses et factures.
• Les consulter via l'API. GET /v1/voice/legs et GET /v1/voice/legs/{leg_id} permettent de consulter les segments individuels. Les opérations GET /v1/voice/calls et GET /v1/voice/calls/{call_id} permettent de consulter les appels regroupés, comme le font le tableau de bord et la CLI. Toutes nécessitent une clé API avec la portée voice au niveau read. Consultez la référence API pour connaître les opérations publiées pour les autres ressources Voice et les portées requises.
• Les consulter depuis le terminal. La Bird CLI fournit les commandes bird voice calls list, bird voice calls get, bird voice legs list, bird voice legs get et bird voice stats. Le serveur MCP expose les mêmes opérations de lecture 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