Konfigurowanie webhooka

Webhook to wywołanie zwrotne HTTPS utworzone przez partnera, które określa, jak agent powinien odpowiadać na wiadomości i zdarzenia. Jeśli nie używasz gotowego automatycznego rozwiązania takiego jak Dialogflow, musisz ustawić niestandardowy webhook, aby zdefiniować działanie agenta.

Webhooki na poziomie partnera i agenta

Webhooka możesz ustawić na poziomie partnera lub agenta. Webhooki na poziomie partnera mają zastosowanie do wszystkich obsługiwanych agentów, natomiast webhooki na poziomie agenta dotyczą każdego pojedynczego agenta.

Jeśli obsługujesz wiele agentów o różnych zachowaniach, możesz ustawić inny webhook dla każdego z nich za pomocą ustawienia na poziomie agenta. Jeśli natomiast działasz podobnie lub masz tylko jednego agenta, możesz użyć webhooka na poziomie partnera.

Jeśli masz zarówno webhooka na poziomie partnera, jak i webhooka na poziomie agenta, webhook na poziomie agenta ma pierwszeństwo do określonego agenta, a webhook na poziomie partnera ma zastosowanie do agentów, które nie mają webhooka na poziomie agenta.

Konfigurowanie webhooka na poziomie partnera

Aby skonfigurować webhooka na poziomie partnera, wykonaj te czynności:

  1. Otwórz Konsolę programisty ds. komunikacji biznesowej i zaloguj się na konto Google Business Messages.
  2. Otwórz Ustawienia konta.
  3. Upewnij się, że wybrane jest właściwe konto partnera.
  4. W sekcji URL webhooka w Business Messages kliknij Skonfiguruj.
  5. W polu URL punktu końcowego webhooka wpisz adres URL aplikacji + „/callback/”. Może to być na przykład „https://PROJECT_ID.appspot.com/callback/”.
  6. Zapisz wartość clientToken. Jest on potrzebny, aby sprawdzić, czy otrzymane wiadomości pochodzą od Google.

  7. Skonfiguruj webhooka, aby akceptował żądanie POST z określonym parametrem clientToken i wysyłał odpowiedź 200 OK ze zwykłym tekstem jako wartością parametru tajnego. Załóżmy na przykład, że webhook webhooka otrzymuje żądanie POST z następującą treścią:

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

    W takim przypadku webhook powinien potwierdzić wartość clientToken i, jeśli clientToken jest prawidłowa, zwrócić odpowiedź 200 OK z treścią 0123456789.

  8. W konsoli kliknij Zweryfikuj. Gdy narzędzie Business Messages zweryfikuje webhooka, okno się zamknie.

Ustaw webhooka na poziomie agenta

Będziesz otrzymywać wiadomości do agenta w webhooku na poziomie partnera. Jeśli chcesz, aby wiadomości od konkretnego agenta były kierowane do innego webhooka, możesz skonfigurować webhooka na poziomie agenta.

  1. Otwórz Konsolę programisty ds. komunikacji biznesowej i zaloguj się na konto Google Business Messages.
  2. Kliknij agenta.
  3. Kliknij Integrations (Integracje).
  4. Obok pozycji Webhook kliknij Skonfiguruj.
  5. W polu URL punktu końcowego webhooka wpisz adres URL webhooka zaczynający się od „https://”.
  6. Zapisz wartość clientToken. Jest on potrzebny, aby sprawdzać, czy otrzymane wiadomości pochodzą od Google.

  7. Skonfiguruj webhooka, aby akceptował żądanie POST z określonym parametrem clientToken i wysyła odpowiedź 200 OK z wartością parametru tajnego. Załóżmy na przykład, że webhook otrzymuje żądanie POST o następującej treści:

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

    W takim przypadku webhook powinien potwierdzić wartość clientToken i, jeśli clientToken jest prawidłowa, zwrócić odpowiedź 200 OK z tajnym parametrem adresu URL ustawionym na 0123456789.

  8. W konsoli kliknij Zweryfikuj. Gdy narzędzie Business Messages zweryfikuje webhooka, okno się zamknie.