Перейти к содержанию

Интеграция Roistat с EnvyCRM

Внимание!

Перед интеграцией необходимо установить счетчик Roistat!

Внимание!

Дата создания сделки в EnvyCRM берется из лида. Например, если лид был создан 1 декабря и конвертирован в сделку 10 декабря, то датой создания сделки будет 1 декабря.

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

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

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

Загрузка данных из EnvyCRM

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

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

Внимание!

Дополнительное поле обязательно должно иметь название roistat, иначе интеграция работать не будет.

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

Внимание!

Если по каким-либо причинам вы создаете сделку вручную (например, для оффлайн-источников), вы можете заполнить поле roistat данными об источнике сделки. Тогда информация об источнике сделки будет отображена в Аналитике.

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

  • yamarket{ID}, если хотите отнести сделку к каналу Яндекс.Маркет. Здесь и далее ID - идентификатор рекламного канала. Например, yamarket1. Например, 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. Подключите EnvyCRM в каталоге интеграций

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

  2. В блоке CRM выберите Envybox и нажмите кнопку Настроить интеграцию.

  3. Заполните поля для авторизации в EnvyCRM :
    1. Введите поддомен вашей CRM. Например, test-domain, если URL проекта https://test-domain.envycrm.com.
    2. Ведите API-ключ для  EnvyCRM .

Как узнать API-ключ EnvyCRM

В личном кабинете EnvyCRM октройте Настройки → Интеграция → API и нажмите Получить ключ API. Отобразится API-ключ для интеграции с EnvyCRM: 3.jpg

  1. Нажмите Сохранить. Загрузятся статусы сделок из EnvyCRM.

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

  3. Нажмите Продолжить.
  4. Укажите параметры для расширенной настройки: Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей. Нажмите Сохранить.
  5. В поле Ответственные за заявки введите через запятую идентификаторы менеджеров. С помощью этого списка Roistat автоматически распределяет сделки по указанным менеджерам.

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

    • В личном кабинете EnvyCRM откройте Настройки→ Общие → Сотрудники.
    • В инструментах веб-разработки вашего браузера вызовите инспектор DOM и стилей. Если инструменты веб-разработки отсутствуют, установите соответствующее расширение для вашего браузера.
    • Сделайте поиск по имени сотрудника и в коде над именем сотрудника найдите строку li class="tile user-graggable" data-user-id="ID сотрудника" 4.jpg. Если кроме администратора в списке нет ни одного сотрудника, вы не найдете строку li class="tile user-graggable" data-user-id="ID сотрудника".
    • Скопируйте числа после data-user-id.
  6. Нажмите Сохранить.

Как заполнять дополнительные поля в EnvyCRM при создании сделки?

Дополнительные поля в EnvyCRM могут быть заполнены: 

В таблицах ниже указаны имена полей, их значения и системные названия.

Поля, которые поддерживаются системой envyCRM по умолчанию

Идентификатор воронки

Создает сделку в определенной воронке. Системное название (id поля) - pipeline_uid.

Тип входящего обращения

Создает сделку с определенным типом входящего обращения. Системное название (id поля) - inbox_types.

Также в EnvyCRM можно заполнять поля со следующими UTM-метками:

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

Дата создания сделки, конвертированной из лида, должна быть такой же, как и дата создания лида.

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

  1. Создайте заявку на сайте.
  2. В проекте Roistat откройте Каталог интеграций.
  3. В блоке Сейчас подключено на виджете настроенной интеграции с EnvyCRM нажмите кнопку Настроить.
  4. В окне настройки интеграции пройдите по ссылке Список отправленных заявок и найдите созданную заявку: 5.png
  5. Проверьте, что в поле Промокод указан номер визита.
  6. Проверьте статус отправки заявки: в поле Отправлен должен появиться успешный статус отправки 6.png, а в CRM - новая заявка с номером визита.            

Внимание!

Если в CRM есть лид и сделка, то Roistat подгружает и лид, и сделку. 

После настройки интеграции рекомендуем воспользоваться следующими вспомогательными инструментами: