Utiliser les webhooks pour suivre les conversations en temps réel

Ce guide vous explique comment utiliser les webhooks afin d’estimer le coût total des conversations au cours d’une période de facturation donnée.

Avant de le lire, assurez-vous de bien comprendre ce que sont les Webhooks pour la plateforme WhatsApp Business.

Suivi des conversations par leur identifiant

Quand une entreprise envoie un message à un utilisateur dans une nouvelle session de conversation, le système génère un ID pour cette conversation. Le premier message envoyé par l’entreprise avec cet ID de conversation est facturé quand il est distribué et marque le début des 24 heures de la session de conversation.

L’envoi et la distribution d’un message ne sont pas toujours simultanés. Un certain délai peut survenir quand, par exemple, le téléphone de l’utilisateur est éteint au moment de la distribution du message. Dans ce cas, le système prépare la session de conversation quand le message est envoyé. Un ID de conversation est associé à cette session « pré-démarrée ». Quand le message est distribué, l’heure de début de la session de conversation est actualisée.

L’image illustre un exemple exagéré de cette situation. La plupart des messages sont distribués quelques secondes après leur envoi.

Tout message envoyé qui n’a pas été distribué dans les 30 jours suivants est retiré. Si un ID de conversation a été généré pour un message envoyé qui n’a pas été distribué, la conversation associée à cet ID n’est pas facturée.

Estimation du coût des conversations par période de facturation

Deux éléments permettent d’estimer les coûts : l’indicatif pays du destinataire et la catégorie de la conversation. Ces deux éléments sont pris en considération pour déterminer les tarifs applicables. Vous pouvez télécharger des fiches de tarifs spécifiques.

Pour connaître la catégorie d’une conversation, vérifiez l’objet pricing (tarifs) des notifications webhooks. Pour en savoir plus sur l’identification des types de conversations avec les webhooks, consultez Notifications de statuts et tarifs.

Lorsque vous connaissez la catégorie de conversation et l’indicatif pays du destinataire, consultez les notifications webhooks et comptez le nombre d’ID de conversations uniques qui ont été distribuées. Vous saurez ainsi combien de conversations ont eu lieu pendant la période de facturation. Quand l’état du message est sent (envoyé) dans la notification webhook, la conversation correspondante n’est pas facturée.

Dans certains cas, vous pouvez recevoir seulement une notification avec le statut « read » (lu) ou « delivered » (distribué). Dans les deux cas, cela signifie que votre message a été distribué. La plupart du temps, vous recevrez ces deux notifications.

Si une conversation couvre deux périodes de facturation, aucuns frais supplémentaires ne seront facturés le mois de la seconde période de facturation pour cette conversation. La période de facturation de la conversation est déterminée par l’horodatage de distribution du premier message envoyé par l’entreprise, selon le fuseau horaire du compte WhatsApp Business.

Les webhooks sont le meilleur moyen de suivre les indicateurs de conversation en temps réel.

Pour obtenir plus d’informations, consultez la page À propos de la facturation de votre compte WhatsApp Business.