Интеграция Roistat с Битрикс24 (сделки)¶
Внимание!
С 1 января 2021 года интеграция с Битрикс24 будет доступна только для пользователей коммерческих тарифов Битрикс24. Узнать больше
Внимание!
Новая интеграция с Битрикс24 (сделки) позволяет загружать информацию из раздела Сделки в Битрикс24. Если вам требуется получать информацию и из раздела Лиды, читайте статью Битрикс24 (лиды + сделки).
Внимание!
Перед интеграцией необходимо установить счетчик Roistat!
Как работает интеграция¶
При оформлении заявки на сайте автоматически создается новый лид в CRM (в рамках интеграции нет возможности автоматически создать сделку), в который передается номер визита из куки браузера roistat_visit в дополнительное поле с именем roistat.
Если значение из поля Roistat будет случайно удалено, то при загрузке заявок (лидов и сделок) Roistat самостоятельно определит источник обращения, чтобы сделка попала в нужный рекламный канал.Если менеджер принимает заказ по телефону, он может спросить промокод (настраивается отдельно)и ввести этот код в поле roistat.
Внимание!
При звонках через коллтрекинг Roistat, в сделку будет передаваться запись звонка, и вы сможете её прослушать.
Отправка заявки в CRM¶
Если заявка не была помечена как дубль, то:
- Осуществляется поиск контактов (по всем контактам в CRM системе) по номеру телефона или e-mail адресу.
- Если контакт найден, то создается привязанная к нему новая сделка. Если контакт не найден, создается новый контакт и новая сделка.
Шаг 1. Добавьте дополнительное поле roistat¶
- Добавьте пользовательское поле roistat в сущности Сделка:
- В настройках проекта в Битрикс24 откройте CRM → Настройки → Настройки форм и отчетов → Пользовательские поля.
- Для сущности Сделка нажмите Добавить поле. Откроется страница Основные настройки поля.
- В поле Название введите roistat.
- В раскрывающемся списке Тип выберите Строка.
- Нажмите Сохранить.
Если по каким-либо причинам вы создаете сделку вручную (например, для оффлайн-источников), вы можете заполнить поле roistat данными об источнике сделки. Тогда информация об источнике сделки будет отображена в Аналитике.
Чтобы отнести сделку к определенному рекламному каналу, вводите в поле 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 в каталоге интеграций¶
- Откройте Каталог интеграций.
- В блоке CRM выберите Битрикс24 (в описании должно содержаться "Интеграция будет создавать "Сделки" в Битрикс24") и нажмите Настроить интеграцию.
Настройка авторизации с CRM-системой¶
-
В поле слева от кнопки Авторизовать приложение введите URL-адрес вашего проекта в Битрикс24. Обычно он выглядит так: https://<название проекта>.bitrix24:
-
Нажмите Установить приложение. В вашем профиле в Битрикс24 откроется страница с информацией о приложении для интеграции с Roistat.
Внимание!
Если окно с информацией о приложении для интеграции Roistat не открывается и в Marketplace вы не находите его, напишите нам, мы поможем.
- Нажмите Установить.
-
Установите флажки Я ознакомлен и согласен с лицензионным соглашением и Я ознакомлен и согласен с политикой конфиденциальности и нажмите Установить:
Внимание!
Для установки приложения у вашей учетной записи в Битрикс24 должны быть права администратора.
-
В Roistat нажмите Авторизовать приложение для сохранения параметров авторизации в Битрикс24.
Распределение статусов из CRM-системы¶
Перетаскивая статусы сделок, распределите их по группам. Подробнее об этом читайте в статье Распределение статусов сделок.
Расширенные настройки интеграции¶
-
Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.
-
Укажите значения полей бизнес-показателей. Подробнее – в статье Поля бизнес-показателей.
-
Если вы хотите передавать данные об источнике в сквозную аналитику Битрикс24, перетащите вправо ползунок Передавать данные в сквозную аналитику.
-
Если вы хотите брать дату продажи из сделки в CRM, перетащите вправо ползунок Использовать дату продажи из CRM.
-
Нажмите кнопку Сохранить.
Распределение заявок¶
Вы можете указать, на каких менеджеров ставить новые заявки в CRM-системе. Менеджеры будут назначаться по порядку.
-
В поле Ответственные за заявки выберите менеджеров из выпадающего списка:
После этого Roistat будет автоматически распределять сделки по указанным менеджерам.
Как узнать идентификатор менеджера
1. В проекте Битрикс24 откройте раздел*Сотрудники* в левой части экрана и перейдите во вкладку Сотрудники. 2. В нужной группе выберите сотрудника, идентификатор которого вы хотите узнать. 3. Рядом с именем выбранного сотрудника нажмите **Редактировать**:  Откроется страница настроек профиля сотрудника. 4. В адресной строке браузера после "user/" отображается идентификатор сотрудника: 
-
Нажмите Сохранить.
Работа с клиентами¶
Вы можете загружать из CRM-системы как клиентов:
- Контакты
- Компании
По умолчанию используются контакты. Для загрузки компаний, как клиентов, включите настройку на этой странице.
Внимание!
Если включена опция Использовать компании как клиентов, то Roistat будет работать только компаниями.
Работа с отчетом Воронка статусов¶
Отчет Воронка статусов позволяет:
- Отслеживать конверсию заявок между статусами в CRM по каждому рекламному каналу;
- Видеть, сколько времени сделка находилась в том или ином статусе.
Для построения отчета используются данные, полученные с помощью специального вебхука.
-
Перейдите в раздел Работа с отчетом Воронка статусов и скопируйте ссылку в поле Webhook URL:
-
В интерфейсе Битрикс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:
- В проекте Roistat откройте Каталог интеграций.
- В блоке Сейчас подключено найдите настроенную интеграцию и нажмите кнопку Настроить.
- В окне настройки интеграции перейдите по ссылке Список отправленных заявок.
После настройки интеграции рекомендуем воспользоваться следующими вспомогательными инструментами: