Передача заявок в CRM через Roistat (проксилид)¶

Передача заявок с сайта в CRM может происходить двумя способами:

1. Данные передаются с сайта в CRM, а затем оттуда загружаются в Roistat.

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

2. Данные передаются с сайта в Roistat, а затем отправляются в CRM. Преимущества способа:

   • Обеспечивает резервное хранение информации о заявках в Roistat. Нет повода беспокоиться, доступна ли в данный момент CRM или нет. Данные сохраняются в проекте Roistat и, если CRM недоступна, через некоторое время отправляются в CRM повторно. 

   • Позволяет гибко и быстро менять настройки передачи заявок в CRM.

В данной статье описана настройка второго варианта, когда заявки сначала отправляются в Roistat, а затем в CRM.

Настройка¶

Предполагается, что у вас уже настроена интеграция вашей CRM с Roistat (читайте инструкцию для вашей CRM).

Вы можете настроить передачу заявок в CRM через Roistat двумя способами:

• В интерфейсе Roistat. Этот способ более простой.

• С помощью php-кода. Этот способ более гибкий в настройке. 

В интерфейсе Roistat¶

1. В проекте Roistat откройте раздел Настройки и выберите закладку Заявки с форм сайта. Нажмите кнопку Добавить форму:

   

2. В поле Название сделки введите текст, который будет отображаться в названии заявки: например, Заявка из формы обратной связи. 

3. В правом верхнем углу выберите тип отправки данных по заявке:

   • Форма. Выберите этот способ, если формы заявок в исходном коде вашего сайта обозначены тегом <form>, поля для ввода данных в них обозначены тегом <input>, а данные отправляются с перенаправлением или обновлением страницы по нажатию на кнопку с типом type="submit" .
   • Кнопка. Выберите этот способ, если данные из формы заявки отправляются без перезагрузки страницы с помощью AJAX по нажатию на кнопку любого типа.

   

   Как посмотреть код элемента в браузере

   Посмотреть код элемента в браузере можно двумя способами:

   1. Левой кнопкой мыши выделите содержимое формы. Затем кликните правой кнопкой мыши → Просмотреть код или Исходный код выделенного фрагмента.

   2. На странице с элементом нажмите F12. В открывшемся окне с кодом воспользуйтесь поисковой строкой или нажмите Ctrl+F. Введите тег, id или класс, по которым можно найти элемент: например, <form>, <input> или button.

4. В зависимости от выбранного типа отправки введите в поле CSS-селектор:

   • Селектор формы. Селектор CSS, который точно определяет форму на сайте, из которой Roistat получает данные для формирования заявки. Можно указать несколько селекторов через запятую, если нужно собирать данные сразу из нескольких форм или если используются сложные классы.

   • Селектор кнопки. Селектор CSS, который точно определяет кнопку на сайте, по нажатию на которую Roistat получает данные для формирования заявки. Можно указать несколько селекторов через запятую, если нужно собирать данные сразу из нескольких форм или если используются сложные классы.

   В качестве селектора можно указать id или название класса. Если вы указываете id, используйте формат #example, если вы указываете класс, используйте формат .example. Например, для элемента с тегом <form id="form-1", class="contactform"> вы можете указать селектор одним из способов: #form-1 или .contactform.

   Как получить CSS-селектор для формы или кнопки

   1. Откройте форму или страницу заказа на вашем сайте. Чаще всего она называется Корзина. Если на вашем сайте данные для заказа вводятся не в форме, а на странице сайта, перейдите к этапу, когда нужно отправлять заказ.

   2. С помощью любого имеющегося у вас инструмента откройте исходный код формы или страницы заказа. Например, с помощью вашего браузера: левой кнопкой мыши выделите содержимое формы или страницы заказа, кликните правой кнопкой мыши и выберите Исходный код выделенного фрагмента или Просмотреть код.

   3. Если нужно найти CSS-селектор для формы, воспользуйтесь поиском по ключевому слову form id или form. Если вам нужен CSS-селектор для кнопки, воспользуйтесь поиском по названию кнопки отправки заказа.

   4. Скопируйте значение идентификатора (id) или класса (class):

   

5. Если необходимо инициировать обратный звонок на телефон клиента, который заполнил форму, включите настройку Обратный звонок:

   

