Crochets web pour les messages entrants et l'état des messages

Vous devez configurer les webhooks des messages entrants et de l'état des messages.

Configurer les URL de votre webhook

Vous devez configurer au moins deux webhooks :

  • Message Status webhook
  • Message entrant webhook

Lorsque des mises à jour de l'état des messages sont générées, telles que delivered, rejected ou acceptedles rappels seront reçus sur la page Statut du message URL du webhook.

Lorsqu'un message entrant est reçu, un rappel avec la charge utile du message est invoqué sur le serveur Message entrant URL du webhook.

IMPORTANT : Les deux URLs du webhook doivent être configurées. Au minimum, vos gestionnaires de webhook doivent renvoyer des réponses 200 pour les rappels de message entrant et d'état du message. Cela permet de s'assurer que les file d'attente pour les rappels sont évitées.

Pour configurer les URL des webhooks

  1. Si vous avez déjà a créé une applicationmais que vous n'avez pas encore configuré vos webhooks, allez à Vos Applications et sélectionnez l'application à configurer.

  2. Cliquez sur Editer pour modifier les URL des webhooks de l'application.

  3. Dans la section Capacités des messages, saisissez les URL de vos webhooks dans les champs intitulés URL de l'état et URL entrant.

Les valeurs que vous saisissez pour les URL de webhook dépendent de l'endroit où se trouve votre serveur webhook. Par exemple :

Crochet Web URL
URL de l'état https://www.example.com/webhooks/message-status
URL entrant https://www.example.com/webhooks/inbound-message

NOTE : Nous recommandons d'utiliser Authentification basée sur JWT car cela vous permet de configurer les URL de vos webhooks de réception et de livraison au niveau de la page d'accueil. au niveau de l'application. Dans le cas contraire, tous les rappels de vos différentes Applications seront envoyés à votre URL des webhooks au niveau de l'Account.

NOTE : Les rappels sont envoyés par POST Requêtes HTTP.

Test local via Ngrok

Si vous souhaitez tester votre application localement, vous pouvez utiliser Ngrok.

Voir nos informations sur Utiliser Ngrok pour le développement local

Si vous utilisez Ngrok de cette manière, vous devez utiliser les URL de Ngrok pour les URL de vos webhooks :

  • https://abcdef1.ngrok.io/webhooks/inbound-message
  • https://abcdef1.ngrok.io/webhooks/message-status

File d'attente Webhook

Veuillez noter que les webhooks émanant de Vonage, tels que ceux de l'URL du webhook de l'état des messages et de l'URL des messages entrants, sont mis en file d'attente par Vonage sur la base de chaque message.

Veuillez vous assurer que toutes les Applications reconnaissent les webhooks avec une réponse 200.

Crochets web signés

Afin de valider l'origine de vos webhooks, vous pouvez valider la signature des webhooks, voir les instructions. ici

Utilisation des webhooks en production

Si les URL des Webhooks pour les messages dans votre Account API Vonage sont déjà utilisés en production et que vous souhaitez en obtenir un second pour utiliser l'API Messages, veuillez envoyer un courriel à l'adresse suivante soutien et demandez une clé de sous-API.