Diese Seite wurde von der Cloud Translation API übersetzt.

Mit Business Messages registrieren

Wenn Sie sich als Partner bei Business Messages registrieren, können Sie Unterhaltungen zwischen Nutzern und Marken aktivieren, indem Sie Agents erstellen – dialogorientierte Entitäten, die Geschäftsfunktionen wie Websitesupport und Markenstandorte darstellen.

Wenn ein Nutzer eine Marke findet, die Sie in der Google Suche oder auf Google Maps verwalten, wird in den Suchergebnissen eine Option Chat angezeigt. Wenn der Nutzer auf Chat klickt, kann er Nachrichten an den Agent der Marke senden. Mit dem Agent können Sie die Nachrichten des Nutzers empfangen und beantworten.

Als Partner registrieren

Wenn Sie sich als Partner bei Business Messages registrieren, Agents für Marken erstellen und die APIs nutzen, auf denen Ihr Agent basiert, können Sie die Nachrichtenfunktion für Kundenservice, Vertrieb und andere Geschäftsanwendungen aktivieren.

Öffnen Sie die Developer Communications Developer Console.
Klicken Sie unter Business Messages auf Partnerkonto erstellen.

Geben Sie Werte für Ihre Partnerinformationen ein:

Feld	Wert
Name	Ihr vollständiger Name
Name des Partners	Name der Organisation
Website des Partners	Website der Organisation
Region	Die Region, in der Sie den Business Messages-Dienst hosten möchten

Lesen und akzeptieren Sie die Nutzungsbedingungen für Business Messages.
Klicken Sie auf Erstellen.

Sie sind jetzt als Business Messages-Partner registriert und haben Zugriff auf die Business Messages und Business Communications APIs. Die Business Messages API sendet Nachrichten an Nutzer, während die Business Communications API Agents verwaltet.

Dienstkonto erstellen

Sie benötigen einen Dienstkontoschlüssel und das Befehlszeilentool oauth2l, um API-Aufrufe der Business Messages API und der Business Communications API sicher zu authentifizieren.

Klicken Sie auf der Startseite der Business Communications Developer Console auf Partnerkontoeinstellungen.
Klicken Sie im linken Navigationsbereich auf Dienstkonto.
Klicken Sie auf Schlüssel erstellen und dann auf Erstellen.

Ihr Dienstkonto lädt den Dienstkontoschlüssel herunter. Bewahren Sie Ihren Dienstkontoschlüssel an einem sicheren, privaten Ort auf. Geben Sie Ihren Schlüssel nicht öffentlich weiter. Sie benötigen diesen Schlüssel später, um auf die Business Message und Business Communication APIs zuzugreifen.

Notebook einrichten

Nachdem die Business Messages and Business Communications API aktiviert ist, müssen Sie die Webhook-URL angeben, um Nachrichten empfangen zu können.

Öffnen Sie die Kontoeinstellungen in der Business Communications Developer Console.
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 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, die Sie erhalten, von Google kommen.
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 Parameters secret als Antworttext sendet.

Beispiel: Ihr Webhook empfängt eine POST-Anfrage mit dem folgenden Textinhalt:
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
Der Webhook sollte 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 Business Messages den Webhook bestätigt, wird das Dialogfeld geschlossen.

Unter Beispiel: Webhook-URL aktualisieren erfahren Sie, wie Sie Ihren Webhook mit den Business Communication APIs konfigurieren.

Partnerinformationen abrufen

Um Ihre aktuellen Partnerinformationen zu erhalten, können Sie die Business Communications API mit Ihrer Partner-ID abfragen.

Führen Sie den folgenden Befehl aus: Ersetzen Sie PARTNER_ID durch Ihre Partner-ID.


# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"get-partner.sh

Partnerinformationen aktualisieren

Sie können Ihre Partnerinformationen auf der Seite Kontoeinstellungen in der Business Communications Developer Console aktualisieren oder die folgenden Befehle ausführen.

Ersetzen Sie PARTNER_ID durch Ihre Partner-ID(Partner-ID finden Sie in der Business Communications Developer Console) und UPDATED_FIELDS durch die Feldnamen, die Sie aktualisieren.


# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'update-partner.sh

Formatierungs- und Wertoptionen finden Sie unter partners.patch.

Beispiel: Anzeigenamen aktualisieren

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

Beispiel: Webhook-URL aktualisieren

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

Nächste Schritte

Nachdem Sie ein registrierter Partner sind und die APIs aktiviert haben, können Sie mit der Entwicklung von Business Messages beginnen. Informationen zum schnellen Einstieg finden Sie unter Ersten Agent erstellen.

Andernfalls erfahren Sie, wie Sie Agents erstellen, um Ihre Marken in Unterhaltungen darzustellen und Ihren Webhook so zu konfigurieren, dass Nachrichten von Nutzern empfangen werden.