6. Если данные из формы не нужно отправлять в CRM, выключите опцию Отправлять в CRM. Вы сможете в любой момент снова включить ее.

   

7. Если счетчик Roistat установлен на нескольких сайтах, и вы хотите, чтобы указанные настройки работали только на определенных сайтах, перечислите их через запятую в поле Сайты. Вы также можете исключить указанные сайты – для этого установите флажок напротив соответствующей опции. Если вы работаете только с одним сайтом или хотите, чтобы указанные настройки работали для всех ваших сайтов, оставьте поле Сайты пустым.

8. Укажите способ, которым заполняются основные поля заявки в 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 не отправит заявку.

9. Создайте при необходимости дополнительные поля заявки. Например, дополнительное поле может понадобиться, чтобы указывать город клиента. Также оно понадобится, если в вашей форме нет поля, которое является обязательным для заполнения в CRM.

   Чтобы добавить дополнительное поле, нажмите Добавить поле:

   

   • В списке слева выберите нужное поле. Список полей загружается из CRM, с которой настроена интеграция.

   • Укажите способ, которым заполняется дополнительное поле (см. пункт 8 инструкции).

   • В поле справа введите значение, которое нужно передавать в дополнительное поле. Можно использовать переменные.

   Если вам нужно передавать пустое значение в дополнительное поле заявки в CRM, укажите Статическое значение и введите пробел.

   Вы можете добавить любое количество полей.

10. Нажмите кнопку Добавить форму.

    

Информация о созданной форме появится на странице Заявки с форм сайта. Вы можете отредактировать, удалить или скопировать форму, используя кнопки в графе Действия:

С помощью кода¶

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

Код для настройки передачи заявок в CRM через Roistat  

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

<?php
// Данные должны быть в кодировке UTF-8! Иначе это может привести к ошибке.
// Если вы используете кодировку Windows-1251, то можно преобразовать все переменные через $value = iconv("Windows-1251", "UTF-8", $value);
// или указать в доп. полях ключ 'charset' с используемой на сайте кодировкой. Сервер Roistat конвертирует все значения из указанной кодировки в UTF-8.

// ...
// Где-то здесь вызывается текущая функция создания сделки, например, функция mail().
// ...

$roistatData = array(
    'roistat' => isset($_COOKIE['roistat_visit']) ? $_COOKIE['roistat_visit'] : 'nocookie',
    'key'     => '', // Ключ для интеграции с CRM, указывается в настройках интеграции с CRM.
    'title'   => '', // Название сделки
    'comment' => '', // Комментарий к сделке
    'name'    => '', // Имя клиента
    'email'   => '', // Email клиента
    'phone'   => '', // Номер телефона клиента
    'order_creation_method' => '', // Способ создания сделки (необязательный параметр). Укажите то значение, которое затем должно отображаться в аналитике в группировке "Способ создания заявки"
    'is_need_callback' => '0',  // Если указано значение '1', на номер клиента будет инициироваться обратный звонок после создания заявки в Roistat (независимо от того, включен ли обратный звонок в Ловце лидов). 
                                //Если указано значение '0', для данной формы обратный звонок инициироваться не будет (даже если в Ловце лидов включен обратный звонок). 
    'callback_phone' => '<Номер для переопределения>', // Переопределяет номер, указанный в настройках обратного звонка.
    'sync'    => '0', //
    'is_need_check_order_in_processing' => '1', // Настройка стандартной проверки заявок на дубли. 
                                                // Если установлено значение '1', на дубли будут проверяться заявки за последние 12 часов только в статусах группы "В работе". 
                                                // Если установлено значение '0', будут проверяться все заявки за последние 12 часов. 
                                                // Данный параметр не участвует в пользовательской проверке на дубли.
    'is_need_check_order_in_processing_append' => '1', // Если создана дублирующая заявка, в нее будет добавлен комментарий об этом
    'is_skip_sending' => '1', // Не отправлять заявку в CRM.
    'fields'  => array(
    // Массив дополнительных полей. Если дополнительные поля не нужны, оставьте массив пустым.
    // Примеры дополнительных полей смотрите в таблице ниже.
    // Помимо массива fields, который используется для сделки, есть еще массив client_fields, который используется для установки полей контакта.
     "charset" => "Windows-1251", // Сервер преобразует значения полей из указанной кодировки в UTF-8.
    ),
);

