Skip to end of metadata
Go to start of metadata

Зачем загружать заявки

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

Первый способ - когда на сайте уже настроена отправка заявок в CRM. В этом случае они загружаются в Roistat после подключения CRM. Настройка минимальна: нужно только создать дополнительное поле в CRM и добавить скрипт на сайт, чтобы оно автоматически заполнялось уникальным номером посещения.

Используйте этот способ, если у вас уже настроена автоматическая отправка заявок с сайта в CRM и вы не хотите это менять.

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

Этот способ надежнее. Если в момент создания заявки CRM была недоступна, заявка не потеряется и будет создана в CRM, когда появится доступ (попытки отправить заявку будут продолжаться каждые 30 минут в течение двух суток). При этом в новую CRM не получится отправить не те заявки, так как передача заявок для каждой CRM настраивается индивидуально.

Настройка чуть сложнее: нужно внести изменения в скрипт отправки данных, который уже используется на вашем сайте. Впрочем, самое сложное здесь - найти на сайте этот скрипт, а изменить в нем несколько строк не составит труда.

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

Схематически способы загрузки данных выглядят так:

Заявки загружаются из CRM в Roistat

Заявки отправляются из Roistat в CRM

 

Загрузка заявок происходит примерно раз в час по заказам, которые изменились за последние 48 часов, и раз в день по заказам, измененным за последнюю неделю.

Как настроить загрузку заявок из CRM

Создание дополнительного поля

Когда клиент заходит на сайт, в браузере сохраняется информация о визите. Например, о том, откуда был совершен переход на сайт. Для связи визитов с заявками в CRM Roistat использует номер визита. Это уникальный номер посещения, который записывается в cookie roistat_visit. Содержимое этой cookie нужно передать в CRM вместе с созданной заявкой. Для этого сначала в CRM нужно создать дополнительное поле с именем roistat

 Пример дополнительного поля roistat в amoCRM

Установка скрипта

Добавьте на страницу сайта скрипт, который получает значение cookie roistat_visit. Его нужно разместить до отправки данных в CRM. Пример скрипта:

Как настроить отправку заявок в CRM

Создание дополнительного поля

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

Настройка скрипта

1. На сервере с вашим сайтом найдите файл, который обрабатывает форму заявки. Например, это может быть скрипт, который отправляет данные с формы на электронную почту.

2. Данные в файле должны быть в кодировке UTF-8. 

 У меня кодировка Windows-1251. Как ее изменить?

Это можно сделать одним из способов:

  • Используйте функцию iconv(). Перед каждой переменной в файле вставьте строку:

ВАЖНО $value - это пример переменной. Замените value на имя своей переменной.

  • Передайте значение вашей кодировки в массиве полей, тогда Roistat автоматически преобразует данные в UTF-8. Например:

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

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

ВАЖНО Телефон и электронная почта - обязательные параметры. Нужно передать хотя бы один из них, иначе заявка не будет создана. Ключ интеграции - тоже обязательное поле, без него загрузка заявок не будет работать.

 Где взять ключ для интеграции

Ваш ключ для интеграции находится внизу раздела Каталог интеграции -> Подключенная CRM:


Дополнительные настройки

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

Обратный звонок

Если клиент оставил в форме заявки свой телефон, можно автоматически ему перезвонить. Для этого нужно:

  • Подключить опцию Ловец лидов, если у вас тариф Старт. На других тарифах Ловец лидов включен в стоимость
  • В разделе Ловец лидов → Обратный звонок разрешить обратный звонок и указать номер менеджера для переадресации звонка

     Подробнее
  • Передать параметр 'is_need_callback' => '1' в скрипте отправки данных формы заявки

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

Передача дополнительных полей

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

Формат и названия дополнительных полей отличаются для разных CRM. Чтобы передавать в них значение, нужно знать ID полей. Если вы не можете узнать их самостоятельно, обратитесь к разработчикам своей CRM/CMS. 

СОВЕТ У многих CRM/CMS систем есть API. C помощью API-метода можно выгрузить свои заявки, посмотреть, какие есть поля и какие у них ID. Посмотрите, к примеру, как сделать это в amoCRM.

 Пример передачи дополнительных полей в amoCRM

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

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

