Интеграция Roistat с LeadForms¶

LeadForms – это конструктор маркетинговых квизов для сайтов.

Интеграция передает в Roistat заявки из квиза вместе с номером визита посетителя. Заявка попадает в список отправленных заявок проекта Roistat и далее в подключенную CRM.

Как подключить LeadForms¶

Для большинства проектов используйте подключение через Webhook URL. В этом варианте вы сможете настроить отправку заявок в CRM, дополнительные поля и сценарии в Roistat.

Настройте Webhook URL.
Проверьте, нужно ли указывать Id счётчика:
- Квиз встроен на сайт. Установите на странице с квизом код счётчика Roistat. Если события прохождения квиза не нужны, больше ничего настраивать не требуется. Если нужны — выполните шаг 3.
- Квиз открывается по прямой ссылке или на отдельной странице. Выполните шаг 3: Id счётчика нужен, чтобы квиз получил номер визита. Без него заявка придёт со значением nocookie.

Подключение по ключу интеграции

Это альтернативный способ передачи заявок. Ключ интеграции можно получить в настройках подключённой CRM или в разделе «Управление заявками без CRM», если CRM не подключена. Подробная инструкция — в разделе Подключение по ключу интеграции.

Обратите внимание

Не подключайте Webhook URL и ключ интеграции одновременно: каждая заявка будет отправлена в Roistat дважды, и в проекте появятся дубли.

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

Раздел с интеграциями в кабинете LeadForms понадобится при любом способе подключения. Чтобы его открыть:

В личном кабинете LeadForms откройте раздел Квизы:
Нажмите Редактировать у нужного квиза:
Откройте Настройки → Интеграции:

Подключение через Webhook URL¶

Шаг 1. Скопируйте Webhook URL¶

В проекте Roistat в разделе Интеграции нажмите Добавить интеграцию. В открывшемся окне найдите LeadForms и нажмите кнопку Добавить:

Затем нажмите Настроить интеграцию:
Скопируйте Webhook URL:

Шаг 2. Добавьте Webhook URL в LeadForms¶

Не закрывая настройки интеграции, перейдите в личный кабинет LeadForms и откройте настройки интеграций квиза.
В карточке Webhooks нажмите Подключить:
Вставьте Webhook URL в поле URL Webhooks и нажмите Добавить:

Шаг 3. Укажите Id счётчика¶

Этот шаг нужен, если квиз расположен по прямой ссылке, то есть открывается на отдельной странице: счетчик будет установлен внутри квиза и создаст номер визита. Если квиз встроен на ваш сайт, шаг нужен только для передачи событий прохождения квиза – номер визита в этом случае берется из кода счетчика на странице.

В проекте Roistat откройте Настройки → Код счетчика.
Скопируйте Id счётчика – строку из 32 символов в коде счетчика (значение roistatProjectId):
В личном кабинете LeadForms откройте настройки интеграций квиза и в карточке Roistat нажмите Подключить:
Включите переключатель Включить Roistat и в поле Id счётчика вставьте скопированное значение. Поле Ключ интеграции оставьте пустым – иначе заявки будут отправляться двумя способами: через Webhook URL и по ключу. Нажмите Сохранить:

Шаг 4. Вернитесь в Roistat¶

Вернитесь к настройкам интеграции в проекте Roistat и нажмите Следующий шаг.

Шаг 5. Настройте поведение интеграции¶

На шаге Настройка поведения вы можете:

Настроить отправку заявок в CRM. Если опция Отправлять заявки в CRM включена, заявки будут отправляться в подключенную к проекту CRM. Если опция выключена, лиды будут создаваться в списке отправленных заявок, но в CRM не попадут;
Настроить создание заявок без контактных данных. Если включить опцию Создавать заявки без контактных данных, то заявки будут отправляться в CRM даже при отсутствии контактных данных клиента. Опция действует только при подключении через Webhook URL;
Создать сценарии отправки заявок в CRM;
Создать сценарии отправки целей в Google Аналитику и Яндекс.Метрику.

Нажмите Сохранить, чтобы применить изменения.

Шаг 6. Настройте доп. поля¶

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

Нажмите Добавить поле и в раскрывающемся списке Выберите поле выберите название дополнительного поля в CRM. Список полей загружается из подключенной к проекту Roistat CRM.
В поле справа введите значение дополнительного поля сделки в виде текста или переменной.
Нажмите Сохранить.

Подключение по ключу интеграции¶

Шаг 1. Скопируйте ключ интеграции¶

Ключ можно взять в одном из двух мест:

в настройках интеграции с вашей CRM: Интеграции → настройка интеграции → Ключ интеграции;
либо в разделе Управление заявками без CRM → Настройки, если CRM не подключена.

Шаг 2. Скопируйте Id счётчика¶

