Установите свой вебхук

Вебхук — это созданный партнером обратный вызов HTTPS, который определяет, как ваш агент должен реагировать на сообщения и события. Если вы не используете готовое автоматизированное решение, такое как Dialogflow , вам необходимо установить собственный веб-перехватчик, чтобы определить поведение вашего агента.

Веб-перехватчики на уровне партнера и агента

Вы можете настроить вебхук либо на уровне партнера, либо на уровне агента. Веб-перехватчики на уровне партнера применяются к каждому поддерживаемому вами агенту, а веб-перехватчики на уровне агента применяются к одному отдельному агенту.

Если вы управляете несколькими агентами с различным поведением, возможно, вам потребуется установить отдельный веб-перехватчик для каждого агента, используя настройку уровня агента. С другой стороны, если ваши агенты ведут себя одинаково или у вас только один агент, вы можете использовать веб-перехватчик на уровне партнера.

Если у вас настроены как веб-перехватчик на уровне партнера, так и веб-перехватчик на уровне агента, веб-перехватчик на уровне агента имеет приоритет для конкретного агента, а веб-перехватчик на уровне партнера применяется к агентам, у которых нет веб-перехватчика на уровне агента.

Установите вебхук на уровне партнера

Чтобы настроить вебхук на уровне партнера, выполните следующие действия:

  1. Откройте консоль разработчика Business Communications и войдите в свою учетную запись Google Business Messages.
  2. Откройте настройки учетной записи .
  3. Убедитесь, что выбран правильный партнерский аккаунт.
  4. Для URL-адреса веб-перехватчика Business Messages нажмите « Настроить» .
  5. В качестве URL-адреса конечной точки Webhook введите URL-адрес вашего приложения + "/callback/". Например, это может быть что-то вроде «https://PROJECT_ID.appspot.com/callback/».
  6. Обратите внимание на значение clientToken . Он нужен вам, чтобы убедиться, что получаемые вами сообщения исходят от Google .

  7. Настройте веб-перехватчик для приема запроса POST с указанным параметром clientToken и отправки ответа 200 OK с текстовым значением секретного параметра в качестве тела ответа. Например, предположим, что ваш вебхук получает запрос POST со следующим содержимым тела:

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

    В этом случае ваш веб-перехватчик должен подтвердить значение clientToken и, если clientToken верен, вернуть ответ 200 OK с 0123456789 в качестве тела ответа.

  8. В консоли нажмите «Проверить» . Когда Business Messages проверит ваш веб-перехватчик, диалоговое окно закроется.

Установите вебхук на уровне агента

Вы получаете сообщения, отправленные вашему агенту, через веб-перехватчик на уровне партнера. Если вы хотите, чтобы сообщения для определенного агента поступали на другой веб-перехватчик, вы можете установить веб-перехватчик на уровне агента.

  1. Откройте консоль разработчика Business Communications и войдите в свою учетную запись Google Business Messages.
  2. Нажмите на своего агента.
  3. Нажмите «Интеграции» .
  4. Для Webhook нажмите «Настроить» .
  5. В поле URL-адрес конечной точки веб-перехватчика введите URL-адрес веб-перехватчика, начиная с https://.
  6. Обратите внимание на значение clientToken . Он нужен вам, чтобы убедиться, что получаемые вами сообщения исходят от Google .

  7. Настройте свой веб-перехватчик так, чтобы он принимал запрос POST с указанным параметром clientToken и отправлял ответ 200 OK со значением секретного параметра. Например, предположим, что ваш вебхук получает запрос POST со следующим содержимым тела:

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

    В этом случае ваш веб-перехватчик должен подтвердить значение clientToken и, если clientToken верен, вернуть ответ 200 OK с параметром секретного URL, установленным на 0123456789 .

  8. В консоли нажмите «Проверить» . Когда Business Messages проверит ваш веб-перехватчик, диалоговое окно закроется.