Входящий Вебхук

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

Для создания вебхука необходимо выполнить следующие действия:

  1. Создать сценарий в разделе "Сценарии", который будет вызываться с помощью вебхука

  2. Указать произвольное имя

  3. Выбрать сценарий, созданный на шаге №1

  4. Настроить сопоставление переменных, передаваемых в теле запроса, с переменными бота, которые будут записываться при вызове вебхука. Все переменные в теле запроса вебхука должны быть переданы внутри переменной variables. Если у бота ещё нет переменной с заданным именем, она будет создана.

  5. После создания вебхука, будет сгенерирован уникальный URL для запуска выбранного ранее сценария.

  6. Для вызова вебхука можно использовать как POST так и GET запрос, переменные будут считаны вне зависимости от того, как они были переданы: в адресе или в теле запроса.

При вызове URL вебхука необходимо выполнить следующие условия:

  1. Заголовок запроса (HTTP Headers) Accept должен иметь значение "application/json"

  2. В переменных запроса должна присутствовать переменная признака поиска контакта contact_by с любым значением из списка ниже и переменная search со значением по которому необходимо найти контакт:

id - поиск контакта по его идентификатору в системе Leadteh,

phone - поиск по номеру телефона,

email - поиск по E-mail,

telegram_name - поиск по имени Telegram аккаунта,

telegram_id - поиск по числовому Telegram идентификатору,

whatsapp - поиск по номеру Whatsapp,

vk - поиск по Vk идентификатору,

viber - поиск по Viber идентификатору,

amocrm_id - поиск по идентификатору в системе AmoCRM,

bitrix24_id - поиск по идентификатору в системе Битрикс24

Пример GET запроса с поиском по номеру телефона:

https://rb14.leadteh.ru/inner_webhook/948c9d06-454d-4952-bc78-2a94bc4ce25f?contact_by=phone&search=79001234567

Пример GET запроса с поиском по id контакта:

https://rb14.leadteh.ru/inner_webhook/948c9d06-454d-4952-bc78-2a94bc4ce25f?contact_by=phone&search=123456

Пример тела POST запроса с передаваемыми переменными и поиском по id контакта:

{
    "contact_by": "id",
    "search": 123456789,
    "variables": {
        "first_var": "Значение первой переменной",
        "second_var": "Значение второй переменной"
    }
}

Каждый вызов с переданными параметрами можно посмотреть на вкладке "История вызовов".

Срок хранения истории вызовов составляет 10 дней.

Last updated