Webhook festlegen

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

Ein Webhook ist ein von einem Partner erstellter HTTPS-Callback, der angibt, wie Ihr Agent auf Nachrichten und Ereignisse antworten soll. Sofern Sie keine vordefinierte automatisierte wie Dialogflow, müssen Sie einen benutzerdefinierten Webhook festlegen, um das Verhalten des Agents zu definieren.

Webhooks auf Partner- und Agent-Ebene

Sie können den Webhook entweder auf Partner- oder Agent-Ebene festlegen. Webhooks auf Partnerebene gelten für jeden Agent, den Sie verwalten, während Webhooks auf Agent-Ebene Webhooks gelten jeweils für einen einzelnen Agent.

Wenn Sie mehrere Agents mit unterschiedlichem Verhalten betreiben, können Sie für jeden Agent mithilfe der Einstellung auf Agent-Ebene einen eigenen Webhook. Auf der anderen Wenn Ihre Kundenservicemitarbeiter ein ähnliches Verhalten zeigen oder nur einen Kundenservicemitarbeiter haben, den Webhook auf Partnerebene verwenden.

Wenn Sie einen Webhook auf Partnerebene und einen Webhook auf Agent-Ebene konfiguriert haben, hat der Webhook auf Agent-Ebene Vorrang bei seinem spezifischen Agent, während der Der Webhook auf Partnerebene gilt für Agents, die keine Agent-Ebene haben Webhook.

Webhook auf Partnerebene festlegen

So richten Sie einen Webhook auf Partnerebene ein:

  1. Öffnen Sie die Business Communications Developer Console. und melden Sie sich mit Ihrem Google-Konto für Business Messages an.
  2. Öffnen Sie die Kontoeinstellungen.
  3. Achten Sie darauf, dass das richtige Partnerkonto ausgewählt ist.
  4. Klicken Sie bei Business Messages-Webhook-URL auf Konfigurieren.
  5. Geben Sie unter Webhook-Endpunkt-URL die URL Ihrer Anwendung + „/callback/“ ein. Beispiel: "https://PROJECT_ID.appspot.com/callback/".
  6. Notieren Sie sich den clientToken-Wert. Sie benötigen sie, um zu überprüfen, ob eingehende Nachrichten von Google stammen.

  7. Konfigurieren Sie Ihren Webhook so, dass er eine POST-Anfrage mit dem angegebenen clientToken-Parameter und senden Sie eine 200 OK-Antwort mit dem Nur-Text des Secret-Parameters als Antworttext. Angenommen, Ihre Der Webhook erhält eine POST-Anfrage mit dem folgenden Textinhalt:

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

    In diesem Fall sollte der Webhook den Wert clientToken bestätigen und, falls clientToken ist richtig, geben Sie eine 200 OK-Antwort mit 0123456789 als Antworttext.

  8. Klicken Sie in der Console auf Bestätigen. Wenn Business Messages Ihren Webhook bestätigt, wird das Dialogfeld geschlossen.

Webhook auf Agent-Ebene festlegen

Sie erhalten Nachrichten, die an Ihren Agent im Webhook auf Partnerebene gesendet werden. Wenn Sie dass Nachrichten für einen bestimmten Agent an einen anderen Webhook gesendet werden sollen, kann einen Webhook auf Agent-Ebene festlegen.

  1. Öffnen Sie die Business Communications Developer Console. und melden Sie sich mit Ihrem Google-Konto für Business Messages an.
  2. Klicken Sie auf den Agent.
  3. Klicken Sie auf Integrations (Integrationen).
  4. Klicken Sie für Webhook auf Configure (Konfigurieren).
  5. Geben Sie unter Webhook-Endpunkt-URL die URL des Webhooks ein, beginnend mit „https://“ ist.
  6. Notieren Sie sich den clientToken-Wert. Sie benötigen ihn, um zu bestätigen, dass Sie die von Google empfangen werden.

  7. Konfigurieren Sie Ihren Webhook so, dass er eine POST-Anfrage mit dem angegebenen clientToken und senden Sie die Antwort „200 OK“ mit dem Wert des Parameters Secret verwenden. Angenommen, Ihr Webhook erhält eine POST-Anfrage mit dem folgenden Textinhalt:

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

    In diesem Fall sollte der Webhook den Wert clientToken bestätigen und, falls clientToken ist richtig; gibt eine 200 OK-Antwort mit der Secret-URL zurück Parameter auf 0123456789 festgelegt.

  8. Klicken Sie in der Console auf Bestätigen. Wenn Business Messages Ihren Webhook bestätigt, wird das Dialogfeld geschlossen.