Konfiguracja webhooka

Webhook to utworzone przez partnera wywołanie zwrotne HTTPS, które określa, jak Twój agent powinny odpowiadać na wiadomości i wydarzenia. Chyba że korzystasz z gotowego automatycznego takie jak Dialogflow, Musisz skonfigurować niestandardowy webhooka, aby zdefiniować działanie agenta.

Webhooki na poziomie partnera i agenta

Webhooka możesz skonfigurować na poziomie partnera lub agenta. Webhooki na poziomie partnera mają zastosowanie do każdego obsługiwanego przez Ciebie agenta, natomiast na poziomie agenta każdy webhook jest przypisany do jednego agenta.

Jeśli zarządzasz wieloma agentami o różnych zachowaniach, możesz ustawić innego webhooka dla każdego agenta za pomocą ustawienia na poziomie agenta. Z drugiej strony czy też klient ma podobne zachowanie, może używać webhooka na poziomie partnera.

Jeśli masz skonfigurowany webhooka na poziomie partnera i webhooka na poziomie agenta, webhook na poziomie agenta ma pierwszeństwo przed konkretnym agentem, natomiast Webhook na poziomie partnera dotyczy agentów, które nie mają poziomu agenta webhooka.

Konfigurowanie webhooka na poziomie partnera

Aby skonfigurować webhooka na poziomie partnera:

  1. Otwórz konsolę programisty usług Business Communications. i zaloguj się na konto Google Business Messages.
  2. Otwórz Ustawienia konta.
  3. Sprawdź, czy wybrane jest właściwe konto partnera.
  4. W polu Adres URL webhooka funkcji Business Messages kliknij Skonfiguruj.
  5. W polu URL punktu końcowego webhooka wpisz adres URL aplikacji + „/callback/”. Przykład: „https://ID_PROJEKTU.appspot.com/callback/”.
  6. Zapisz wartość clientToken. Jest on potrzebny do potwierdzenia, że wiadomości, które otrzymujesz od Google,

  7. Skonfiguruj webhooka, aby akceptował żądanie POST z określonym clientToken i wyślij odpowiedź 200 OK ze zwykłym tekstem jako treść odpowiedzi. Na przykład załóżmy, że webhook otrzymuje żądanie POST z tą treścią:

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

    W takim przypadku webhook powinien potwierdzić wartość clientToken, a jeśli Parametr clientToken jest poprawny, zwraca odpowiedź 200 OK z wartością 0123456789 jako treść odpowiedzi.

  8. W konsoli kliknij Zweryfikuj. Gdy Business Messages zweryfikuje webhooka, okno zostanie zamknięte.

Ustaw webhooka na poziomie agenta

Wiadomości wysyłane do agenta są wysyłane do webhooka na poziomie partnera. Jeśli chcesz, aby wiadomości od konkretnego agenta trafiały do innego webhooka, może skonfigurować webhooka na poziomie agenta.

  1. Otwórz konsolę programisty usług Business Communications. i zaloguj się na konto Google Business Messages.
  2. Kliknij agenta.
  3. Kliknij Integrations (Integracje).
  4. W polu Webhook kliknij Skonfiguruj.
  5. W polu URL punktu końcowego webhooka wpisz adres URL webhooka, zaczynając od „https://”.
  6. Zapisz wartość clientToken. Będzie ona potrzebna do potwierdzenia, że wiadomości do Ciebie pochodzą od Google.

  7. Skonfiguruj webhooka, aby akceptował żądanie POST z określonym clientToken i wyślij odpowiedź 200 OK z wartością tajny parametr. Załóżmy na przykład, że Twój webhook otrzymuje żądanie POST o następującej treści:

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

    W takim przypadku webhook powinien potwierdzić wartość clientToken, a jeśli clientToken to poprawna odpowiedź, zwraca odpowiedź 200 OK z tajnym adresem URL ustawiono na 0123456789.

  8. W konsoli kliknij Zweryfikuj. Gdy Business Messages zweryfikuje webhooka, okno zostanie zamknięte.