Интеграция Roistat с конструктором лид-форм Kmeta¶

Интеграция позволяет передавать заявки из Конструктора Лид-Форм Kmeta в Roistat и, если в проекте подключена CRM и настроена отправка заявок, далее в CRM. Для передачи данных используется Универсальный вебхук: он принимает данные формы и позволяет сопоставить поля Kmeta с полями заявки в Roistat.

Настройка интеграции¶

Создайте вебхук в Roistat¶

В проекте Roistat откройте раздел Интеграции → Универсальные вебхуки.
Нажмите Добавить универсальный вебхук, укажите название и нажмите Сгенерировать URL.
Скопируйте URL вебхука.

Подробнее о создании и настройке Универсального вебхука читайте в инструкции.

Укажите URL в Kmeta и получите образец данных¶

В Конструкторе Лид-Форм откройте нужную форму и перейдите в раздел Интеграции.
В настройках Webhook нажмите Настроить.
Вставьте скопированный URL Roistat в поле Вебхук для вызова rest api и сохраните настройку.
Вернитесь в Roistat и нажмите Сохранить и продолжить.
В Kmeta откройте предпросмотр формы, заполните и отправьте тестовую заявку.
В Roistat нажмите Проверить данные из истории вебхука. После получения образца Roistat покажет структуру данных, которую можно использовать для сопоставления полей.

Сопоставьте поля и настройте поведение¶

На шаге сопоставления полей укажите, какие данные из формы передавать в поля заявки Roistat. Например:

Поле заявки Roistat	Поле Kmeta
Название заявки	`form.name`
Имя клиента	`lead.first_name`
Телефон	`lead.phone`
Email	`lead.email`
Комментарий	`lead.comment`

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

Когда сопоставление и настройки готовы, вернитесь в список Универсальные вебхуки и включите вебхук. Новые заявки из формы будут обрабатываться Roistat. Проверьте результат в разделе Диагностика проекта → Список отправленных заявок.

Какие данные передает Kmeta¶

Kmeta отправляет данные методом POST в формате JSON. В каждом запросе есть поля event_type, lead и form. Поле missed_lead_qualification передается для упущенной заявки (event_type = lead_missed).

В объекте lead могут быть пустые строки. Поля vk_*, max_*, tg_* и ok_* заполняются, если форма отправлена через соответствующий канал; в остальных случаях они пустые. Поля utm_* заполняются, если в ссылке на форму переданы соответствующие UTM-метки. Для настройки сопоставления используйте образец данных, полученный из своей формы.

Поля верхнего уровня¶

Поле	Тип	Описание
`event_type`	строка	Тип события: `lead_completed` — форма заполнена и отправлена; `lead_missed` — форма не отправлена.
`missed_lead_qualification`	строка, необязательное	Квалификация упущенной заявки: `hot`, `warm` или `cold`. Передается только для `lead_missed`.
`lead`	объект	Данные клиента и формы. Список полей приведен ниже.
`form`	объект	Данные лид-формы: `id` — идентификатор, `name` — название.

Поля объекта `lead`¶

Поля	Описание
`first_name`, `last_name`, `middle_name`	Имя, фамилия и отчество клиента. Поле `name` устарело, используйте `first_name`.
`phone`, `email`	Номер телефона и адрес электронной почты.
`birthday`, `city`	Дата рождения в формате `YYYY-MM-DD` и город, указанные клиентом.
`comment`	Комментарий с общей информацией и заполненными данными формы.
`question_1`–`question_5`	Ответы на вопросы формы с соответствующими номерами.
`social_link`	Ссылка на профиль или чат, откуда пришла заявка, если форма размещена в VK, MAX, Telegram или Одноклассниках.
`sex_by_first_name`	Пол, определенный по имени профиля; возможные значения: `Женский`, `Мужской`, `Не определён`.
`ok_user_id`, `ok_link_profile`, `ok_link_write_profile`	ID пользователя в Одноклассниках, ссылка на его профиль и ссылка для отправки сообщения.
`max_user_id`, `max_username`, `max_link_profile`	ID пользователя в MAX, его имя пользователя и ссылка на профиль.
`tg_user_id`, `tg_username`, `tg_link_profile`	ID пользователя в Telegram, его имя пользователя и ссылка на профиль.
`vk_user_id`, `vk_link_profile`, `vk_link_write_profile`	ID пользователя ВКонтакте, ссылка на профиль и ссылка для отправки сообщения.
`vk_link_write_profile_from_group`	Ссылка для отправки сообщения пользователю от имени сообщества ВКонтакте, из которого открыта форма.
`vk_sex`	Пол, указанный в профиле ВКонтакте: `Женский`, `Мужской` или `Не указано`.
`vk_viewer_group_role`	Роль пользователя в сообществе ВКонтакте: например, `admin`, `editor`, `moder`, `member` или `none`.
`vk_platform`	Платформа ВКонтакте, с которой отправлена форма: например, веб-версия, мобильная веб-версия, Android, iPadOS или iOS.
`vk_ref`	Источник перехода ВКонтакте: например, меню сообщества, виджет, лента, чаты или прямая ссылка. Возможны и другие значения.
`vk_community_id`	ID сообщества ВКонтакте из ссылки на форму.
`ip`	IP-адрес клиента. Поле `ip_address` устарело, используйте `ip`.
`country_by_ip`, `region_by_ip`, `city_by_ip`	Страна, регион и город, определенные по IP-адресу. Поле `city_by_ip_address` устарело, используйте `city_by_ip`.
`utm_source`, `utm_medium`, `utm_campaign`, `utm_content`	UTM-метки: источник трафика, канал, кампания и контент/объявление.
`os`, `browser`	Операционная система и браузер устройства. Значения зависят от устройства и браузера.
`device_platform`, `device_vendor`	Тип устройства (мобильные устройства, компьютеры или другое) и производитель.
`locale`, `timezone`	Язык в формате BCP 47 и часовой пояс в формате IANA.

Полный формат запроса, примеры значений, возможные значения отдельных полей и актуальные изменения Kmeta описаны в документации Webhook Kmeta.

Если заявки не поступают¶

Проверьте, что в настройках формы Kmeta указан URL именно нужного вебхука Roistat.
Убедитесь, что в Roistat вебхук активирован и настроено сопоставление полей.
Отправьте тестовую заявку через предпросмотр формы и заново получите образец данных из истории вебхука.
Проверьте запрос и его обработку в истории вебхуков.
Если заявка создана в Roistat, но не отправлена в CRM, проверьте настройку Отправлять заявки в CRM и условия сценариев отправки.