Le webhook ne reçoit ni rapports ni réponses

Lorsque les rapports de livraison ou les SMS entrants (réponses) n'arrivent pas sur votre webhook, la cause se trouve généralement dans les paramètres de l'application dans le portail ou sur votre serveur. Vous trouverez ci-dessous comment trouver le problème et ce qu'il faut envoyer au support si cela ne suffit pas.

Le webhook est-il défini sur la bonne application ?

Le webhook se définit séparément pour chaque application (API). Si vous envoyez via plusieurs applications ou portefeuilles, vérifiez celle par laquelle vos messages partent réellement.

1. Dans le portail, ouvrez Modules & APIs.
2. Sous My APIs and Modules, ouvrez la carte de l'application.
3. Dans l'onglet Réglages, vérifiez la tuile Delivery reports dans la section Web hooks.

Si la tuile affiche Vous n'avez aucun paramètre., aucun webhook n'est défini. La procédure est décrite dans Webhook.

L'envoi uniquement en cas d'erreur est-il activé ?

L'option Prévenir en cas d'erreur n'envoie un rapport de livraison que pour les messages en échec. Rien n'arrive pour les messages remis. Si vous voulez tous les rapports de livraison, désactivez cette option.

Attendez-vous le bon format de données ?

• Mode par défaut : une requête par message, en GET. Le format est décrit dans Confirmations de livraison.
• Bulk DLRs - bulk request : un lot d'enregistrements en POST avec application/json. Le format est décrit dans Confirmations de livraison groupées.

Si votre serveur attend un autre format, la requête arrive, mais votre application ne la traite pas.

Votre serveur répond-il correctement ?

• L'adresse doit être accessible depuis Internet et commencer par http:// ou https://.
• Le serveur doit répondre rapidement et avec le code d'état 200. Un traitement lent ou en erreur retarde la livraison des rapports suivants. Placez les traitements lourds dans une file d'attente et confirmez la requête immédiatement.
• Un pare-feu ou une protection anti-bots ne doit pas bloquer nos requêtes. Consultez les journaux de votre serveur. Les requêtes sont-elles arrivées, et avec quelle réponse ?

Pourquoi les SMS entrants n'arrivent-ils pas ?

Les réponses n'arrivent que si le message est parti avec un type d'expéditeur qui prend en charge les SMS bidirectionnels dans le pays du destinataire. Plus d'informations dans SMS bidirectionnels et numéros dédiés. Avec votre numéro propre et Mobile Connect, les réponses arrivent sur votre téléphone, et non sur le webhook.

Ce qu'il faut envoyer au support

Si vous avez passé en revue les points ci-dessus et que les données n'arrivent toujours pas, écrivez-nous via le formulaire de contact avec le sujet API et envoyez :

• l'ID du message d'origine (voir ID du message,
• l'URL que vous avez définie pour les rapports de livraison,
• pour les SMS entrants, une capture d'écran du téléphone montrant l'heure et le texte de la réponse,
• ce que vous voyez dans le journal de votre serveur (la requête n'est pas arrivée, ou elle est arrivée avec une erreur).

Questions fréquentes

Comment fonctionnent les rapports de livraison SMS ?

Un rapport de livraison (confirmation de livraison) vous indique ce qu'il est advenu du message dans le réseau de l'opérateur, c'est-à-dire s'il a été remis ou non. BulkGate enregistre le statut avec le message, vous le voyez donc dans l'historique des messages du portail. Si l'application a un webhook défini pour Delivery reports, le rapport est aussi envoyé à votre URL. Les confirmations arrivent généralement en quelques minutes. La signification de chaque statut est décrite dans Le message n'a pas été remis.

De quelles adresses IP provient le webhook ?

Si vous devez autoriser nos serveurs dans votre pare-feu, écrivez-nous avec le sujet API.

Puis-je recevoir les rapports de livraison par e-mail ?

Avec l'interface Email > SMS, les rapports de livraison sont envoyés par e-mail à l'adresse Email delivery reports, et non à une URL.