Définir votre webhook

<ph type="x-smartling-placeholder">

Un webhook est un rappel HTTPS créé par un partenaire qui spécifie la manière dont votre agent doit répondre aux messages et aux événements. À moins que vous n'utilisiez une solution comme Dialogflow, vous devez définir un webhook personnalisé pour définir le comportement de votre agent.

Webhooks au niveau du partenaire et de l'agent

Vous pouvez définir votre webhook au niveau du partenaire ou de l'agent. Les webhooks au niveau du partenaire s'appliquent à tous les agents que vous gérez, tandis que les webhooks au niveau de l'agent les webhooks s'appliquent chacun à un seul agent.

Si vous gérez plusieurs agents ayant un comportement distinct, vous pouvez définir un un webhook différent pour chaque agent à l'aide du paramètre au niveau de l'agent. De l'autre Si vos agents ont un comportement similaire ou si vous n'avez qu'un seul agent, utiliser le webhook de partenaire.

Si un webhook de partenaire et un webhook d'agent sont configurés, le webhook au niveau de l'agent est prioritaire sur son agent spécifique, tandis que le Le webhook au niveau du partenaire s'applique aux agents qui n'ont pas d'agent le webhook.

Définir le webhook au niveau du partenaire

Pour définir le webhook au niveau du partenaire, procédez comme suit:

  1. Ouvrez la console développeur Business Communications. et connectez-vous avec votre compte Google Business Messages.
  2. Ouvrez la page Paramètres du compte.
  3. Assurez-vous que le bon compte partenaire est sélectionné.
  4. Pour URL du webhook Business Messages, cliquez sur Configurer.
  5. Dans le champ URL du point de terminaison du webhook, saisissez l'URL de votre application suivie de "/rappel/". Par exemple, il peut s'agir de "https://ID_PROJET.appspot.com/callback/".
  6. Notez la valeur clientToken. Vous en aurez besoin pour vérifier que les messages que vous recevez proviennent de Google.

  7. Configurez votre webhook de sorte qu'il accepte une requête POST avec les le paramètre clientToken et envoyer une réponse 200 OK avec le texte brut ; du paramètre secret en tant que corps de la réponse. Par exemple, supposons que votre Le webhook reçoit une requête POST dont le corps est le suivant:

    {
"clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    Dans ce cas, le webhook doit confirmer la valeur clientToken et, si clientToken est la bonne réponse. Renvoyez une réponse 200 OK avec 0123456789 comme corps de la réponse.

  8. Dans la console, cliquez sur Valider. Lorsque Business Messages valide votre webhook, la boîte de dialogue se ferme.

Définir un webhook au niveau de l'agent

Vous recevez les messages envoyés à votre agent au niveau du webhook de partenaire. Si vous que les messages d'un agent spécifique arrivent sur un webhook différent, définir un webhook au niveau de l'agent.

  1. Ouvrez la console développeur Business Communications. et connectez-vous avec votre compte Google Business Messages.
  2. Cliquez sur votre agent.
  3. Cliquez sur Integrations (Intégrations).
  4. Pour Webhook, cliquez sur Configurer.
  5. Dans le champ URL du point de terminaison du webhook, saisissez l'URL de votre webhook, commençant par "https://".
  6. Notez la valeur clientToken. Vous en avez besoin pour vérifier que les messages que vous proviennent de Google.

  7. Configurez votre webhook de sorte qu'il accepte une requête POST avec les le paramètre clientToken et envoyer une réponse "200 OK" avec la valeur de secret. Par exemple, supposons que votre webhook reçoive une requête POST avec le corps du texte suivant:

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    Dans ce cas, le webhook doit confirmer la valeur clientToken et, si clientToken est correct, renvoyez une réponse 200 OK avec l'URL du secret défini sur 0123456789.

  8. Dans la console, cliquez sur Valider. Lorsque Business Messages valide votre webhook, la boîte de dialogue se ferme.