file_get_contents("https://cloud.roistat.com/api/proxy/1.0/leads/add?" . http_build_query($roistatData));
?>

Пример использования API-метода для добавления комментария к сделкам

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

<?php 
// Метод добавляет комментарий к сделке
$roistatData = array(
    'key'     => '', // Ключ для интеграции с CRM, указывается в настройках интеграции с CRM.
    'id'   => '', // Идентификатор заявки, который вернул при ее создании метод /api/proxy/1.0/leads/add
    'title'    => '', // Заголовок для комментария, необязателен
    'message' => '', // Комментарий к сделке
);

file_get_contents("https://cloud.roistat.com/api/proxy/1.0/leads/messages/add?" . http_build_query($roistatData));
?> 

Использование параметра 'sync'

По умолчанию значение параметра sync равно 0 ( 'sync' => '0'). В этом случае порядок событий следующий: данные о заявке отправляются в Roistat → Roistat отправляет отчет об их получении → Roistat отправляет данные о заявке в CRM → номер созданной в CRM заявки отправляется в Roistat. Если заявку в CRM не удается создать, ее номер не передается, сообщение об ошибке не выводится.

Если установить значение параметра sync равным 1 ( 'sync' => '1' ), порядок событий следующий: данные о заявке отправляются в Roistat → Roistat отправляет отчет об их получении → Roistat отправляет данные о заявке в CRM → далее возможны 2 варианта событий:

• Если заявку в CRM не удается создать, выводится ошибка;
• Если заявка в CRM создана, ее номер отправляется в Roistat.

Где найти параметр 'key'

Чтобы самостоятельно настроить интеграцию, необходимо скопировать значение параметра 'key' (ключ для интеграции) в окне настроек интеграции с вашей CRM. Перйдите в раздел Интеграции и нажмите Настроить интеграцию напротив нужной интеграции:

В окне настроек нажмите показать напротив строки Ключ для интеграции:

Пример дополнительных полей массива 'fields' => array(). Требуются для установки значений дополнительных полей в CRM.

amoCRM

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

'price' => 123, // Поле бюджет в amoCRM.
'responsible_user_id' => 3, // Ответственный по сделке.
'1276733' => 'Текст', // Заполнение доп. поля с ID 1276733. Дополнительное поле может быть заполнено как у сделки, так и у контакта. 
                      // В случае заполнения поля контакта также необходимо указать ID этого поля.

'status_id' => 123123, // Создавать лид с определенным статусом в определенной воронке. Указывать необходимо ID статуса.
'pipeline_id' => 123123, // Создавать лид с в определенной воронке. Указывать необходимо ID воронки.

// Подробную информацию о наименовании полей и получить список дополнительных полей вы можете в документации amoCRM: https://developers.amocrm.ru/rest_api/#lead.
// Более подробную информацию по работе с дополнительными полями в amoCRM вы можете получить у службы поддержки Roistat.
'tags' => 'Тег1, Тег2', // Название тегов через запятую.

RetailCRM

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

'managerComment' => 'Комментарий оператора',

'orderMethod' => 'landing-page', // Способ оформления заказа.

'managerId' => 123, // Ответственный менеджер, где 123 - id менеджера в системе. 
                    // Узнать id вашего менеджера можно зайдя в его профиль по ссылке <http://forexample.retailcrm.ru/managers/123>, число 14 и будет являться искомым id.

// Подробную информацию о наименовании полей и список дополнительных полей вы можете найти в документации RetailCRM: <https://www.retailcrm.ru/docs/rest-api/index.html>`

// Более подробную информацию по работе с дополнительными полями в RetailCRM вы можете получить у службы поддержки Roistat.

// Заполнение пользовательских полей:

