Diese Seite wurde von der Cloud Translation API übersetzt.

Webhook festlegen

Ein Webhook ist ein von einem Partner erstellter HTTPS-Callback, der angibt, wie Ihr Agent auf Nachrichten und Ereignisse reagieren soll. Wenn Sie keine vordefinierte automatisierte Lösung wie Dialogflow verwenden, müssen Sie einen benutzerdefinierten Webhook festlegen, um das Verhalten für Ihren Agent zu definieren.

Webhooks auf Partner- und Agent-Ebene

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

Wenn Sie mehrere Agents mit unterschiedlichem Verhalten ausführen, können Sie mit der Einstellung auf Agent-Ebene einen anderen Webhook für jeden Agent festlegen. Wenn Ihre Agents jedoch ein ähnliches Verhalten haben oder nur einen Agent haben, können Sie den Webhook auf Partnerebene verwenden.

Wenn Sie sowohl einen Webhook auf Partnerebene als auch einen auf Agentsebene konfiguriert haben, hat der Webhook auf Agent-Ebene Vorrang vor seinem spezifischen Agent, während der Webhook auf Partnerebene für Agents gilt, die keinen Webhook auf Agent-Ebene haben.

Webhook auf Partnerebene festlegen

So legen Sie Ihren Webhook auf Partnerebene fest:

Öffnen Sie die Business Communications Developer Console und melden Sie sich mit Ihrem Google-Konto für Business Messages an.
Öffnen Sie die Kontoeinstellungen.
Achten Sie darauf, dass das richtige Partnerkonto ausgewählt ist.
Klicken Sie bei Webhook-URL für Business Messages auf Konfigurieren.
Geben Sie unter Webhook-Endpunkt-URL die URL der Anwendung und „/callback/“ ein. Dies kann beispielsweise „https://PROJECT_ID.appspot.com/callback/“ sein.
Notieren Sie sich den Wert für clientToken. Sie benötigen sie, um zu prüfen, ob Nachrichten von Google stammen.
Konfigurieren Sie Ihren Webhook so, dass er eine POST-Anfrage mit dem angegebenen Parameter clientToken akzeptiert und eine 200 OK-Antwort mit dem Nur-Text-Wert des Secret-Parameters als Antworttext sendet. Beispiel: Ihr Webhook empfängt eine POST-Anfrage mit dem folgenden Text:
```
{
"clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
In diesem Fall sollte der Webhook den Wert clientToken bestätigen und, wenn clientToken korrekt ist, eine 200 OK-Antwort mit 0123456789 als Antworttext zurückgeben.
Klicken Sie in der Console auf Bestätigen. Wenn der Webhook von Business Messages bestätigt wird, wird das Dialogfeld geschlossen.

Webhook auf Agent-Ebene festlegen

Sie erhalten Nachrichten an Ihren Agent über Ihren Webhook auf Partnerebene. Wenn Nachrichten für einen bestimmten Agent stattdessen an einen anderen Webhook gesendet werden sollen, können Sie einen Webhook auf Agent-Ebene festlegen.

Öffnen Sie die Business Communications Developer Console und melden Sie sich mit Ihrem Google-Konto für Business Messages an.
Klicken Sie auf Ihren Agent.
Klicken Sie auf Integrations (Integrationen).
Klicken Sie unter Webhook auf Konfigurieren.
Geben Sie unter Webhook-Endpunkt-URL die URL des Webhooks ein, die mit „https://“ beginnt.
Notieren Sie sich den Wert für clientToken. Sie benötigen sie, um zu prüfen, ob Nachrichten von Google stammen.
Konfigurieren Sie Ihren Webhook so, dass er eine POST-Anfrage mit dem angegebenen Parameter clientToken akzeptiert und eine 200-OK-Antwort mit dem Wert des Secret-Parameters sendet. Beispiel: Ihr Webhook empfängt eine POST-Anfrage mit dem folgenden Text:
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
In diesem Fall sollte der Webhook den Wert clientToken bestätigen und, wenn clientToken korrekt ist, eine 200 OK-Antwort mit dem geheimen URL-Parameter auf 0123456789 zurückgeben.
Klicken Sie in der Console auf Bestätigen. Wenn der Webhook von Business Messages bestätigt wird, wird das Dialogfeld geschlossen.