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"
      ]
    }
  ]
}
Exemple : « Messages envoyés » en octobre, comparé à septembre.

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_sent
  • Messages reçus

    Messages SMS et MMS reçus sur vos numéros Twilio pendant la période.

    twilio:messages_received
  • Total des messages

    Tous les messages envoyés et reçus pendant la période, totalisant SMS, MMS et WhatsApp.

    twilio:messages_total
  • SMS envoyés

    Messages SMS envoyés pendant la période.

    twilio:sms_sent
  • SMS reçus

    Messages SMS reçus pendant la période.

    twilio:sms_received
  • MMS 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_sent
  • MMS 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_received
  • Messages 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_messages
  • Segments 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_segments
  • Messages livrés

    Messages envoyés avec livraison confirmée par l'opérateur, y compris les messages WhatsApp marqués comme lus.

    twilio:delivered_messages
  • Messages 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_messages
  • Messages échoués

    Messages que Twilio n'a pas pu livrer à l'opérateur.

    twilio:failed_messages
  • Taux 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_rate
  • Taux 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_rate
  • Total des appels

    Appels pris en charge par le compte pendant la période, reçus et réalisés.

    twilio:calls_total
  • Appels reçus

    Appels reçus sur vos numéros Twilio pendant la période.

    twilio:calls_inbound
  • Appels réalisés

    Appels réalisés par le compte pendant la période.

    twilio:calls_outbound
  • Minutes 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_minutes
  • Duré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_duration
  • Appels répondus

    Appels qui ont été pris en charge et terminés pendant la période.

    twilio:completed_calls
  • Appels occupés

    Appels qui ont trouvé un signal occupé.

    twilio:busy_calls
  • Appels sans réponse

    Appels qui ont sonné et n'ont pas été pris en charge.

    twilio:no_answer_calls
  • Appels échoués

    Appels qui n'ont pas pu être connectés.

    twilio:failed_calls
  • Taux de réponse

    Pourcentage d'appels pris en charge, sur les appels qui ont atteint un état final.

    twilio:answer_rate
  • Dé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_spend
  • Dépenses en SMS et MMS

    Montant facturé pour le trafic de SMS et MMS pendant la période.

    twilio:messaging_spend
  • Dé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_spend
  • Dépenses en voix

    Montant facturé pour les appels vocaux pendant la période.

    twilio:voice_spend
  • Dé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_day
  • Taux 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_day
  • Appels 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_day
  • Dé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_day
  • Messages par canal

    Comment le volume de messages de la période se divise entre SMS, MMS et WhatsApp.

    twilio:messages_by_channel
  • Messages 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_summary
  • Dé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_category
  • Messages 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_status
  • Erreurs 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_codes
  • Appels 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.