'<Символьный код>' => 'Значение', // Строка.
'<Символьный код>' => '1', // Флажок (1 -- Отмечен, 0 -- Снят).
'<Символьный код>' =>` '<Символьный код значения справочника>', // Справочник.

Битрикс24 (Сделки)

1
2
3
4
5
6
7
8

'OPPORTUNITY' => 123, // Поле сделки Сумма
'ASSIGNED_BY_ID' => 3, // Ответственный по сделке.
'UF_CRM_1425989455' => 'Текст', // Заполнение доп. поля с ID UF_CRM_1425989455. Дополнительное поле может быть заполнено как у сделки, так и у контакта. 
                                // В случае заполнения поля контакта также необходимо указать ID этого поля.
'ASSIGNED_BY_CONTACT_MANAGER' => 'Y', // Установить ответственного менеджера, как в найденном контакте (если будет найден).
'STAGE_ID' => 'статус' // Статус сделки.
// Подробную информацию о наименовании полей и список доп. полей вы можете найти в документации по REST API в интерфейсе Битрикс24.
// Более подробную информацию по работе с дополнительными полями в Битрикс24 вы можете получить у службы поддержки Roistat.

Если необходимо передать значения в поле с типом «список», в массиве дополнительных полей укажите ID нужных значений в виде строки в массиве:

// Пример для PHP

'lead_UF_CRM_1234567890' => array('51','52','53'),

// Пример для JavaScript

'lead_UF_CRM_1234567890':['51','52','53']

МойСклад

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

'state' => '<Value>', // Статус создаваемого заказа (Необязательное поле).
'currency_uuid' => '<Value>', // Поле 'Валюта' в заказе покупателя.
'project_uuid' => '<Value>', // Поле 'Проект' в заказе покупателя.
'contract_uuid' => '<Value>', // Поле 'Договор' в заказе покупателя.
'owner_uid' => 'demo@login', // Назначения ответственного по сделке. Вместо demo@login - укажите логин сотрудника для входа в систему (логины сотрудников можно посмотреть в системе, перейдя в пункт меню "Моя компания" и нажав на вкладку "Сотрудники", в поле "Логин").
'existing_store_uuid' => '<Store_ID>', // Обязательный параметр. Заменить <Store_ID> на идентификатор склада (например, 770657b-4fd2-11e4-90a2-8eca004192b1).
'existing_organization_uuid' => '<Org_ID>', // Обязательный параметр. Заменить <Org_ID> на идентификатор Юр.лица.
'existing_counterparty_uuid' => '<Counter_ID>', // Заменить <Item_ID> на идентификатор контрагента.
'existing_good_uuid' => ['uuid' => 'GOOD_ID'], // Обязательный параметр. Заменить <Good_ID> на идентификатор товара.
'count' => '<Count>', // Заменить <Count> на кол-во товаров в заказе этого наименования. (Необязательный параметр, по умолчанию = 1).
'discount' => '<Discount_percent>', // Заменить <Discount_percent> на размер скидки в процентах (Необязательный параметр, по умолчанию будет = 0).
'vat' => '18', // НДС. По умолчанию - 18%. Вы можете задать собственное значение.
'sum' => '0', // Сумма товара. Вы можете задать собственное значение. ), array( // Этот массив нужен, если товаров несколько.
'uuid' => '<Good_ID>', // Необязательный параметр.
'count' => '<Count>', // Необязательный параметр.
'discount' => '<Discount_percent>', // Необязательный параметр.
'<Field_Name>' => '<Value>', // Заменить <Value> на значение поля.

Мегаплан

1
2
3

'Cost' => 123, // Поле Сумма в Мегаплан 'Category1000047CustomFieldSayt' => 'Текст' // Заполнение доп. поля Category1000047CustomFieldSayt
// Подробную информацию о наименовании полей и список доп. полей вы можете найти в документации Мегаплан: https://help.megaplan.ru/API_deal_save.
// Более подробную информацию по работе с дополнительными полями в Мегаплан вы можете получить у службы поддержки Roistat.

Битрикс24 (лиды + сделки), Битрикс24 (Коробка)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

'OPPORTUNITY' => 123, // Поле 'Возможная сумма сделки'.
'ASSIGNED_BY_ID' => 3, // Ответственный по лиду. 'UF_CRM_1425989455' => 

'UF_CRM_1425989455' => 'Текст', // Заполнение доп. поля с ID UF_CRM_1425989455. Дополнительное поле может быть заполнено как у сделки, так и у контакта. В случае заполнения поля контакта также необходимо указать ID этого поля.

'SOURCE_ID' => 47, // Поле 'Источник'.
'SOURCE_DESCRIPTION' => 25, // Поле 'Дополнительно об источнике'.
'ASSIGNED_BY_CONTACT_MANAGER' => 'Y', // Установить ответственного менеджера, как в найденном контакте (если будет найден).
'STATUS_ID' => 'статус' // Статус лида.
// Подробную информацию о наименовании полей и список доп. полей вы можете найти в документации по REST API в интерфейсе Битрикс24.
// Более подробную информацию по работе с дополнительными полями в Битрикс24 вы можете получить у службы поддержки Roistat.

Если необходимо передать значения в поле с типом «список», в массиве дополнительных полей укажите ID нужных значений в виде строки в массиве:

// Пример для PHP

'lead_UF_CRM_1234567890' => array('51','52','53'),

// Пример для JavaScript

'lead_UF_CRM_1234567890':['51','52','53']

YCLIENTS

1
2

'staff_id' => 3512, // Идентификатор сотрудника, на которого будет создана запись.
'company_id' => 4564, // Идентификатор компании (филиала), в рамках которой будет создана запись.

Salesforce

1
2
3
4
5
6
7
8
9

// Чтобы заполнить доп. поле, нужно передать его в формате ключ => значение. Если это пользовательское поле, в качестве ключа используется API name, для стандартных полей - Field Name.

'Company' => 'Компания',
'Title' => 'Должность',
'Owner' => 123, // Менеджер, ответственный за интерес, где 123 - id менеджера в системе.

// Названия стандартных и настраиваемых полей можно посмотреть в управлении полями сущности на странице Настройка -> Разработать -> Настроить -> Интересы/Возможности/Заказы -> Поля.`

