Skip to end of metadata
Go to start of metadata

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

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

Настройка

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

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

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

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

  1. В проекте Roistat откройте раздел Настройки и выберите закладку Заявки с форм сайта.
  2. Нажмите кнопку Добавить форму. 
    Откроется окно Новая форма.
  3. В поле Название введите текст, который будет отображаться в названии заявки: Заявка с формы <Название>.
  4. Укажите механизм отправки данных по заявке:
    • Форма. Выберите этот способ, если формы заявок в исходном коде вашего сайта обозначены тегом <form>, поля для ввода данных в них обозначены тегом <input>, а данные отправляются с перенаправлением или обновлением страницы по нажатию на кнопку с типом type=”submit” .
    • Кнопка. Выберите этот способ, если данные из формы заявки отправляются без перезагрузки страницы с помощью AJAX по нажатию на кнопку любого типа.
  5. В зависимости от механизма отправки данных по заявке введите:
    • Селектор формы. Селектор CSS, который точно определяет форму на сайте, из которой Roistat получает данные для формирования заявки. Вы можете указать один или несколько селекторов, важно, чтобы они определяли нужную форму. Для указания селекторов используйте нотацию CSS, например: селектор класса .registration-form-1 (<form class=“registration-form-1”>), селектор идентификатора #contact-form-1 (<form id=“contact-form-1”>). 
    • Селектор кнопки. Селектор CSS, который точно определяет кнопку на сайте, по нажатию на которую Roistat получает данные для формирования заявки. Вы можете указать один или несколько селекторов, важно, чтобы они определяли нужную кнопку. Для указания селекторов используйте нотацию CSS, например: селектор класса .bnt-primary (<button class=“bnt-primary”>).  

     Как получить селектор CSS для формы или кнопки
    1. Откройте форму заказа на вашем сайте. Это может быть корзина или форма заказа услуги.
    2. С помощью любого имеющегося у вас инструмента откройте исходный код формы. Например, с помощью вашего браузера: правой кнопкой мыши вызовите контекстное меню формы и выберите Исходный код страницы.
    3. Сделайте поиск по ключевому слову form id или form, если хотите получить селектор CSS для формы. Сделайте поиск по названию кнопки, по которой отправляется заказ, если хотите получить селектор CSS для кнопки.
    4. Скопируйте значение идентификатора (id) или класса (class).

  6. Укажите способ, которым заполняются основные поля заявки в CRM:
     
    • Статическое значение. Введенное в поле справа значение в том же виде передается в заявку в CRM.

    • Значение из поля формы. В заявку в CRM передается значение, введенное в поле формы на сайте. Укажите значение атрибута name для поля формы на сайте. Например, введите Phone для поля Телефон, если в коде формы на сайте вы видите <input type="text" name="Phone"...>.
    • Результат исполнения JS. В заявку в CRM передается значение, полученное с помощью JavaScript-кода. Например, return $("input[name='email']").val() для поля Email.
  7. Создайте при необходимости дополнительные поля заявки:
    1. Раскройте блок Дополнительные поля.
    2. Введите название дополнительного поля.
    3. Укажите способ, которым заполняется дополнительное поле (см. пункт 6 инструкции).
    4. Нажмите кнопку Добавить и повторите пункты b и c, если требуется больше одного дополнительного поля.
    Дополнительное поле может понадобиться, например, чтобы указывать город, в котором отправлена заявка.
  8. Нажмите кнопку Сохранить.

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

Как настроить передачу заявок в CRM через Roistat с помощью кода

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

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


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

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

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

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

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

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

ПеременнаяЗначение
{city}Название города посетителя
{country}Страна посетителя
{ip}IP адрес посетителя
{visit}Номер визита
{referrer}Страница с которой перешел посетитель
{domain}Домен сайта
{landingPage}Посадочная страница
{source}Источник (маркер)
{utmSource}Значение метки utm_source у посетителя
{utmMedium}Значение метки utm_medium у посетителя
{utmCampaign}Значение метки utm_campaign у посетителя
{utmTerm}Значение метки utm_term у посетителя
{utmContent}Значение метки utm_content у посетителя
{callee}Набранный номер (если заявки отправляются Коллтрекингом)
{caller}Номер телефона клиента (если заявки отправляются Коллтрекингом)

{roistatParam1}

Значение метки roistat_param1 у посетителя
{roistatParam2}Значение метки roistat_param2 у посетителя
{roistatParam3}Значение метки roistat_param3 у посетителя
{roistatParam4}Значение метки roistat_param4 у посетителя
{roistatParam5}Значение метки roistat_param5 у посетителя
{googleClientId}Значение ClientId, присвоенное счетчиком Google Analytics
Пример использования переменных
 Пример дополнительных полей массива 'fields' => array(). Требуются для установки значений дополнительных полей в CRM.
