Ta strona została przetłumaczona przez Cloud Translation API.

Zarejestruj się w Business Messages

Po zarejestrowaniu się jako partner w programie Business Messages możesz prowadzić rozmowy między użytkownikami i markami przez tworzenie agentów (podmiotów konwersacyjnych reprezentujących funkcje biznesowe, takich jak pomoc dotycząca witryn czy lokalizacje marek).

Gdy użytkownik znajdzie markę, którą zarządzasz w wyszukiwarce Google lub w Mapach Google, w wynikach wyszukiwania pojawi się opcja Czat. Po kliknięciu Czat użytkownik może wysyłać wiadomości do agenta marki. Agent umożliwia odbieranie i wysyłanie wiadomości od użytkowników.

Zarejestruj się jako partner

Rejestrując się jako partner w programie Business Messages, tworząc agenty dla marek i korzystając z interfejsów API używanych przez agenta, możesz umożliwić klientom korzystanie z obsługi wiadomości, obsługi sprzedaży i innych aplikacji biznesowych.

Otwórz Konsolę programisty ds. komunikacji biznesowej.
W sekcji Wiadomości od firm kliknij Utwórz konto partnera.

Wpisz wartości informacji o partnerze:

Pole	Wartość
Imię i nazwisko	Twoje imię i nazwisko
Nazwa partnera	Nazwa organizacji
Strona partnera	Strona internetowa organizacji
Region	Region, w którym chcesz hostować usługę Business Messages

Przeczytaj i zaakceptuj Warunki korzystania z usługi Business Messages.
Kliknij Utwórz.

Twoje konto jest teraz zarejestrowane jako partner Business Messages i masz dostęp do interfejsów Business Messages i Business Communications API. Business Messages API wysyła wiadomości do użytkowników, natomiast interfejs Business Communications API zarządza agentami.

Tworzenie konta usługi

Do bezpiecznego uwierzytelniania wywołań interfejsu API związanych z Business Messages i Business Communications API potrzebujesz klucza konta usługi i narzędzia wiersza poleceń oauth2l.

Na stronie głównej Business Communications Developer Console kliknij Ustawienia konta partnera.
W menu nawigacyjnym po lewej stronie kliknij Konto usługi.
Kliknij kolejno Utwórz klucz i Utwórz.

Przeglądarka pobierze klucz konta usługi. Przechowuj klucz konta usługi w bezpiecznym, prywatnym miejscu. Nie udostępniaj swojego klucza publicznie. Ten klucz będzie potrzebny później w celu uzyskania dostępu do interfejsów Business Messages i Business Communication API.

Skonfiguruj e-booka

Po włączeniu Business Messages i Business Communications API musisz określić adres URL webhooka, aby odbierać wiadomości.

Otwórz Ustawienia konta w konsoli programisty usług komunikacji biznesowej.
Upewnij się, że wybrane jest właściwe konto partnera.
W sekcji URL webhooka w Business Messages kliknij Skonfiguruj.
W polu URL punktu końcowego webhooka wpisz adres URL webhooka zaczynający się od „https://”.
Zapisz wartość clientToken. Jest on potrzebny, aby sprawdzać, czy otrzymane wiadomości pochodzą od Google.
Skonfiguruj webhooka, aby akceptował żądanie POST z określonym parametrem clientToken i wysyłał odpowiedź 200 OK ze zwykłym tekstem w parametrze secret jako treść odpowiedzi.

Jeśli na przykład Twój webhook otrzyma żądanie POST z następującą treścią treści:
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
webhook powinien potwierdzić wartość clientToken i jeśli clientToken jest prawidłowa, ustaw odpowiedź 200 OK z treścią 0123456789.
W konsoli kliknij Zweryfikuj.

Gdy narzędzie Business Messages zweryfikuje Twojego webhooka, okno dialogowe zostanie zamknięte.

Zobacz Przykład: aktualizowanie adresu URL webhooka, aby dowiedzieć się, jak skonfigurować webhooka za pomocą interfejsów Business Communication API.

Uzyskaj informacje o partnerze

Aby uzyskać informacje o obecnych partnerach, możesz wysłać zapytanie o identyfikator w interfejsie Business Communications API.

Uruchom podane niżej polecenie. Zastąp PARTNER_ID swoim identyfikatorem partnera.


# 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

Zaktualizuj informacje o partnerze

Informacje o partnerze możesz zaktualizować na stronie Ustawienia konta w konsoli programisty usług biznesowych lub wykonać poniższe polecenia.

Zastąp PARTNER_ID swoim identyfikatorem partnera(identyfikator partnera można znaleźć w konsoli programisty usług komunikacji biznesowej), a UPDATED_FIELDS zastąp nazwami pól, które zaktualizujesz.


# 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

Opcje formatowania i wartości znajdziesz w sekcji partners.patch.

Przykład: aktualizacja wyświetlanej nazwy

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',
}"

Przykład: aktualizacja adresu URL webhooka

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',
      },
    },
  ],
}"

Dalsze kroki

Po zarejestrowaniu się jako partner i włączeniu interfejsów API możesz zacząć programować za pomocą Business Messages. Aby szybko rozpocząć korzystanie z tej funkcji, zobacz Tworzenie pierwszego agenta.

W przeciwnym razie dowiedz się, jak tworzyć agenty reprezentujące marki w rozmowach i skonfigurować webhooka tak, aby odbierał wiadomości od użytkowników.