Metrics
Métriques Twilio via l'API
Votre client connecte son compte Twilio et votre produit interroge 40 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:messages_sent",
"component": "number_v1",
"metrics": [
"messages_sent"
]
}
]
}Plus d'exemples d'appels Twilio
Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).
Graphique
Messages au fil du temps
Messages envoyés et reçus chaque jour de la période. Twilio regroupe l'utilisation par jour en UTC, donc un jour ici peut ne pas correspondre exactement au calendrier local.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:messages_by_day",
"component": "chart_v1",
"metrics": [
"messages_sent",
"messages_received"
],
"dimensions": [
"date"
]
}
]
}Tableau
Volume et dépense par canal
Messages et montant facturé par canal durant la période.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:channel_summary",
"component": "datatable_v1",
"metrics": [
"messages_total",
"total_spend"
],
"dimensions": [
"channel"
]
}
]
}Chiffre
Messages reçus
Messages SMS et MMS reçus sur vos numéros Twilio pendant la période.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "twilio:messages_received",
"component": "number_v1",
"metrics": [
"messages_received"
]
}
]
}Chiffres
29 métriques
Messages envoyés
Messages SMS, MMS et WhatsApp envoyés pendant la période, comptés par les enregistrements d'utilisation de Twilio.
twilio:messages_sentMessages reçus
Messages SMS et MMS reçus sur vos numéros Twilio pendant la période.
twilio:messages_receivedTotal des messages
Tous les messages envoyés et reçus pendant la période, totalisant SMS, MMS et WhatsApp.
twilio:messages_totalSMS envoyés
Messages SMS envoyés pendant la période.
twilio:sms_sentSMS reçus
Messages SMS reçus pendant la période.
twilio:sms_receivedMMS envoyés
Messages MMS envoyés pendant la période. Twilio ne propose des MMS qu'aux États-Unis et au Canada, donc les comptes en dehors de ces pays rapportent toujours zéro.
twilio:mms_sentMMS reçus
Messages MMS reçus pendant la période. Twilio ne propose des MMS qu'aux États-Unis et au Canada, donc les comptes en dehors de ces pays rapportent toujours zéro.
twilio:mms_receivedMessages WhatsApp
Messages de modèle et d'assistance envoyés par WhatsApp pendant la période. Les fenêtres de conversation gratuites sont facturées séparément et ne sont pas incluses dans ce décompte.
twilio:whatsapp_messagesSegments de message
Segments facturables dans tous les messages de la période. Un texte long est divisé en plusieurs segments, et c'est ce que Twilio facture.
twilio:message_segmentsMessages livrés
Messages envoyés avec livraison confirmée par l'opérateur, y compris les messages WhatsApp marqués comme lus.
twilio:delivered_messagesMessages non livrés
Messages acceptés par l'opérateur qui n'ont pas pu être livrés, généralement parce que le numéro est inaccessible ou bloqué.
twilio:undelivered_messagesMessages échoués
Messages que Twilio n'a pas pu livrer à l'opérateur.
twilio:failed_messagesTaux de livraison
Pourcentage de messages envoyés avec livraison confirmée, sur les messages qui ont atteint un état final. Les messages encore en transit ne sont pas inclus dans le calcul.
twilio:delivery_rateTaux d'échec
Pourcentage de messages envoyés qui ont échoué ou n'ont pas été livrés, sur les messages qui ont atteint un état final.
twilio:failure_rateTotal des appels
Appels pris en charge par le compte pendant la période, reçus et réalisés.
twilio:calls_totalAppels reçus
Appels reçus sur vos numéros Twilio pendant la période.
twilio:calls_inboundAppels réalisés
Appels réalisés par le compte pendant la période.
twilio:calls_outboundMinutes d'appel
Minutes de voix facturées pendant la période. Twilio arrondit chaque appel à la minute suivante, donc c'est ce montant qui est facturé et non le temps exact de conversation.
twilio:call_minutesDurée moyenne des appels
Temps moyen de conversation des appels pris en charge, mesuré en secondes réelles et non en minutes facturées.
twilio:avg_call_durationAppels répondus
Appels qui ont été pris en charge et terminés pendant la période.
twilio:completed_callsAppels occupés
Appels qui ont trouvé un signal occupé.
twilio:busy_callsAppels sans réponse
Appels qui ont sonné et n'ont pas été pris en charge.
twilio:no_answer_callsAppels échoués
Appels qui n'ont pas pu être connectés.
twilio:failed_callsTaux de réponse
Pourcentage d'appels pris en charge, sur les appels qui ont atteint un état final.
twilio:answer_rateDépenses Totales
Tout ce que Twilio a facturé au compte pendant la période, selon le total d'utilisation rapporté par elle. Les coûts sont des estimations jusqu'à ce que Twilio clôture la facture.
twilio:total_spendDépenses en SMS et MMS
Montant facturé pour le trafic de SMS et MMS pendant la période.
twilio:messaging_spendDépenses en WhatsApp
Montant facturé pour le trafic de WhatsApp pendant la période. Meta a commencé à facturer pour les modèles en juillet 2025, donc les comparaisons qui traversent cette date ne sont pas équivalentes.
twilio:whatsapp_spendDépenses en voix
Montant facturé pour les appels vocaux pendant la période.
twilio:voice_spendDépenses en numéros
Montant facturé pour les numéros de téléphone maintenus par le compte.
twilio:phone_numbers_spend
Graphiques
6 métriques
Messages au fil du temps
Messages envoyés et reçus chaque jour de la période. Twilio regroupe l'utilisation par jour en UTC, donc un jour ici peut ne pas correspondre exactement au calendrier local.
twilio:messages_by_dayTaux de livraison au fil du temps
Pourcentage de messages livrés chaque jour de la période. Twilio regroupe par jour en UTC, donc un jour ici peut ne pas correspondre exactement au calendrier local.
twilio:delivery_rate_by_dayAppels au fil du temps
Appels pris en charge chaque jour de la période. Twilio regroupe par jour en UTC, donc un jour ici peut ne pas correspondre exactement au calendrier local.
twilio:calls_by_dayDépenses au fil du temps
Montant facturé par Twilio chaque jour de la période. Twilio regroupe par jour en UTC, donc un jour ici peut ne pas correspondre exactement au calendrier local.
twilio:spend_by_dayMessages par canal
Comment le volume de messages de la période se divise entre SMS, MMS et WhatsApp.
twilio:messages_by_channelMessages par direction
Comment le volume de messages de la période se divise entre envoyés et reçus.
twilio:messages_by_direction
Tableaux
5 métriques
Volume et dépense par canal
Messages et montant facturé par canal durant la période.
twilio:channel_summaryDépense par produit
Montant facturé par Twilio par produit durant la période. Ce qui ne correspond pas aux produits listés est regroupé dans Autres, donc les lignes totalisent toujours la dépense totale.
twilio:spend_by_categoryMessages envoyés par statut
État final des messages envoyés durant la période, tel qu'indiqué par Twilio. Les messages reçus ne sont pas inclus.
twilio:messages_by_statusErreurs les plus fréquentes
Codes d'erreur de Twilio qui sont apparus le plus souvent durant la période, avec le message retourné par elle pour chacun.
twilio:top_error_codesAppels par statut
État final des appels durant la période, tel qu'indiqué par Twilio.
twilio:calls_by_status
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