Название CRMПример дополнительных полей
amoCRM
'price' => 123, // Поле бюджет в amoCRM.
'responsible_user_id' => 3, // Ответственный по сделке.
'1276733' => 'Текст', // Заполнение доп. поля с ID 1276733.
'status_id' => 123123, // Создавать лид с определенным статусом в определенной воронке. Указывать необходимо ID статуса.
// Подробную информацию о наименовании полей и получить список дополнительных полей вы можете в документации amoCRM: https://developers.amocrm.ru/rest_api/#lead.
// Более подробную информацию по работе с дополнительными полями в amoCRM вы можете получить у службы поддержки Roistat.
'tags' => 'Тег1, Тег2', // Название тегов через запятую.
retailCRM'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 (Сделки)
'OPPORTUNITY' => 123, // Поле сделки Сумма.
'ASSIGNED_BY_ID' => 3, // Ответственный по сделке. 'UF_CRM_1425989455' => 'Текст', // Заполнение доп. поля с ID UF_CRM_1425989455. 'ASSIGNED_BY_CONTACT_MANAGER' => 'Y', // Установить ответственного менеджера, как в найденном контакте (если будет найден). // Подробную информацию о наименовании полей и получить список доп. полей вы можете в документация по REST API в интерфейсе Битрикс24. // Более подробную информацию по работе с дополнительными полями в Битрикс24 вы можете получить у службы поддержки Roistat.
МойСклад
'state_uuid'    => '<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' => array( // Обязательный параметр.
			array(
				'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>' => array( // Заменить <Field_Name> на произвольное название поля.
			'uuid'  => '<Metadata_ID>', // Заменить <Metadata_ID> на идентификатор поля.
			'value' => '<Value>', // Заменить <Value> на значение поля.
			'type'  => '<Type_name>', // Заменить <Type_name> на идентификатор типа поля.	
		),
Мегаплан
'Cost' => 123, // Поле Сумма в Мегаплан
'Category1000047CustomFieldSayt' => 'Текст' // Заполнение доп. поля Category1000047CustomFieldSayt
// Подробную информацию о наименовании полей и получить список доп. полей вы можете в документации Мегаплан: https://help.megaplan.ru/API_deal_save.
// Более подробную информацию по работе с дополнительными полями в Мегаплан вы можете получить у службы поддержки Roistat.

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

Битрикс24 (Коробка)

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

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

'Company' => 'Компания',
'Title' => 'Должность',
'Owner' => 123, // Менеджер, ответственный за интерес, где 123 - id менеджера в системе.
// Названия стандартных и настраиваемых полей можно посмотреть в управлении полями сущности на странице Настройка -> Разработать -> Настроить -> Интересы/Возможности/Заказы -> Поля.
// Более подробную информацию по работе с настраиваемыми полями читайте в документации Salesforce: https://help.salesforce.com/apex/HTViewHelpDoc?id=customize_customfields.htm&language=ru.
FreshOffice'person' => '1', // Тип создаваемого контрагента (1 — юридическое лицо, 2 — физическое лицо).
'id_status_deal' => '1', // Идентификатор статуса сделки (по умолчанию — 1).
'summa' => '0.00', // Сумма сделки.
'chance' => '100', // Вероятность.
'id_manager' => '1', // Установить ответственного менеджера.
U-ON.Travel
'bedroom_count' => 4 // Количество спален.
'price' => 3000, // Цена за 1 день.
// Подробную информацию о наименовании полей и получить их список вы можете в документации: http://api.u-on.ru/doc.
// Более подробную информацию по работе с полями в U-ON.Travel вы можете получить у службы поддержки Roistat.

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

  1. Посетитель заходит на ваш сайт и совершает действие, которое совпадает с условиями создания заявки.
    Например, нажимает кнопку Заказать, селектор которой указан в настройках формы для отправки заявок в Roistat.
  2. В проекте Roistat создается заявка. Перейти к просмотру заявки вы можете в окне настройки интеграции с вашей CRM по ссылке Список отправленных заявок.
  3. Roistat проверяет, подключена ли интеграция с CRM и настроена ли отправка заявок в CRM:
    • Если интеграция с CRM не подключена или не настроена отправка заявок в CRM, сделка в CRM не создается, в поле Отправлен в списке отправленных заявок в Roistat отображается значок , а поле Сделка остается пустым.

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

  • No labels