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

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

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

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

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

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

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

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

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

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

Если к лиду привязано несколько сделок в CRM, то первая из них будет загружена в Roistat как lead_{ID}, а последующие – как deal_{ID}.

Если сделка в CRM не привязана к лиду, она будет загружена как deal_{ID}.

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

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

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

  1. В личном кабинете EnvyCRM откройте Настройки → Сделка → Поля:

    1.jpg

  2. Нажмите Добавить поле. Откроется страница настроек нового поля.

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

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

  5. Установите флажок Показывать в окне добавления нового клиента.

  6. Установите флажок Показывать в разделе "Входящие".

  7. Остальные параметры оставьте неизменными.

    2.jpg

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

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

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

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

Шаг 2. Подключите EnvyCRM в каталоге интеграций

  1. В проекте Roistat откройте раздел Интеграции.

  2. Нажмите Добавить интеграцию. В поисковой строке введите Envybox, кликните по карточке интеграции и нажмите Добавить:

    2-1.png

    Затем нажмите Настроить интеграцию:

    2-2.png

  3. Заполните поля для авторизации в EnvyCRM:

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

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

    3.jpg

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

  5. Перетаскивая статусы сделок, распределите их по группам (подробнее – в статье Распределение статусов сделок). Нажмите Продолжить.

  6. Ознакомьтесь с инструкцией по включению отправки заявок. Затем нажмите Следующий шаг.

  7. В разделе Расширенные настройки вы можете:

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

  8. Кликните по полю Ответственные за заявки и выберите сотрудников из списка. Roistat автоматически распределяет сделки по указанным менеджерам. Нажмите Сохранить, чтобы применить изменения.

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

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

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

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

Система EnvyCRM по умолчанию поддерживает следующие поля:

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

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

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

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

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

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

  1. Создайте заявку на сайте.

  2. В проекте Roistat перейдите в раздел Состояние проекта → Список отправленных заявок и найдите созданную заявку:

    5.png

  3. Проверьте, что в поле Промокод указан номер визита.

  4. Проверьте статус отправки заявки: в поле Отправлен должен появиться успешный статус отправки 6.png, а в CRM – новая заявка с номером визита.

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

  1. Правообладателем Facebook является запрещенная на территории РФ компания Meta Platforms, признанная судом экстремистской. ↩