Интеграция Битрикс24 (лиды + сделки)¶

Как работает интеграция¶

Когда клиент оставляет заявку на сайте, в Битрикс24 автоматически создается новый лид (в данной интеграции нет возможности автоматически создать сделку). В лид передается номер визита из куки браузера roistat_visit в дополнительное поле с именем roistat.

Если менеджер принимает заказ по телефону, он может спросить промокод (настраивается отдельно) и ввести этот код в поле roistat.

Если значение из поля roistat будет случайно удалено, то при загрузке заявок (лидов и сделок) Roistat самостоятельно определит источник обращения, чтобы сделка попала в нужный рекламный канал.

Отправка заявки в CRM¶

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

При отправке заявки номер телефона передается в поле Телефон. 

Отправка данных из Roistat в Битрикс24¶

Roistat передает в аналитику Битрикс24 следующие данные:

• данные об устройстве, с которого клиент совершил визит на сайт
• utm_source
• utm_medium
• utm_campaign
• utm_content
• utm_term

Загрузка данных из Битрикс24 в Roistat¶

1. Если лид еще не сконвертирован в сделку, он будет выгружен как заявка в Roistat. В аналитике будут отображаться дополнительные поля и статус лида. ID заявки будет иметь следующий вид: lead_{id}, например, lead_123.

2. Если лид был напрямую сконвертирован в сделку, то сделка будет выгружена как заявка в Roistat. В аналитике будут отображаться дополнительные поля сделки и лида, а также статус сделки. ID заявки будет иметь следующий вид: lead_{id}, например, lead_123.

3. Если лид был сконвертирован в контакт, а на основании контакта была создана сделка без заполненного поля roistat:

   • Roistat проверит, не относится ли сделка к лиду, созданному ранее.
   • Если есть связь с лидом, созданным ранее, сделка и лид (в том числе, источник) будут связаны.
   • Если нет связи с лидами, созданными ранее, сделка будет выгружена как новая заявка в Roistat.
   • В аналитике будут отображаться дополнительные поля сделки и лида, а также статус сделки. ID заявки будет иметь следующий вид: lead_{id}, например, lead_123.

4. Если лид был сконвертирован в контакт, а на основании контакта была создана сделка с заполненным полем roistat:

   • Сделка будет выгружена как новая заявка в Roistat.
   • В аналитике будут отображаться дополнительные поля сделки, а также статус сделки. ID заявки будет иметь следующий вид: deal_{id}, например, deal_123.

5. Если сделка была создана вручную или иным способом кроме описанных выше, то она будет выгружена как заявка в Roistat. В аналитике будут отображаться дополнительные поля сделки, а также статус сделки. ID заявки будет иметь следующий вид: deal_{id}, например, deal_123.

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

   Имя клиента, Контактный телефон и Контактный email загружаются в Roistat из данных о клиенте.

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

Шаг 1. Добавьте дополнительное поле roistat¶

Чтобы добавить пользовательское поле roistat в сущностях Лид и Сделка:

1. В настройках проекта в Битрикс24 откройте CRM → Настройки → Настройки форм и отчетов → Пользовательские поля:

   

2. Для сущности Лид нажмите Добавить поле. Откроется страница Основные настройки поля:

   

3. В поле Название введите roistat.

4. В раскрывающемся списке Тип выберите Строка.

5. Нажмите Сохранить.

6. Для сущности Сделка повторите пункты 2 - 5.

Шаг 2. Настройте интеграцию с Битрикс24 в Roistat¶

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

1. Установите счетчик Roistat на все страницы вашего сайта по инструкции.

2. Откройте раздел Интеграции.

3. Нажмите Добавить интеграцию. В появившемся окне в блоке Каталог CRM/CMS кликните по карточке Битрикс24 (Лиды + Сделки) и нажмите Добавить:

   

4. Нажмите Настроить интеграцию (иконка шестеренки):

   

Настройка авторизации в Битрикс24¶

1. В поле слева от кнопки Авторизовать приложение введите URL-адрес вашего проекта в Битрикс24. Обычно он выглядит так: https://<название проекта>.bitrix24.

2. Нажмите Установить приложение. В вашем профиле в Битрикс24 откроется страница с информацией о приложении для интеграции с Roistat.

   Если окно с информацией о приложении для интеграции Roistat не открывается, и вы не можете найти его в Marketplace, напишите нам, и мы поможем.

   Нажмите Установить. Затем установите флажки Я ознакомлен и согласен с лицензионным соглашением и Я ознакомлен и согласен с политикой конфиденциальности и снова нажмите Установить:

   

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

   Для установки приложения у вашей учетной записи в Битрикс24 должны быть права администратора.

3. В Roistat нажмите Авторизовать приложение, чтобы сохранить параметры авторизации в Битрикс24.

Распределение статусов из Битрикс24¶

На шаге Распределение статусов распределите статусы сделок по группам, перетаскивая их в нужные блоки. Подробнее об этом читайте в статье Распределение статусов сделок.

Расширенные настройки интеграции¶

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

• Указать параметры для фильтрации сделок. Подробнее – в статье Фильтрация сделок.

• Указать значения полей бизнес-показателей. Подробнее – в статье Поля бизнес-показателей. 

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

• Настроить передачу данных об источнике в сквозную аналитику Битрикс24. Для этого включите опцию Передавать данные в сквозную аналитику. Обратите внимание: Roistat не загружает данные из поля Сквозная аналитика.

• Включить использование даты продажи сделки из CRM. Для этого перетащите вправо ползунок Использовать дату продажи из CRM.

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

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

Создание задач¶

На шаге Создание задач вы можете настроить автоматическое создание задачи при создании сделки:

1. Активируйте переключатель Создавать задачи при создании сделки.

2. Заполните поля:

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

4. Текст задачи – описание, которое нужно автоматически добавлять к задаче.

5. Заголовок задачи – заголовок, который нужно автоматически добавлять к задаче.

6. Постановщик задач – менеджер, от имени которого должны создаваться задачи.

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

Распределение заявок¶

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

В поле Ответственные за заявки выберите менеджеров из выпадающего списка и нажмите Сохранить:

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

Как узнать идентификатор менеджера

1. В проекте Битрикс24 откройте раздел Сотрудники в левой части экрана и перейдите во вкладку Сотрудники.

2. В нужной группе найдите сотрудника, идентификатор которого вы хотите узнать.

3. Нажмите на имя сотрудника:

   

   Откроется страница настроек профиля сотрудника.

4. В адресной строке браузера после user/ отображается идентификатор сотрудника:

   

Работа с клиентами¶

Вы можете загружать из CRM-системы как клиентов:

• Контакты
• Компании

По умолчанию используются контакты. Чтобы загружать компании как клиентов, включите эту опцию на шаге Работа с клиентами.

Если вы хотите привязывать к создаваемому лиду контакт (при его наличии в CRM), включите опцию Связывать лид с контактом. Поиск контакта производится по email и номеру телефона лида.

Работа с отчетом Воронка статусов¶

Отчет Воронка статусов позволяет:

• Отслеживать конверсию заявок между статусами в CRM по каждому рекламному каналу;
• Видеть, сколько времени сделка находилась в том или ином статусе.

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

1. Перейдите в раздел Работа с отчетом Воронка статусов и скопируйте ссылку в поле Webhook URL:

   

2. В интерфейсе Битрикс24 перейдите в раздел Разработчикам → Другое → Исходящий вебхук:

   

3. Вставьте скопированный адрес в поле URL вашего обработчика. В поле События добавьте Создание сделки, Обновление сделки, Создание лида и Обновление лида. Нажмите Сохранить:

   

Шаг 3. Настройте автоматическую отправку сделок в Битрикс24¶

Рекомендуем настроить передачу сделок в CRM через Roistat – механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.

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

Пример кода, с помощью которого можно получить значение этой куки:

$roistatVisitId = array_key_exists('roistat_visit', $_COOKIE) ? $_COOKIE['roistat_visit'] : "неизвестно";

Настройка Товарной аналитики¶

Интеграция Roistat с Битрикс24 позволяет использовать Товарную аналитику – инструмент, с помощью которого можно анализировать эффективность продаж отдельных товаров и групп товаров (брендов, категорий). Товары загружаются в Roistat как из основного списка (CRM → Товары), так и из подкатегорий в разделе Товары.

Чтобы настроить Товарную аналитику:

1. Убедитесь, что в Битрикс24 созданы товары. Для этого в проекте Битрикс24 откройте раздел CRM → Товары:

   

   Чтобы создать товар, нажмите на кнопку Создать товар:

   

   Товар может находиться как в общем разделе Товары, так и в любой подкатегории.

2. В проекте Roistat откройте раздел Аналитика, перейдите на вкладку Товарная аналитика и нажмите Включить товарную аналитику:

   

3. После следующего импорта сделок из CRM информация о товарах начнет отображаться в разделе Аналитика → Отчеты:

   

   Если товары распределены по категориям, в отчете сохранится иерархия:

   

   Также подробная информация о товаре отображается в карточке сделки и в карточке лида:

   

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

Когда клиент оставляет заявку на сайте, в Битрикс24 должен создаваться новый лид с заполненным полем roistat. Лиды также отображаются и в Roistat:

1. В разделе Диагностика проекта → Список отправленных заявок:

   

2. В разделе Аналитика в списке сделок:

   

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

   

   О поле «Направление сделки»

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

   Обратите внимание: даже если вы изменили наименование стандартного направления сделки (Общее) на собственное, в Roistat в поле Направление сделки будет отображаться название Общее. Это связано с техническими ограничениями Битрикс24.