Définir votre webhook

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 automatisée prédéfinie telle que 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 au niveau de l'agent. Les webhooks de partenaire s'appliquent à tous les agents que vous gérez, tandis que les webhooks d'agent s'appliquent à un seul agent.

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

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

Définir votre webhook de partenaire

Pour définir votre webhook de partenaire, procédez comme suit:

  1. Ouvrez la Console développeur de Business Communications et connectez-vous avec votre compte Google Business Messages.
  2. Ouvrez les Paramètres du compte.
  3. Assurez-vous que le bon compte partenaire est sélectionné.
  4. Dans le champ 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 "/callback/". Par exemple, il peut s'agir de "https://PROJECT_ID.appspot.com/callback/".
  6. Notez la valeur clientToken. Vous devez l'utiliser pour vérifier que les messages que vous recevez proviennent de Google.

  7. Configurez votre webhook pour qu'il accepte une requête POST avec le paramètre clientToken spécifié et envoie une réponse 200 OK avec la valeur en texte brut du paramètre secret comme corps de la réponse. Par exemple, supposons que votre webhook reçoit une requête POST avec le contenu du corps suivant:

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

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

  8. Dans la console, cliquez sur Valider. Lorsque Business Messages vérifie 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 au niveau du partenaire. Si vous souhaitez que les messages d'un agent spécifique arrivent à un autre webhook, vous pouvez définir un webhook au niveau de l'agent.

  1. Ouvrez la Console développeur de Business Communications et connectez-vous avec votre compte Google Business Messages.
  2. Cliquez sur votre agent.
  3. Cliquez sur Integrations (Intégrations).
  4. Dans le champ Webhook, cliquez sur Configure (Configurer).
  5. Pour 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 recevez proviennent de Google.

  7. Configurez votre webhook pour accepter une requête POST avec le paramètre clientToken spécifié et envoyez une réponse 200 OK avec la valeur du paramètre secret. Par exemple, supposons que votre webhook reçoive une requête POST avec le contenu du corps suivant:

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

    Dans ce cas, votre webhook doit confirmer la valeur clientToken et, si clientToken est correct, renvoyer une réponse 200 OK avec le paramètre d'URL secret défini sur 0123456789.

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