Вебхук — механизм оповещения о событиях посредством отправки 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
Регистрация через соцсети
Войти через Facebook Войти через Google