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

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

При оформлении заявки на сайте автоматически создается новый лид в CRM (в рамках интеграции нет возможности автоматически создать сделку), в который передается номер визита из куки браузера roistat_visit в дополнительное поле с именем roistat. 

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

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

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

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

Отправка данных в CRM¶

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

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

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

1. Если лид еще не сконвертирован в сделку, он будет выгружен как заявка в Roistat. В аналитике будут отображаться дополнительные поля и статус лида. ID заявки будет иметь следующий вид: lead_{id}, например, lead_123.
2. Если лид был напрямую сконвертирован в сделку, то сделка будет выгружена как заявка в Roistat. В аналитике будут отображаться дополнительные поля сделки и лида, а также статус сделки. ID заявки будет иметь следующий вид: lead_{id}, например, lead_123.
3. Если лид был сконвертирован в контакт, а на основании контакта была создана сделка. Причем сделка не имеет заполненного поля 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¶

1. Добавьте пользовательское поле roistat в сущностях Лид и Сделка:
2. В настройках проекта в Битрикс24 откройте CRM→ Настройки → Настройки форм и отчетов → Пользовательские поля.
3. Для сущности Лид нажмите Добавить поле. Откроется страница Основные настройки поля.
4. В поле Название введите roistat.
5. В раскрывающемся списке Тип выберите Строка.
6. Нажмите Сохранить.

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

8. 

Чтобы отнести сделку к определенному рекламному каналу, вводите в поле roistat следующие маркеры:

• yamarket{ID}, если хотите отнести сделку к каналу Яндекс.Маркет. Здесь и далее ID - идентификатор рекламного канала. Например, yamarket1.
• direct{ID}, если хотите отнести сделку к каналу Яндекс.Директ. Например, direct2.
• google{ID}, если хотите отнести сделку к каналу Google Adwords. Например, google3.
• merchant{ID}, если хотите отнести сделку к каналу Google Merchant Center. Например, merchant4.
• vk{ID}, если хотите отнести сделку к каналу ВКонтакте. Например, vk5.
• facebook{ID}, если хотите отнести сделку к каналу Facebook. Например, facebook6.
• mytarget{ID}, если хотите отнести сделку к каналу myTarget.
• seo_yandex, если хотите отнести сделку к каналу SEO - Яндекс.
• seo_google, если хотите отнести сделку к каналу SEO - Google.

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

Подключение интеграции с Битрикс24 в каталоге интеграций¶

1. Откройте Каталог интеграций.

2. В блоке CRM выберите Битрикс24 (в описании должно содержаться "Интеграция позволит работать с сущностями "Лиды" и "Сделки" в Битрикс24") и нажмите Настройки интеграции.

Настройка авторизации с CRM-системой¶

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

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

   Внимание!

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

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

   Внимание!

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

3. В Roistat нажмите *Авторизовать приложение *для сохранения параметров авторизации в Битрикс24.

Распределение статусов из CRM-системы¶

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

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

1. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.

2. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей. 

3. Если вы хотите передавать данные об источнике в сквозную аналитику Битрикс24, перетащите вправо ползунок Передавать данные в сквозную аналитику.

4. Если вы хотите брать дату продажи из сделки в CRM, перетащите вправо ползунок Использовать дату продажи из CRM.

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

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

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

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

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

   1. В проекте Битрикс24 откройте разделСотрудники в левой части экрана и перейдите во вкладку Сотрудники.
   2. В нужной группе выберите сотрудника, идентификатор которого вы хотите узнать.
   3. Рядом с именем выбранного сотрудника нажмите Редактировать: Откроется страница настроек профиля сотрудника.
   4. В адресной строке браузера после "user/" отображается идентификатор сотрудника:

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

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

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

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

По умолчанию используются контакты. Для загрузки компаний, как клиентов, включите настройку на этой странице.

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

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

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

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

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

   

2. В интерфейсе Битрикс24 перейдите в раздел Разработчикам → Другое → Исходящий вебхук. Вставьте скопированный адрес в поле URL вашего обработчика. В поле События добавьте Создание сделки, Обновление сделки, Создание лида и Обновление лида. Нажмите Сохранить:

   

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

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

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

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

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