Métriques vocales
La page Metrics du tableau de bord Bird agrège les segments d'appel que votre espace de travail a émis et reçus : combien ont abouti, combien de temps ils ont duré, comment ils se sont terminés et où ils sont allés. Utilisez-la pour le reporting d'appels sur une période. Pour suivre un appel précis, ouvrez le journal des appels.
Un appel peut contenir plusieurs segments, comme les connexions créées par un transfert ou par l'appel d'un autre participant. Chaque segment est compté séparément dans ces métriques.
Un segment est comptabilisé sur l'heure à laquelle il a commencé et agrégé une fois terminé ; le compartiment le plus récent continue donc de se remplir tant que des appels sont en cours. La page nécessite les accès en lecture voice et analytics sur votre rôle d'espace de travail.
Consulter vos métriques
Ouvrez Voice > Metrics. Quatre onglets partagent un sélecteur de période et une ligne de filtres : Overview, Call quality, Numbers and routing et Traffic patterns. Changer d'onglet conserve votre période et vos filtres.
Le sélecteur de période propose les dernières 24 heures ou 7, 30 ou 90 jours, et démarre à 7 jours. Les périodes en jours regroupent par jour calendaire local ; la période de 24 heures est une fenêtre glissante de 24 compartiments horaires. Faire glisser la souris sur un graphique temporel restreint toutes les cartes de la page à cet intervalle.
Quatre filtres se combinent : Your number (votre extrémité du segment), Destination (le pays de destination du segment), trunk SIP et Outcome. Chaque filtre appliqué apparaît sous forme de pastille que vous pouvez supprimer, et la plupart des cartes comportent une commande qui applique le filtre correspondant à la ligne consultée.
Taux de réponse et durée d'appel
L'onglet Overview commence par cinq tuiles. Les quatre premières affichent la variation par rapport à la fenêtre précédente de même durée :
- Answer-seizure ratio : segments décrochés divisés par toutes les tentatives de la période. Les tentatives restées sans réponse restent au dénominateur, de sorte que l'ASR baisse à la fois quand une route cesse d'aboutir et quand les numéros que vous composez ne décrochent pas. Sa variation est une différence en points de pourcentage.
- Average call duration : la durée facturable moyenne des segments décrochés. Les segments sans réponse sont exclus, donc l'ACD ne renseigne pas sur la fréquence d'aboutissement des appels. Quelques segments très longs tirent la moyenne au-dessus de la médiane ; la distribution des durées dans l'onglet Call quality montre cet écart.
- Total legs et Answered legs : les deux décomptes utilisés pour calculer l'ASR.
- Distinct numbers : le nombre de numéros différents à l'autre extrémité, chacun compté une seule fois quel que soit le nombre de segments associés. Comparé au nombre total de segments, il distingue le trafic réparti entre de nombreux interlocuteurs du trafic concentré sur quelques-uns.
Volume d'appels et taux de réponse dans le temps
Le graphique de tendance empile les segments décrochés et les autres segments pour représenter le volume total de la période sur l'axe gauche. Il trace l'ASR sous forme de courbe sur un axe droit allant de 0 à 100 %. La granularité suit la période : par heure sur 24 heures, par jour pour les autres périodes. Lire les deux ensemble permet de distinguer croissance et dégradation : une courbe stable sous des barres en hausse indique davantage de trafic sur une route qui continue d'aboutir ; une courbe en baisse sous des barres stables indique une route qui n'aboutit plus. View all legs, sous la carte, ouvre le journal des segments pour la même période.
Comment les appels se sont terminés
Un graphique en anneau et sa légende répartissent les tentatives de segments de la période selon leur résultat final, avec un nombre et une part du total pour chacun :
| Résultat | Signification |
|---|---|
| Answered | Le segment a abouti |
| No answer | Expiration du délai, ce qui ne prouve pas que le téléphone a sonné |
| Failed | Refusé par l'extrémité distante ou le réseau |
| Rejected | Décliné par l'extrémité distante, ou refusé par Bird |
| Unknown | Le résultat n'a pas pu être déterminé |
| Other | Un résultat que cette liste ne nomme pas encore |
Un résultat sans segment sur la période n'apparaît pas. Pour savoir pourquoi un appel a été refusé plutôt qu'à quelle fréquence, ouvrez les segments : Appels refusés décrit le motif que Bird consigne pour chacun.
Principaux pays
Le tableau des pays classe les 10 premiers pays de destination par volume de segments, et son pied indique combien de pays ont eu de l'activité sur la période. Le pays est la destination du segment : le pays appelé pour un segment sortant et celui de votre propre numéro pour un segment entrant.
Sur une période exprimée en jours, le pied du tableau indique aussi la part de vos segments couverte, et chaque ligne représente sa part par une barre. La période de 24 heures omet ces deux informations : la répartition porte sur des journées calendaires locales entières, tandis que les tuiles au-dessus couvrent 24 heures glissantes. Les deux totaux mesurent donc des quantités différentes, et calculer une part entre eux serait trompeur. Passez à 7 jours ou plus pour obtenir le taux de couverture.
Chaque ligne indique le nombre de segments, la répartition Out / In pour ce pays et son ASR. Un ASR par pays nettement inférieur à celui de la page est généralement le premier signe d'un problème de routage limité à une destination. Un tiret remplace la répartition lorsqu'elle n'a pas pu être établie.
Qualité d'appel
L'onglet Call quality présente les mesures de connexion et la distribution des durées. Une mesure apparaît quand Bird l'a relevée dans la période ; une mesure absente signifie que Bird n'a rien mesuré, ce qui est différent d'un mauvais score :
- Ring delay, médiane et 95e percentile : combien de temps l'appelant a attendu entre la composition et la première sonnerie. Un écart entre les deux indique une route qui aboutit généralement vite et parfois non.
- Audio quality : la note d'opinion moyenne, l'évaluation standard de 1 à 5 du son d'un appel, calculée sur les segments où elle a été mesurée. Une connexion normale obtient une note supérieure à 4. En dessous, filtrez sur un trunk ou une destination pour déterminer si la baisse se limite à une route. Vérifiez aussi les segments courts dans le même onglet, car une route qui aboutit sans transporter d'audio fait évoluer les deux métriques.
- Short legs : les segments décrochés qui se sont terminés en moins de 30 secondes, exprimés en pourcentage des segments décrochés. Pour le trafic sortant, une hausse de cette part indique généralement une route qui aboutit sans transporter d'audio.
How long legs run répartit les segments décrochés en six tranches de durée facturable, de moins de 30 secondes à 10 minutes et plus, avec la durée moyenne au-dessus. La durée facturable correspond au temps après décrochage : cette distribution est donc celle sur laquelle reposent vos frais Voice.
Trafic entrant et sortant
L'onglet Numbers and routing sépare les deux directions qu'une vue combinée masque. Les tuiles comptent les Outbound legs et les Inbound legs, avec leur variation par rapport à la période précédente, à côté des Active numbers et des Active trunks pour les numéros et les trunks ayant transporté du trafic. Direction over time empile les deux directions par intervalle : une variation limitée au trafic entrant devient visible là où la tendance combinée l'atténue.
Sous le graphique, un tableau ventile la période par votre numéro, le pays de votre numéro, le trunk SIP ou la direction, avec les segments, les segments décrochés, l'ASR et l'ACD dans des colonnes triables. Le pays de votre numéro est votre propre extrémité du segment, un axe différent du pays de destination dans l'onglet Overview. Les lignes de trunks permettent d'identifier le trunk dégradé : comparez leurs ASR plutôt que d'en lire un isolément. Les libellés des numéros et des trunks renvoient à leur fiche, et les récapitulatifs de numéros ouvrent une vue paginée et consultable par recherche de tous les numéros ayant porté des segments.
Profils de trafic
L'onglet Traffic patterns profile l'arrivée des appels dans votre fuseau horaire local : votre jour de la semaine et votre heure les plus chargés, une grille jour-de-la-semaine par heure, et un profil heure par heure. La grille et le profil horaire nécessitent une période supérieure à un jour, et la grille affiche au maximum les 30 derniers jours ; sur une période de 90 jours, elle le signale. Le profil par jour de la semaine apparaît lorsque la période couvre 14 jours ; en dessous, chaque jour de la semaine ne comporte qu'une seule observation.
Accès programmatique
Utilisez les opérations de statistiques CLI ou MCP pour récupérer les agrégats derrière le tableau de bord. Ces opérations d'agrégation ne disposent pas encore d'un contrat public HTTP ou SDK publié. Pour du reporting HTTP ou SDK, utilisez les enregistrements publics de segments décrits ci-dessous pour calculer vos propres agrégats.
- Le CLI. bird voice stats summary renvoie l'agrégat de période affiché par les tuiles, et bird voice stats daily et bird voice stats hourly renvoient les séries derrière le graphique de tendance. Les ventilations sont by-country, by-trunk, by-number, by-number-country, by-weekday, by-hour-of-day, et by-response-code, qui regroupe les appels par code SIP final et n'est pas représentée dans le tableau de bord. Les commandes acceptent les mêmes filtres de fenêtre, fuseau horaire, destination, numéro, trunk et résultat que la page applique, à une exception près : by-response-code n'accepte que la fenêtre, le fuseau horaire et --direction, et sa fenêtre est en jours calendaires plutôt qu'en instants ; elle répond donc sur une population plus large qu'une page filtrée. L'accès en lecture seule qu'accorde un simple bird auth login suffit pour toutes. Consultez le guide Bird CLI pour l'installation et l'authentification.
- Agents. Le serveur MCP expose les mêmes lectures de statistiques sous forme d'outils.
- Vos propres agrégats. Pour du reporting personnalisé ou un entrepôt de données, GET /v1/voice/legs renvoie des traces de segments filtrés, et l'export CSV du journal des segments couvre les enregistrements correspondant à vos filtres actuels. Les événements vocaux envoient les transitions d'appel vers votre endpoint. Réconciliez-les avec les traces de segments terminés, car des événements peuvent manquer ou arriver dans le désordre.
Les chiffres du CLI et du tableau de bord correspondent pour la même fenêtre quand ils utilisent le même fuseau horaire. Le tableau de bord envoie votre fuseau horaire enregistré à chaque lecture ; une commande sans --timezone regroupe en UTC.
Étapes suivantes
| Page | Contenu couvert |
|---|---|
| Journal des appels | Les segments individuels derrière ces agrégats, et pourquoi l'un a été refusé |
| Événements vocaux | Les événements d'appel à consommer pour votre propre reporting |
| Passer des appels | Ce que Bird lit sur un INVITE, et comment un appel est tarifé |
| Dépannage | Remonter d'un symptôme à une cause quand une métrique évolue dans le mauvais sens |
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éVoiceGuide d'implémentationVoice overview
Obtenir un guide d'implémentation