Fournisseur de messages

Le fournisseur Messages vous permet d'écouter les webhooks de l'application Messages API.

Fonctions

  • onMessage - cette fonction vous permet d'écouter les messages entrants à l'aide de l'API Messages. Voir l'extrait de code ici.
  • onMessageEvent - cette fonction vous permet d'écouter les événements entrants à l'aide de l'API Messages. Voir l'extrait de code ici.

Utiliser le vcr.verifyAuth méthode permettant de vérifier que les callbacks proviennent bien de la plateforme Cloud Runtime. Étant donné que ce fournisseur achemine les webhooks via le routeur de callbacks VCR, vous devez également valider le X-Vonage-Webhook-Auth-Token en-tête permettant de confirmer que l'événement provient bien de Vonage. Voir Verify a Callback (vérifier un rappel) pour obtenir toutes les informations nécessaires.

Recevoir des SMS entrants Webhooks

Les SMS entrants vers vos numéros Vonage peuvent être gérés soit par l'API SMS, soit par l'API Messages. Vonage Cloud Runtime utilise l'API Messages, donc pour recevoir des SMS entrants dans vos applications, vous devrez mettre à jour vos paramètres API sur le tableau de bord de Vonage pour envoyer des webhooks de SMS entrants à l'API Messages :

API Settings SMS Webhook Toggle

Initialisation du fournisseur de messages

Pour utiliser le fournisseur de messages, vous devez créer une instance du fournisseur à l'aide d'une session :

const session = vcr.createSession();
const messaging = new Messages(session);

Cas d'utilisation

Par exemple, pour utiliser le fournisseur Messages afin d'écouter tous les messages SMS entrants à destination du numéro de Vonage :

const session = vcr.createSession();
const messaging = new Messages(session);

const vonageNumber = { type: "sms", number: "447700900000" };
const from = { type: "sms", number: null }; 

await messaging.onMessage("onMessage", from, vonageNumber);