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

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

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

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

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

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

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

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

  1. Откройте консоль разработчика Business Communications и войдите в свою учетную запись Google Business Messages.
  2. Откройте настройки учетной записи .
  3. Убедитесь, что выбран правильный партнерский аккаунт.
  4. Для URL-адреса веб-перехватчика Business Messages щелкните Настроить .
  5. В качестве URL- адреса конечной точки веб-перехватчика введите 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 проверит ваш веб-перехватчик, диалоговое окно закроется.