Как настроить отправку уведомлений о лидах с помощью вебхуков
Вебхуки (webhooks) — это HTTP-способ быстрого и эффективного уведомления сервера об изменениях в базе данных источника. Он используется, чтобы запустить дальнейшую цепочку обработки полученной информации.
В SendPulse вы можете настроить доставку вебхуков после того, как пользователь оставил свои контактные данные в форме попапа.
Заявку от пользователя на получение предложенной в попапе услуги и запись в базе данных о таком контакте также называют лидом (marketing qualified lead). Данные лида вносятся в CRM SendPulse, в раздел Контакты, и в соответствующую адресную книгу в Рассылках, если выбрана опция Сохранить в адресную книгу при настройке попапа.
Также данные можно передать в вашу CRM-систему или Google таблицу, получить в виде email или сообщения в мессенджер — для этого вам понадобится отправка вебхуков и внешний сервис для их обработки.
В статье рассмотрим, как настроить отправку вебхуков, а также какую информацию о лидах можно передавать таким способом.
Добавление URL адреса для получения вебхуков
Чтобы получать вебхуки, вам понадобится только URL адрес внешнего сервиса, на который будут приходить уведомления. Скопируйте его.
Выберите проект, в котором собираются нужные вам данные. Перейдите в Настройки и выберите раздел Интеграции. Нажмите кнопку + Добавить URL вебхука. Вставьте URL адрес вашего сервиса в открывшееся поле.
Также доступны две опции расширенных настроек:
| Отправлять данные о создании лида (Send lead creation data) | Будут передаваться данные с формы попапа и о создании лида. Если выбрана только эта опция, будут пересылаться только данные о создании новых лидов. |
| Обновлять данные о действиях лида (Update lead activity data) | Переданные ранее данные о действиях лида будут обновлены. Если выбрана только эта опция, будут пересылаться только данные с обновлениями информации о существующих лидах. |
Выберите нужные опции и нажмите Сохранить. Таким способом вы можете подключить до двух сервисов обработки вебхуков. Позже их можно будет заменить или отредактировать подключенные опции.
Формат отправляемых данных
Когда пользователь оставит свои контакты в попапе, данные о нем будут внесены в CRM-систему и SendPulse отправит на указанный адрес POST-запрос строкой в JSON-формате.
Пример отправляемого уведомления:
email=user%40test.pop.up&name=User+Userovich&gender=0&variables%5B0%5D%5Bid%5D=252999&variables%5B0%5D%5Bname%5D=email&variables%5B0%5D%5Btype%5D=email&variables%5B0%5D%5Btext%5D=user%40test.pop.up&variables%5B1%5D%5Bid%5D=253005&variables%5B1%5D%5Bname%5D=name&variables%5B1%5D%5Btype%5D=string&variables%5B1%5D%5Btext%5D=User+Userovich&variables%5B2%5D%5Bid%5D=253403&variables%5B2%5D%5Bname%5D=company&variables%5B2%5D%5Btype%5D=string&variables%5B2%5D%5Btext%5D=Best+Company+Ever&createdAt=2022-12-15+14%3A57%3A24&actionType=create
Какие данные можно передавать с помощью вебхука
В вебхуке отправляются основные данные созданного лида:
email |
Email адрес, оставленный пользователем (если оставлен) |
phone |
Номер телефона в международном формате, оставленный пользователем (если оставлен) |
name |
Имя лида. Если не указано пользователем, совпадает с номером телефона или именем email адреса |
createdAt |
Дата и время события, которое вызвало отправку вебхука |
actionType |
Тип события, которое вызвало отправку вебхука. Например, create — создание лида |
Также в объекте variables передаются данные о каждой переменной, собранной из заполненных полей формы попапа: ID в базе данных, имя, содержимое и тип. Наличие переменных опционально, их количество и имена переменных зависят от количества полей и их типов в созданной форме в конструкторе.
Переменные, которые могут быть переданы в объекте:
| Имя переменной | Описание | Тип переменной |
email |
Email адрес, оставленный пользователем | |
phone |
Номер телефона в международном формате | phone |
name |
Имя пользователя | string |
nickname |
Никнейм, имя пользователя в сервисе | string |
location |
Указанное местоположение | string |
company |
Название компании | string |
birthday |
Дата рождения | string |
Запланированные обновления
SendPulse постоянно развивает свои сервисы и добавляет новые возможности интеграции. Поэтому скоро сервис будет обновлен и также будет доступна опция отправки вебхуков при обновлении сессии лида. Вы можете настроить обработку этих параметров вашей CRM заранее.
Данные, которые будут передаваться дополнительно:
referrer |
Адрес URL, с которого пользователь перешел на ваш сайт |
userAgent |
Строка, идентифицирующая клиентское приложение (браузер) пользователя |
term |
Обозначение типа ресурса перехода |
content |
Текст, заданный в соответствующем теге страницы |
utmMedium |
Название канала перехода |
pages |
Набор данных последней посещенной страницы |
events |
Последнее событие |
isActive |
Возвращает значение, активен ли пользователь сейчас на сайте |
Обновлено: 11.10.2024
или