Analyse
Voyez ce que l'opérateur a vu.
Consultez le volume accepté, la livraison déclarée par l'opérateur, les résultats de non-livraison et la latence dans Bird. Utilisez le tableau de bord pour un aperçu rapide ou l'API de statistiques pour le reporting. Les envois récents peuvent encore être en attente d'un accusé de réception : interprétez les résultats en tenant compte du cycle de vie du message.
De l'envoi à son résultat
Exemple de rapport
Acceptés
1,000
Taux de livraison
96%
Livrés960
Résultats de non-livraison25
En attente d'un résultat15
Données illustratives. Le taux de livraison utilise les messages acceptés comme dénominateur. Les envois récents peuvent rester en suspens ; les accusés de réception des opérateurs ne mesurent ni les ouvertures ni les clics.
Des équipes qui créent des logiciels de classe mondiale nous font confiance au quotidien
Découvrir plus de témoignages clientsLe volet reporting de la même API.
Rien de nouveau à instrumenter.
Les analytics constituent le volet reporting de l<hub>Bird SMS API</hub>. Le tableau de bord et lAPI de statistiques résument les messages acceptés et les résultats observés. Utilisez-les pour identifier des tendances, puis ouvrez un message individuel lorsque vous avez besoin de son historique de livraison déclaré.
Ce qu'un accusé de réception vous indique.
Lisez la métrique en regard de sa définition.
- 01
Taux de livraison.
Le taux de livraison correspond aux messages livrés divisés par les messages acceptés, sans taux lorsque le dénominateur accepté est zéro. Les comptages utilisent une agrégation de valeurs distinctes approximative à grande échelle. Les cohortes récentes peuvent évoluer à mesure que les accusés de réception arrivent.
- 02
Raisons d'échec par opérateur.
Comparez les codes d'échec et les ventilations par opérateur lorsque les dimensions déclarées sont disponibles. Une hausse identifie où investiguer ; l'enregistrement de l'expéditeur, les conditions du destinataire et les défaillances du fournisseur nécessitent des remèdes différents.
- 03
Segments et coût.
Inspectez l'encodage, les segments et le coût connu à ce stade pour chaque message. L'API de statistiques compte les résultats des messages ; ce n'est ni un relevé de facturation ni une mesure des segments facturés.
- 04
Latence jusqu'à la livraison.
Inspectez la latence de traitement, de livraison opérateur et totale aux p50, p95 et p99. Comparez la queue de distribution sur plusieurs périodes pour identifier une destination ou un opérateur nécessitant une investigation.
Interrogez les chiffres depuis votre propre code.
Interrogez les séries temporelles et les ventilations disponibles par pays, opérateur, expéditeur, catégorie, erreur et tag. Elles résument les événements observés pour la cohorte d'acceptation. Les dimensions peuvent se chevaucher : additionner les lignes par tag ou les résultats terminaux ne permet pas de reconstituer un total unique de manière fiable.
// One endpoint per dimension, and one dimension per row: "by country and
// carrier" is two calls, not one grouped query.
const { data: byCarrier, error } = await bird.sms.stats
.byCarrier({ from: "2026-06-01", to: "2026-06-26" })
.safe();
if (error) throw error;
console.log(byCarrier.data[0]);
// → {
// carrier: "Vivo",
// delivery: {
// accepted: 14820,
// sent: 14810,
// delivered: 14720,
// undelivered: 60,
// failed: 25,
// delivery_rate: 0.9932,
// },
// latency: { processing: { p50_ms: 480, p95_ms: 2310, p99_ms: 4100 } },
// }
Extrayez la chronologie d'un seul message.
Pour un message individuel, récupérez sa chronologie d'événements et son statut actuel. La lecture publique des messages couvre 30 jours. Les événements peuvent arriver en retard ou être dupliqués ; interprétez l'heure d'occurrence et les erreurs déclarées plutôt que de supposer que l'ordre d'arrivée des webhooks correspond à l'ordre de livraison.
const { data: events, error } = await bird.sms
.listEvents("sms_01m11jw130e7svjzv70kgqr38w")
.safe();
if (error) throw error;
console.log(events.data);
// → [
// { id: "evt_01m11jw196...", type: "sms.accepted", occurred_at: "2026-06-26T10:00:00.110Z" },
// { id: "evt_01m11jw19h...", type: "sms.sent", occurred_at: "2026-06-26T10:00:00.640Z" },
// { id: "evt_01m11jx4c2...", type: "sms.delivered", occurred_at: "2026-06-26T10:00:02.300Z" },
// ]
Découpez les mêmes envois selon la forme de la question.
Choisissez la ventilation qui correspond à votre question et gardez visibles les dimensions manquantes et les comptages en chevauchement.
| Dimension | Ce qu'elle vous indique |
|---|---|
| Pays | Où la livraison tient bon et où une destination tire le taux global vers le bas. |
| Opérateur déclaré | Quel opérateur déclaré est associé à une tendance de livraison ou d'échec. |
| Expéditeur | Quels identifiants d'expéditeur ou numéros sont associés à un résultat ; il ne s'agit pas d'un score de réputation. |
| Tranche horaire | Quand un taux a évolué, afin qu'une baisse coïncide avec un déploiement, un changement d'enregistrement ou une panne. |
Approfondissez dans la documentation.
Construisez votre propre stockage à partir des webhooks de livraison, lisez le guide de délivrabilité pour comprendre la signification des codes d'échec, et rapprochez les comptes de la facturation et de l'utilisation.
Les accusés proviennent de la couche de routage.
Utilisez les recommandations de routage pour comprendre le chemin d'envoi. Les messages entrants pour les numéros bidirectionnels disposent d'une famille de statistiques entrantes distincte basée sur l'heure de réception. Les métriques de livraison sortante restent regroupées par heure d'acceptation.
Mettez-le en pratique.
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Questions avant de commencer
Comment le taux de livraison est-il calculé ?
Qu'est-ce qui est comptabilisé dans le taux d'échec ?
Puis-je ventiler un rapport par opérateur ?
Les rapports SMS incluent-ils les ouvertures et les clics ?
Puis-je inspecter un message individuel ?
Le reste de la plateforme SMS
Une seule API, un seul jeu de clés. Explorez les autres capacités.
Les métriques sont livrées avec l'API qui les produit.
Utilisez le reporting conjointement avec l'API d'envoi. Passez d'une tendance agrégée à un message individuel, inspectez ses événements et décidez s'il faut modifier votre audience, la configuration de l'expéditeur ou l'intégration.