1. Главная
  2. База знаний
  3. Чат-боты
  4. Общее

Как настроить отправку вебхука в чат-ботах

Вебхук — механизм оповещения о событиях посредством отправки HTTP запроса на URL, где находится обработчик.

С помощью этой интеграции вы сможете настроить отправку данных о событии в цепочке бота в свою систему для дальнейшей работы с этим клиентом.

Представьте сценарий: вы создали последовательный опрос для пользователя, чтобы он мог зарегистрироваться на мероприятие в мессенджере. Вам нужно узнать о новом зарегистрированном на определенную лекцию, чтобы связаться с ним или изменить статус в вашей CRM.

Именно с помощью добавленного вебхука вы можете это сделать. Как только пользователь проходит отслеживаемый блок настроенной цепочки, в вашу систему отправляются данные о свершившемся событии.

Как включить отправку вебхука

Добавьте блок «Действие» после отслеживающевого блока. Выберите опцию «Отправить вебхук». Введите название отправляемого вебхука и ссылку куда передавать данные.

Отслеживать можно такие события:

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

Структура вебхука

Вебхук передает такие данные:

  • дата срабатывания вебхука;
  • название вебхука — по "title" вы можете на своей стороне фильтровать пришедшие вебхуки;
  • информация о боте и к какой странице соцсети он подключен — идентификатор, фото и ссылка на страницу сообщества в соцсети;
  • информация о контакте для которого произошло событие — идентификатор, имя, день рождения, город, страна, фото профиля, установленные переменные и теги.

Пример тела отправляемого POST запроса в JSON:

[
{
    "date": 1589542610, // дата срабатывания блока в милисекундах
    "contact": {
        "variables": {
            "имя переменной": "значение переменной", 
            "email": "name@example.com",
            "phone": "+38093000000",
            "photo": "https://.."
        },
        "tags":  ["название тега 1", "название тега 2"],
        "id": "0278981b-92f4-4bbb-8353-627b000d463", // идентификатор контакта в Sendpulse
        "name": "Alexander"
    },
    "bot": {
        "url": "https://m.me/652333600223330",
        "external_id": "6523336910330", // идентификатор сообщества в мессенджере
        "id": "064faef8f5251e35a68", // идентификатор подключенного бота в Sendpulse
        "name": "Svitapp" // название бота
    },
    "service": "facebook",
    "title": "Зарегистрировались. Зеленый зал", //название вебхука
}
]
Изменения формата данных вебхука
Обратите внимание! C 11 августа 2020г изменился формат данных вебхука. Теперь это массив объектов[{...}, {...}]. Ранее был один объект данных {...}. Обновите ваши интеграции, если в них используеться старый формат.

Данные вебхука приходят с типом application/json.

Обновлено: 2020-11-27

Оцените, насколько полезна статья "Как настроить отправку вебхука в чат-ботах"

Оценка: 4 / 5 (6)

    Другие полезные страницы

    Популярное в нашем блоге

    Попробуйте бесплатный бот для рассылок в Facebook Messenger