Этот шаг нужен, если квиз открывается по прямой ссылке или размещен на отдельном домене – счетчик будет установлен внутри квиза и создаст номер визита, а также если вы хотите передавать в Roistat события прохождения квиза.

В проекте Roistat откройте Настройки → Код счетчика.
Скопируйте значение roistatProjectId – строку из 32 символов в коде счетчика.

Шаг 3. Подключите интеграцию в LeadForms¶

Откройте настройки интеграций квиза.
В карточке Roistat нажмите Подключить:
Включите переключатель Включить Roistat. Вставьте ключ интеграции в поле Ключ интеграции и, при необходимости, Id счётчика в поле Id счётчика. Нажмите Сохранить:

При подключении по ключу интеграции настроек поведения и доп. полей нет. Отправка заявок в CRM настраивается в интеграции с вашей CRM: в разделе Интеграции откройте настройки CRM и перейдите к шагам Отправка заявок в CRM-систему – базовые настройки, назначение ответственных, создание задач. Пример для amoCRM:

Особенности размещения квиза¶

Квиз-виджет на вашем сайте. Номер визита берется со страницы сайта, поэтому на ней должен быть установлен код счетчика Roistat. Порядок загрузки значения не имеет: если счетчик загрузится позже квиза, номер визита все равно будет подставлен до отправки заявки. Если нужны события прохождения квиза, дополнительно укажите Id счётчика в карточке Roistat в LeadForms: счетчик на странице сайта события квиза не получает.

Квиз по прямой ссылке или на своем домене. Укажите Id счётчика в поле Id счётчика в карточке Roistat – счетчик Roistat будет установлен внутри квиза, и заявка уйдет с номером визита этого счетчика:

при подключении через Webhook URL – заполните только поле Id счётчика, поле Ключ интеграции оставьте пустым (шаг 3 способа 1);
при подключении по ключу интеграции – укажите Id счётчика в той же карточке, вместе с ключом интеграции (шаги 2 и 3 способа 2).

События прохождения квиза¶

Чтобы квиз передавал события в Roistat:

Укажите Id счётчика в карточке Roistat в LeadForms. Это нужно при любом способе подключения и любом размещении квиза – в том числе если квиз встроен на сайт с установленным счетчиком Roistat. При подключении через Webhook URL поле Ключ интеграции оставьте пустым.
Создайте события в проекте Roistat по инструкции с условием срабатывания Передается через JavaScript и id события из таблицы ниже.

Создавайте только те события, которые хотите видеть в отчетах.

Id события	Когда срабатывает
`leadforms_open`	Квиз открылся
`leadforms_start`	Посетитель нажал кнопку на стартовой странице
`leadforms_step1`, `leadforms_step2`, …	Пройден вопрос с указанным номером
`leadforms_form`	Показана форма контактов
`leadforms_result`	Показан результат
`leadforms_phone`	Клик по телефону в шапке квиза
`leadforms_messengers_telegram`	Контакт отправлен через Telegram
`leadforms_messengers_whatsapp`	Контакт отправлен через WhatsApp
`leadforms_finish`	Заявка отправлена

Если в настройках счетчиков квиза включена опция Уникальные цели, к каждому id добавляется символ _ и номер квиза – например, leadforms_finish_1024.

Что передается в Roistat¶

В заявке передаются имя, телефон, email, название квиза в заголовке, ответы на вопросы и результат в комментарии, UTM-метки и адрес страницы в дополнительных полях.

Номер визита берется из cookie roistat_visit. Если посетитель пришел на страницу без счетчика Roistat, заявка создается со значением nocookie.

Если заявки не доходят¶

Проверьте, что в кабинете LeadForms включена интеграция: добавленный адрес в карточке Webhooks или переключатель Включить Roistat в карточке Roistat.
Проверьте, что Webhook URL или ключ интеграции скопирован без лишних пробелов.
При подключении по ключу интеграции заявка не создается, если в ней нет ни телефона, ни email: для создания заявки требуется хотя бы один контакт.
Ошибка отправки отображается в личном кабинете LeadForms как проблема доставки по каналу Roistat – с текстом ответа Roistat.
Заявки отправляются только при положительном балансе заявок в LeadForms.
Заявка пришла со значением nocookie – счетчик Roistat не получил номер визита. Для квиза по прямой ссылке укажите Id счётчика в карточке Roistat в LeadForms, для виджета проверьте, что код счетчика установлен на странице сайта.
События не приходят – проверьте, что в карточке Roistat в LeadForms указан Id счётчика и что события созданы в Roistat с условием Передается через JavaScript.

Если заявки дублируются¶

Проверьте, что в кабинете LeadForms подключен только один способ: либо карточка Webhooks, либо карточка Roistat с ключом интеграции. Если подключены обе, каждая заявка отправляется в Roistat дважды.

При подключении через Webhook URL карточку Roistat можно оставить включенной только с Id счётчика – поле Ключ интеграции в ней должно быть пустым.