// Более подробную информацию по работе с настраиваемыми полями читайте в документации Salesforce: <https://help.salesforce.com/apex/HTViewHelpDoc?id=customize_customfields.htm&language=ru> . 

FreshOffice

1
2
3
4
5

'person' => '1', // Тип создаваемого контрагента (1 --- юридическое лицо, 2 --- физическое лицо).`
'id_status_deal' => '1', // Идентификатор статуса сделки (по умолчанию --- 1).
'summa' => '0.00', // Сумма сделки.
'chance' => '100', // Вероятность.
'id_manager' => '1', // Установить ответственного менеджера.

U-ON.Travel

1
2
3
4

'bedroom_count' => 4 // Количество спален.
'price' => 3000, // Цена за 1 день.
// Подробную информацию о наименовании полей и их список вы можете найти в документации: http://api.u-on.ru/doc.
// Более подробную информацию по работе с полями в U-ON.Travel вы можете получить у службы поддержки Roistat.

HubSpot

1
2

'status' => 'status_id', // Статус сделки
'pipeline' => 'pipeline_id', // Воронка сделки

Использование переменных¶

В полях title, comment, name и дополнительных полях заявки можно использовать следующие переменные:

Пример использования переменных

1
2
3
4
5
6
7
8
9

$roistatData = array(
    'title'   => 'Новая сделка {visit}',
    'name'    => 'Имя клиента {visit}',
    'comment' => 'utm_source: {utmSource}, utm_medium: {utmMedium}, utm_campaign: {utmCampaign}',
    'fields'  => array(
        '1276733' => '{city}', // Сохраняем в доп. поле город посетителя
        'tags'    => 'Тег1, {utmSource}, {utmMedium}, {utmCampaign}', // Сохраняем значения UTM-меток в тегах
    ),
);

Сколько символов можно передать в колонках проксилида¶

• Заголовок (title) – 1024
• Текст (text) – 4096
• Имя – 1024
• Телефон – 1024
• Email – 1024
• Дополнительные поля – около 8000  

Как работает передача заявок в CRM через Roistat¶

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

2. В проекте Roistat создается заявка. Перейти к просмотру заявки вы можете в окне настройки интеграции с вашей CRM по ссылке Список отправленных заявок.

3. Roistat проверяет, подключена ли интеграция с CRM и настроена ли отправка заявок в CRM:

   • Если интеграция с CRM не подключена или не настроена отправка заявок в CRM, сделка в CRM не создается, в поле Отправлен в списке отправленных заявок в Roistat отображается значок X (если отправка не настроена) или надпись Не отправлять (если вы самостоятельно отключили отправку заявок), а поле Сделка остается пустым:

     

   • Если интеграция с CRM подключена и настроена отправка заявок в CRM, Roistat отправляет заявку.