Веб-перехватчик — это созданный партнером обратный вызов HTTPS, который указывает, как ваш агент должен реагировать на сообщения и события. Если вы не используете предварительно созданное автоматизированное решение, такое как Dialogflow , вам необходимо установить собственный веб-перехватчик, чтобы определить поведение вашего агента.
Веб-перехватчики на уровне партнера и на уровне агента
Вы можете установить свой веб-перехватчик либо на уровне партнера, либо на уровне агента. Веб-перехватчики на уровне партнера применяются к каждому поддерживаемому вами агенту, а веб-перехватчики на уровне агента применяются к одному отдельному агенту.
Если вы работаете с несколькими агентами с различным поведением, вы можете установить разные веб-перехватчики для каждого агента, используя настройку на уровне агента. С другой стороны, если ваши агенты ведут себя одинаково или у вас есть только один агент, вы можете использовать веб-перехватчик на уровне партнера.
Если у вас настроены и веб-перехватчик на уровне партнера, и веб-перехватчик на уровне агента, веб-перехватчик на уровне агента имеет приоритет для конкретного агента, а веб-перехватчик на уровне партнера применяется к агентам, у которых нет веб-перехватчика на уровне агента.
Установите вебхук на уровне партнера
Чтобы настроить веб-перехватчик на уровне партнера, выполните следующие действия:
- Откройте консоль разработчика Business Communications и войдите в свою учетную запись Google Business Messages.
- Откройте настройки учетной записи .
- Убедитесь, что выбран правильный партнерский аккаунт.
- Для URL-адреса веб-перехватчика Business Messages щелкните Настроить .
- В качестве URL- адреса конечной точки веб-перехватчика введите URL -адрес вашего приложения + "/callback/". Например, это может быть что-то вроде «https://PROJECT_ID.appspot.com/callback/».
- Обратите внимание на значение
clientToken
. Он нужен вам, чтобы убедиться, что получаемые вами сообщения исходят от Google . Настройте свой веб-перехватчик для приема запроса POST с указанным параметром
clientToken
и отправки ответа200 OK
с обычным текстовым значением секретного параметра в качестве тела ответа. Например, предположим, что ваш веб-перехватчик получает запрос POST со следующим содержимым тела:{ "clientToken":"SJENCPGJESMGUFPY", "secret":"0123456789" }
В этом случае ваш веб-перехватчик должен подтвердить значение
clientToken
и, еслиclientToken
правильный, вернуть ответ200 OK
с0123456789
в качестве тела ответа.В консоли нажмите Подтвердить . Когда Business Messages проверит ваш веб-перехватчик, диалоговое окно закроется.
Установите веб-перехватчик на уровне агента
Вы получаете сообщения, отправленные вашему агенту через веб-перехватчик на уровне партнера. Если вы хотите, чтобы сообщения для определенного агента поступали на другой веб-перехватчик, вы можете установить веб-перехватчик на уровне агента.
- Откройте консоль разработчика Business Communications и войдите в свою учетную запись Google Business Messages.
- Нажмите на своего агента.
- Щелкните Интеграции .
- Для Webhook нажмите « Настроить ».
- В поле URL- адрес конечной точки веб -перехватчика введите URL-адрес веб-перехватчика, начинающийся с «https://».
- Обратите внимание на значение
clientToken
. Он нужен вам, чтобы убедиться, что получаемые вами сообщения исходят от Google . Настройте веб-перехватчик так, чтобы он принимал запрос POST с указанным параметром
clientToken
и отправлял ответ 200 OK со значением секретного параметра. Например, предположим, что ваш веб-перехватчик получает запрос POST со следующим содержимым тела:{ "clientToken":"SJENCPGJESMGUFPY", "secret":"0123456789" }
В этом случае ваш веб-перехватчик должен подтвердить значение
clientToken
и, еслиclientToken
правильный, вернуть ответ200 OK
с параметром секретного URL, установленным на0123456789
.В консоли нажмите Подтвердить . Когда Business Messages проверит ваш веб-перехватчик, диалоговое окно закроется.