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

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

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

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

Если заявка не была помечена как дубль, то:

1. Осуществляется поиск контактов (по всем контактам в CRM системе) по номеру телефона или e-mail адресу.
2. Если контакт найден, то создается привязанная к нему новая сделка. Если контакт не найден, создается новый контакт и новая сделка.

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

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

Чтобы отнести сделку к определенному рекламному каналу, вводите в поле 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 вы не находите его, напишите нам, мы поможем.

   1. Нажмите Установить.

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

      

   Внимание!

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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'``] : ``"неизвестно"``;`

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

При создании какой-либо заявки клиентом на сайте в Битрикс24 должна создаваться новая сделка с заполненным полем roistat. Сделки также отображаются и в Roistat:

1. В проекте Roistat откройте Каталог интеграций.
2. В блоке Сейчас подключено найдите настроенную интеграцию и нажмите кнопку Настроить.
3. В окне настройки интеграции перейдите по ссылке Список отправленных заявок.