Передача заявок в CRM через Roistat (проксилид)¶
Передача заявок с сайта в CRM может происходить двумя способами:
-
Данные передаются с сайта в CRM, а затем оттуда загружаются в Roistat.
Данный способ подходит, если у вас уже настроена отправка данных с сайта напрямую в CRM, и вы не хотите это менять. Подробнее читайте в статье Загрузка заявок в Roistat.
-
Данные передаются с сайта в Roistat, а затем отправляются в CRM. Преимущества способа:
-
Обеспечивает резервное хранение информации о заявках в Roistat. Нет повода беспокоиться, доступна ли в данный момент CRM или нет. Данные сохраняются в проекте Roistat и, если CRM недоступна, через некоторое время отправляются в CRM повторно.
-
Позволяет гибко и быстро менять настройки передачи заявок в CRM.
-
В данной статье описана настройка второго варианта, когда заявки сначала отправляются в Roistat, а затем в CRM.
Настройка¶
Предполагается, что у вас уже настроена интеграция вашей CRM с Roistat (читайте инструкцию для вашей CRM).
Вы можете настроить передачу заявок в CRM через Roistat двумя способами:
-
В интерфейсе Roistat. Этот способ более простой.
-
С помощью php-кода. Этот способ более гибкий в настройке.
В интерфейсе Roistat¶
Обратите внимание
-
Этот способ недоступен, если код формы размещен между тегами
<iframe></iframe>
. -
Вы можете добавлять неограниченное число форм.
-
В проекте Roistat откройте раздел Настройки и выберите закладку Заявки с форм сайта. Нажмите кнопку Добавить форму:
-
В поле Название сделки введите текст, который будет отображаться в названии заявки: например, Заявка из формы обратной связи.
-
В правом верхнем углу выберите тип отправки данных по заявке:
- Форма. Выберите этот способ, если формы заявок в исходном коде вашего сайта обозначены тегом
<form>
, поля для ввода данных в них обозначены тегом<input>
, а данные отправляются с перенаправлением или обновлением страницы по нажатию на кнопку с типом type="submit" . - Кнопка. Выберите этот способ, если данные из формы заявки отправляются без перезагрузки страницы с помощью AJAX по нажатию на кнопку любого типа.
Как посмотреть код элемента в браузере
Посмотреть код элемента в браузере можно двумя способами:
-
Левой кнопкой мыши выделите содержимое формы. Затем кликните правой кнопкой мыши → Просмотреть код или Исходный код выделенного фрагмента.
-
На странице с элементом нажмите F12. В открывшемся окне с кодом воспользуйтесь поисковой строкой или нажмите Ctrl+F. Введите тег, id или класс, по которым можно найти элемент: например, <form>, <input> или button.
- Форма. Выберите этот способ, если формы заявок в исходном коде вашего сайта обозначены тегом
-
В зависимости от выбранного типа отправки введите в поле CSS-селектор:
-
Селектор формы. Селектор CSS, который точно определяет форму на сайте, из которой Roistat получает данные для формирования заявки. Можно указать несколько селекторов через запятую, если нужно собирать данные сразу из нескольких форм или если используются сложные классы.
-
Селектор кнопки. Селектор CSS, который точно определяет кнопку на сайте, по нажатию на которую Roistat получает данные для формирования заявки. Можно указать несколько селекторов через запятую, если нужно собирать данные сразу из нескольких форм или если используются сложные классы.
В качестве селектора можно указать id или название класса. Если вы указываете id, используйте формат #example, если вы указываете класс, используйте формат .example. Например, для элемента с тегом
<form id="form-1", class="contactform">
вы можете указать селектор одним из способов: #form-1 или .contactform.Как получить CSS-селектор для формы или кнопки
-
Откройте форму или страницу заказа на вашем сайте. Чаще всего она называется Корзина. Если на вашем сайте данные для заказа вводятся не в форме, а на странице сайта, перейдите к этапу, когда нужно отправлять заказ.
-
С помощью любого имеющегося у вас инструмента откройте исходный код формы или страницы заказа. Например, с помощью вашего браузера: левой кнопкой мыши выделите содержимое формы или страницы заказа, кликните правой кнопкой мыши и выберите Исходный код выделенного фрагмента или Просмотреть код.
-
Если нужно найти CSS-селектор для формы, воспользуйтесь поиском по ключевому слову form id или form. Если вам нужен CSS-селектор для кнопки, воспользуйтесь поиском по названию кнопки отправки заказа.
-
Скопируйте значение идентификатора (id) или класса (class):
-
-
Если необходимо инициировать обратный звонок на телефон клиента, который заполнил форму, включите настройку Обратный звонок:
-
Если данные из формы не нужно отправлять в CRM, выключите опцию Отправлять в CRM. Вы сможете в любой момент снова включить ее.
-
Если счетчик Roistat установлен на нескольких сайтах, и вы хотите, чтобы указанные настройки работали только на определенных сайтах, перечислите их через запятую в поле Сайты. Вы также можете исключить указанные сайты – для этого установите флажок напротив соответствующей опции. Если вы работаете только с одним сайтом или хотите, чтобы указанные настройки работали для всех ваших сайтов, оставьте поле Сайты пустым.
-
Укажите способ, которым заполняются основные поля заявки в CRM:
-
Статическое значение. Введенное в поле справа значение в том же виде передается в заявку в CRM. В поле справа также можно добавлять переменные. Этот способ подходит для данных, которые передаются автоматически без участия клиента: например, рекламный источник, номер визита и т.п. Чаще всего для передачи таких данных создаются дополнительные поля (см. следующий пункт инструкции).
Например, ваша форма находится на странице промоакции, и вы хотите вручную указать источник для всех заявок из этой формы. Добавьте дополнительное поле для источника и вручную введите значение Промоакция.
Если клиент переходит в форму по ссылке в рекламном объявлении, в дополнительных полях можно автоматически передавать значения меток в ссылке. Например, можно добавить поле utm_source и в качестве значения указать переменную {utmSource}.
-
Значение из поля формы. В заявку в CRM передается значение, введенное в поле формы на сайте. Данный способ подходит для стандартных форм, которые заполняет клиент. Укажите значение атрибута name для каждого поля формы на сайте. Например, для поля Телефон введите Phone, если в коде формы на сайте вы видите
<input type="text" name="Phone"...>
. -
Результат исполнения JS. В заявку в CRM передается значение, полученное с помощью JavaScript-кода. Выберите этот вариант, если данные из формы отправляются не в исходном виде, а каким-либо образом форматируются перед отправкой. Также данный способ подходит, если заявка отправляется нажатием на кнопку, без заполнения формы. Значение необходимо указывать в формате return $(".class-name").val() или return $("input[name='email']").val().
Вы можете указать, какие поля будут являться обязательными для заполнения клиентом. Если клиент их не заполнит, Roistat не отправит заявку.
-
-
Создайте при необходимости дополнительные поля заявки. Например, дополнительное поле может понадобиться, чтобы указывать город клиента. Также оно понадобится, если в вашей форме нет поля, которое является обязательным для заполнения в CRM.
Чтобы добавить дополнительное поле, нажмите Добавить поле:
-
В списке слева выберите нужное поле. Список полей загружается из CRM, с которой настроена интеграция.
-
Укажите способ, которым заполняется дополнительное поле (см. пункт 8 инструкции).
-
В поле справа введите значение, которое нужно передавать в дополнительное поле. Можно использовать переменные.
Если вам нужно передавать пустое значение в дополнительное поле заявки в CRM, укажите Статическое значение и введите пробел.
Вы можете добавить любое количество полей.
-
-
Нажмите кнопку Добавить форму.
Информация о созданной форме появится на странице Заявки с форм сайта. Вы можете отредактировать, удалить или скопировать форму, используя кнопки в графе Действия:
Изменения вступят в силу в течение нескольких минут, а также при выдаче нового номера визита.
С помощью кода¶
Ниже приведен образец php-кода, который собирает данные с формы заявки и отправляет их в Roistat. Вы можете взять его за основу, внести необходимые изменения и добавить в тот файл, который обрабатывает формы на вашем сайте.
Код для настройки передачи заявок в CRM через Roistat
Пример использования API-метода для добавления комментария к сделкам
Использование параметра 'sync'
По умолчанию значение параметра sync равно 0 ( 'sync' => '0'). В этом случае порядок событий следующий: данные о заявке отправляются в Roistat → Roistat отправляет отчет об их получении → Roistat отправляет данные о заявке в CRM → номер созданной в CRM заявки отправляется в Roistat. Если заявку в CRM не удается создать, ее номер не передается, сообщение об ошибке не выводится.
Если установить значение параметра sync равным 1 ( 'sync' => '1' ), порядок событий следующий: данные о заявке отправляются в Roistat → Roistat отправляет отчет об их получении → Roistat отправляет данные о заявке в CRM → далее возможны 2 варианта событий:
- Если заявку в CRM не удается создать, выводится ошибка;
- Если заявка в CRM создана, ее номер отправляется в Roistat.
Обратите внимание
Если значение параметра sync равно 1, то ошибка или номер заявки отправляются не только в Roistat, но и в ответ на запрос о создании проксилида.
Где найти параметр 'key'
Чтобы самостоятельно настроить интеграцию, необходимо скопировать значение параметра 'key' (ключ для интеграции) в окне настроек интеграции с вашей CRM. Перйдите в раздел Интеграции и нажмите Настроить интеграцию напротив нужной интеграции:
В окне настроек нажмите показать напротив строки Ключ для интеграции:
Пример дополнительных полей массива 'fields' => array(). Требуются для установки значений дополнительных полей в CRM.
amoCRM
RetailCRM
Битрикс24 (Сделки)
Если необходимо передать значения в поле с типом «список», в массиве дополнительных полей укажите ID нужных значений в виде строки в массиве:
МойСклад
Мегаплан
Битрикс24 (лиды + сделки), Битрикс24 (Коробка)
Если необходимо передать значения в поле с типом «список», в массиве дополнительных полей укажите ID нужных значений в виде строки в массиве:
YCLIENTS
Salesforce
FreshOffice
U-ON.Travel
HubSpot
Использование переменных¶
В полях title, comment, name и дополнительных полях заявки можно использовать следующие переменные:
Переменная | Значение |
---|---|
{agent} | Браузер посетителя |
{callDate} | Дата звонка в часовом поясе владельца проекта (если заявки отправляются Коллтрекингом Roistat) |
{callee} | Набранный номер (если заявки отправляются Коллтрекингом Roistat) |
{caller} | Номер телефона клиента (если заявки отправляются Коллтрекингом Roistat) |
{city} | Название города посетителя |
{country} | Страна посетителя |
{date} | Дата визита посетителя |
{domain} | Домен сайта |
{email} | Email, указанный клиентом |
{emailDate} | Дата письма в часовом поясе владельца проекта, если заявки отправляются через Email-трекинг Roistat |
{facebookClientId} | Значение fbclid, присвоенное счетчиком Facebook1. Также эту переменную можно использовать для записи facebookClientID в емейлтрекинге и в отправке заявок с форм сайта. |
{yclid} | Значение yclid – идентификатор клика по рекламному объявлению Яндекс.Директа. |
{firstVisit} | Номер первого визита |
{googleClientId} | Значение ClientId, присвоенное счетчиком Google Analytics. Также эту переменную можно использовать для записи googleClientID в емейлтрекинге и в отправке заявок с форм сайта. |
{ip} | IP-адрес посетителя |
{landingPage} | Посадочная страница |
{markerSource} | Первый уровень источника |
{metrikaClientId} | Значение ym_uid, присвоенное счетчиком Яндекс.Метрики. Также эту переменную можно использовать для записи metrikaClientID в емейлтрекинге и в отправке заявок с форм сайта. |
{name} | Имя, указанное клиентом |
{orderCreationMethod} | Способ создания заявки (Коллтрекинг, Ловец лидов и т.д.) |
{orderPage} | Страница, с которой была оставлена заявка. Работает для заявок, созданных с помощью Заявок с форм сайта |
{os} | Операционная система посетителя |
{phone} | Номер телефона, указанный клиентом |
{referrer} | Страница с которой перешел посетитель |
{region} | Регион посетителя |
{roistatParam1} | Значение метки roistat_param1 у посетителя |
{roistatParam2} | Значение метки roistat_param2 у посетителя |
{roistatParam3} | Значение метки roistat_param3 у посетителя |
{roistatParam4} | Значение метки roistat_param4 у посетителя |
{roistatParam5} | Значение метки roistat_param5 у посетителя |
{source} | Источник (маркер) |
{sourceAliasLevel1} | Человекочитаемое название источника (маркера) уровня 1 |
{sourceAliasLevel2} | Человекочитаемое название источника (маркера) уровня 2 |
{sourceAliasLevel3} | Человекочитаемое название источника (маркера) уровня 3 |
{sourceAliasLevel4} | Человекочитаемое название источника (маркера) уровня 4 |
{sourceAliasLevel5} | Человекочитаемое название источника (маркера) уровня 5 |
{sourceAliasLevel6} | Человекочитаемое название источника (маркера) уровня 6 |
{sourceAliasLevel7} | Человекочитаемое название источника (маркера) уровня 7 |
{sourceLevel1} | Значение источника (маркера) уровня 1 |
{sourceLevel2} | Значение источника (маркера) уровня 2 |
{sourceLevel3} | Значение источника (маркера) уровня 3 |
{sourceLevel4} | Значение источника (маркера) уровня 4 |
{sourceLevel5} | Значение источника (маркера) уровня 5 |
{sourceLevel6} | Значение источника (маркера) уровня 6 |
{sourceLevel7} | Значение источника (маркера) уровня 7 |
{utmCampaign} | Значение метки utm_campaign у посетителя |
{utmContent} | Значение метки utm_content у посетителя |
{utmMedium} | Значение метки utm_medium у посетителя |
{utmSource} | Значение метки utm_source у посетителя |
{utmTerm} | Значение метки utm_term у посетителя |
{visit} | Номер визита |
{visitor_uid} | Значение Идентификатора пользователя amoCRM |
Пример использования переменных
Язык значений динамических переменных зависит от языка, установленного в настройках профиля Roistat.
Сколько символов можно передать в колонках проксилида¶
- Заголовок (title) – 1024
- Текст (text) – 4096
- Имя – 1024
- Телефон – 1024
- Email – 1024
- Дополнительные поля – около 8000
Как работает передача заявок в CRM через Roistat¶
-
Посетитель заходит на ваш сайт и совершает действие, которое совпадает с условиями создания заявки. Например, нажимает кнопку Заказать, селектор которой указан в настройках формы для отправки заявок в Roistat.
-
В проекте Roistat создается заявка. Перейти к просмотру заявки вы можете в окне настройки интеграции с вашей CRM по ссылке Список отправленных заявок.
-
Roistat проверяет, подключена ли интеграция с CRM и настроена ли отправка заявок в CRM:
-
Если интеграция с CRM не подключена или не настроена отправка заявок в CRM, сделка в CRM не создается, в поле Отправлен в списке отправленных заявок в Roistat отображается значок X (если отправка не настроена) или надпись Не отправлять (если вы самостоятельно отключили отправку заявок), а поле Сделка остается пустым:
-
Если интеграция с CRM подключена и настроена отправка заявок в CRM, Roistat отправляет заявку.
-
Обратите внимание
Если по каким-либо причинам CRM не отправляет подтверждение о создании сделки, то в поле Отправлен в списке отправленных заявок в Roistat отображается значок X. Roistat предпринимает попытку отправить заявку каждые 30 минут в течение 2 дней. После получения подтверждения из CRM в поле Отправлен отображается значок V, а в поле Сделка отображается номер созданной в CRM сделки:
-
Правообладателем Facebook является запрещенная на территории РФ компания Meta Platforms, признанная судом экстремистской. ↩