Mit Business Messages registrieren

Wenn Sie sich als Partner bei Business Messages registrieren, können Sie Folgendes aktivieren: Kommunikation zwischen Nutzenden und Marken durch Erstellen von Agents Entitäten, die Geschäftsfunktionen wie Website-Support und Branding darstellen, Standorte.

Agent: Eine dialogorientierte Darstellung einer Marke, die von einem Partner verwaltet wird. Enthält alle für die Interaktion mit der Benutzeroberfläche sowie jeglichen Code oder jede Infrastruktur, die für den Betrieb Interaktion.

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

Als Partner registrieren

Indem Sie sich als Partner in Business Messages registrieren, Agents für Marken erstellen Und mit den APIs, die Ihrem Agent zugrunde liegen, können Sie Messaging aktivieren für den Kundenservice, den Vertrieb und andere Geschäftsanwendungen.

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

3. Geben Sie Werte für Ihre Partnerinformationen ein:

   Feld	Wert
   Ihr Name	Dein 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

Hinweis :Wenn Sie einen Produktions-Agent mit Business Messages starten möchten, müssen Sie sich registrieren nicht mit einer privaten E-Mail-Adresse, sondern mit einer geschäftlichen E-Mail-Adresse.

1. Lesen und akzeptieren Sie die Nutzungsbedingungen für Business Messages

2. Klicken Sie auf Erstellen.

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

Dienstkonto erstellen

Zur sicheren Authentifizierung von API-Aufrufen an die Business Messages API und die Business Communications API benötigen Sie einen Dienstkontoschlüssel und die oauth2l-Befehlszeilentool.

1. Klicken Sie auf der Startseite der Business Communications Developer Console auf Einstellungen für Partnerkonten.
2. Klicken Sie im linken Navigationsbereich auf Dienstkonto.

3. Klicken Sie auf Schlüssel erstellen und dann auf Erstellen.

   Der Browser lädt den Dienstkontoschlüssel herunter. Bewahre deinen Dienstkontoschlüssel an einem sicheren, privaten Ort auf. Das sollten Sie nicht tun: Ihren Schlüssel öffentlich freigeben. Sie benötigen diesen Schlüssel später, um auf die Business Message API und die Business Communication APIs zuzugreifen.

Hinweis :Wenn Sie Business Messages-Partner mit einem eigenen GCP-Konto sind, können Sie in der Google Cloud Console auf Ihre Dienstkontoschlüssel zugreifen.

Webook festlegen

Jetzt, da die Business Messages API und die Business Communications API aktiviert sind, muss Ihre Webhook-URL angegeben werden, Nachrichten empfangen.

1. Öffnen Sie die Kontoeinstellungen in der Business Communications Developer Console.
2. Achten Sie darauf, dass das richtige Partnerkonto ausgewählt ist.
3. Klicken Sie bei Business Messages-Webhook-URL auf Konfigurieren.
4. Geben Sie unter Webhook-Endpunkt-URL die URL des Webhooks ein, beginnend mit „https://“ ist.
5. Notieren Sie sich den clientToken-Wert. Sie benötigen ihn, um zu bestätigen, dass Sie empfangene stammen von Google

6. Konfigurieren Sie den Webhook so, dass er eine POST-Anfrage mit dem angegebenen clientToken-Parameter und senden Sie die Antwort 200 OK mit dem Nur-Text des secret-Parameters als Antworttext verwenden.

   Wenn Ihr Webhook beispielsweise eine POST-Anfrage mit folgendem Inhalt erhält Inhalt des Texts

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

   sollte der Webhook den Wert clientToken bestätigen. Wenn clientToken gleich korrekt, geben Sie eine 200 OK-Antwort mit 0123456789 als Antworttext zurück.

7. Klicken Sie in der Console auf Bestätigen.

   Wenn Business Messages den Webhook bestätigt, wird das Dialogfeld geschlossen.

Weitere Informationen finden Sie unter Beispiel: Webhook-URL aktualisieren um zu erfahren, wie Sie Ihren Webhook mit den Business Communication APIs konfigurieren.

Partnerinformationen abrufen

Aktuelle Partnerinformationen erhalten Sie, wenn Sie die Communications API mit Ihrer Partner-ID.

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

Wenn Sie Ihre Partnerinformationen aktualisieren möchten, können Sie die Seite Kontoeinstellungen in der Business Communications Developer Console verwenden oder die folgenden Befehle ausführen.

Ersetzen PARTNER_ID durch Ihre Partner-ID(Partner-ID finden Sie in der Business Communications Developer Console) und ersetzen Sie 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

Informationen zu 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

Da Sie nun registrierter Partner sind und die APIs aktiviert haben, können Sie mit Business Messages entwickeln. Einen schnellen Einstieg finden Sie unter Erstellen Sie den ersten Agent.

Andernfalls erfahren Sie, wie Sie Agents erstellen um Ihre Marken in Unterhaltungen zu präsentieren und Ihren Webhook zu konfigurieren, Nachrichten empfangen von Nutzenden.