В каких полях заявки можно использовать переменные:

  • title
  • comment
  • name
  • дополнительные поля 

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

{roistatParam1}

Значение метки roistat_param1
{roistatParam2}Значение метки roistat_param2
{roistatParam3}Значение метки roistat_param3
{roistatParam4}Значение метки roistat_param4
{roistatParam5}Значение метки roistat_param5
 Пример использования переменных

Проверка на дубли

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

Если заявка от этого клиента уже есть, но у нее другой статус, будет создана еще одна. Если новая заявка дублирует еще не загруженную заявку в Roistat - то же самое.

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

Чтобы использовать проверку на дубли, нужно передать параметр 'is_need_check_order_in_processing' => '1' в скрипте отправки данных формы заявки

Если создана заявка, которая дублирует существующую заявку в статусе В работе, в последнюю можно передать комментарий об этом. Используйте параметр 'is_need_check_order_in_processing_append' => '1' совместно с параметром 'is_need_check_order_in_processing' => '1' .

 Пример проверки на дубли
 Пример проверки на дубли с добавлением комментария
 Как узнать, какие статусы включены в группу В работе

Статусы заявок CRM распределяются по группам внизу страницы настроек интеграции ( Каталог интеграций → Настройки подключенной интеграции ):

Подтверждение создания сделки в CRM

Используйте параметр 'sync' => '1' , когда после отправки заявки с сайта в Roistat требуется получать от CRM подтверждение создания сделки. Если сделка создана успешно, скрипт вернет ее ID. Например, это можно использовать, чтобы после создания заявки сразу показывать клиенту номер заказа (обычно совпадает с ID сделки в CRM). Если сделку не удалось создать, вместо ID сделки будет ошибка.

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

Проверка работы

Создайте тестовую заявку с сайта. Все настроено правильно, если:

  • в разделе Каталог интеграций вашего проекта Roistat в Списке отправленных заявок подключенной интеграции появилась новая заявка 

  • в поле Промокод указан номер визита, а в поле Отправлен успешный статус отправки 
  • в CRM появилась новая заявка с этим номером визита в поле roistat

Решение проблем

 Заявки с сайта нет в списке отправленных заявок

Это значит, что заявка либо не была отправлена с сайта в Roistat, либо не была им получена. Возможные причины:

  1. Проблема на стороне сервера, где расположен ваш сайт
  2. Ошибки в скрипте отправки данных

Что делать:

  1. Измените последнюю строку в скрипте отправки данных с этой:
    file_get_contents("https://cloud.roistat.com/api/proxy/1.0/leads/add?" . http_build_query($roistatData));

    На эту:

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

    Сохраните изменения и попробуйте создать заявку на сайте еще раз. Если она не появится в списке отправленных заявок, обратитесь за помощью с своему хостинг-провайдеру с вопросом, почему не отправляются данные на адреса https://cloud.roistat.com/api/proxy/1.0/leads/add и http://cloud-reserved.roistat.com/api/proxy/1.0/leads/add

  2. Проверьте, что в скрипте нет синтаксических ошибок. Воспользуйтесь сервисом валидации кода.

 Заявка с сайта есть в списке отправленных заявок, но нет в CRM

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

  1. Не настроена интеграция с CRM или к ней нет доступа
  2. Недостаточно прав на создание сделок в CRM
  3. В CRM есть обязательные поля, которые не заполняются при отправке заявки

Что делать:

  1. Проверьте, что правильно указали данные на странице настроек интеграции ( Каталог интеграций → Настройки подключенной интеграции ). Если все правильно, статус интеграции будет Активные

  2. Проверьте, что у вашего аккаунта CRM имеются права на создание сделок

    1. Если в CRM есть обязательные поля, которые не нужно передавать в скрипте отправки данных, сделайте эти поля необязательными.
    2. Если такие поля всегда должны заполняться, добавьте их в скрипт и присвойте им значение.

(info) Если что-то не получается, напишите в службу поддержки.

  • No labels