Интеграция коллтрекнга CoMagic с Roistat¶

Если вы отслеживаете звонки через сервис коллтрекинга CoMagic, у вас есть возможность сохранять записи о звонках в проекте в Roistat, а также создавать по ним сделки и передавать их в подключенную CRM.

Общая схема работы интеграции:¶

Пользователь заходит на сайт.
Звонит по номеру *CoMagic */ пишет сообщение в онлайн-чат / оставляет заявку в оффлайн-форме.
Звонок фиксируется в кабинете CoMagic.
Моментально звонок отображается и в вашем проекте в Roistat на странице Коллтрекинг → История звонков и при этом привязывается к сессии пользователя:

Обратите внимание, что в Roistat выгружаются не все звонки, а только те, которые совершаются уже после активации интеграции.

Внимание!

Из-за технических ограничений интеграции, статус звонка не передается из Comagic в Roistat. Все звонки в "истории звонков" зафиксированы, как пропущенные.

Для уникального звонка создается заявка в Roistat на странице Каталог интеграций → [CRM] → Список отправленных заявок.

Внимание!

Заявка создается не для каждого звонка, а только для уникального. Например, в Историю звонков был загружен звонок с уникальным набором параметров. Для него будет создана заявка в Списке отправленных заявок. Допустим, после этого в историю будет загружен звонок с точно таким же набором параметров. Для него заявка уже не будет создана. Таким образом, заявки не дублируются.

Сделка по общению в онлайн-чате создается после завершения диалога оператором.

Если проект в Roistat связан с CRM, то для этой заявки автоматически создается сделка. Подробнее читайте в статьях Загрузка заявок в Roistat и Смена CRM.
Если звонок завершился успешно, то в Истории звонков в Roistat появляется запись разговора; в обратном случае запись будет недоступна.

Звонки учитываются в отчетах Коллтрекинга и Аналитики, связываясь с посещениями пользователей через наш номер визита из cookie roistat_visit и получая статистику из подключенной CRM.

Кроме того, из CRM загружаются соответствующие клиенты в раздел Управление клиентами.

Внимание!

После интеграции в диагностике неисправностей появится уведомление "Метод onroistatModuleLoaded встречается более одного раза.". Это связано с особенностью интеграции, работоспособность системы не нарушится.

Внимание!

Интеграция Roistat поддерживает виджет обратного звонка CoMagic, однако заявка будет создана только в том случае, когда обратный звонок состоялся.

Настройка¶

Внимание!

Обратите внимание, что перед настройкой этой интеграции на сайте должны быть установлены счетчики Roistat и CoMagic. Проверьте, чтобы они оба были указаны внутри тега (порядок расположения значения не имеет).

Шаг 1. Установка скрипта на сайт¶

Чтобы связывать звонки с номерами визитов из счетчика Roistat, в коде нужных страниц вашего сайта необходимо установить специальный скрипт.

В проекте в Roistat зайдите в раздел Каталог интеграций и откройте настройки интеграции CoMagic
Скопируйте скрипт из пункта 1.Подключение скрипта.

Список полей загружается из подключенной к проекту Roistat CRM. 3. В поле ниже введите значение дополнительного поля сделки в виде текста или переменной. 4. Нажмите Сохранить.

Шаг 2. Настройка уведомлений о звонках¶

Чтобы звонки из кабинета CoMagic выгружались в проект Roistat, необходимо настроить отправку специальных уведомлений.

В кабинете CoMagic перейдите в раздел Уведомления на вкладку Уведомления 2.0 (beta).
В этом разделе нужно будет добавить 2 уведомления: для отправки данных о входящем звонке и для отправки записанного разговора\ Уведомления создаются по одной схеме (см. ниже).
Нажмите кнопку Добавить уведомление.
На открывшейся странице настроек укажите следующие параметры:
Название уведомления - можно указать любое название, например Входящий звонок Comagic.
Тип события - одно уведомление с типом Входящий звонок на виртуальный номер, другое - с типом Завершение звонка.
Способы уведомлений - HTTP:
Метод - GET.
URL - URL-адрес webhook для пересылки данных. Его нужно скопировать из проекта Roistat Каталог интеграций → Comagic → 2. Инструкция по настройке → Webhook URL.
Тело - тело запроса с параметрами звонка. Оно указывается следующим образом:
нажмите кнопку Вернуть шаблон по умолчанию рядом с полем Тело.
скопируйте строку с кодом из проекта Roistat Каталог интеграций → Comagic → 2. Инструкция по настройке → поле с кодом.
и добавьте эту строку в конец тела запроса.

Внимание!

Если не хотите, чтобы Roistat создавал заявки в CRM, то в конец запроса добавьте &save_to_crm=0.

Внимание!

Настроить интеграцию можно со всеми аккаунтами внутри одного личного кабинета CoMagic. Для этого выполните настройку уведомлений по всем аккаунтам.

Сохраните созданные уведомления.
Проверьте, чтобы они были включены.

Шаг 3. Настройка уведомлений о завершении онлайн-чата¶

Чтобы заявки через онлайн-чат из кабинета CoMagic выгружались в проект Roistat, необходимо настроить отправку специальных уведомлений

В кабинете CoMagic перейдите в раздел Уведомления на вкладку Уведомления 2.0 (beta).
В этом разделе нужно будет добавить уведомление: завершение чата. Уведомления создаются по одной схеме (см. ниже).
Нажмите кнопку Добавить уведомление.
На открывшейся странице настроек укажите следующие параметры:
Название уведомления - можно указать любое название, например Онлайн-чат Comagic.
Тип события - завершение чата.
Способы уведомлений - HTTP:
Метод - GET.
URL - URL-адрес webhook для пересылки данных. Его нужно скопировать из проекта Roistat → Каталог интеграций → Comagic → 2. Инструкция по настройке → Webhook URL.
Тело - тело запроса с параметрами звонка. Оно указывается следующим образом:
нажмите кнопку Вернуть шаблон по умолчанию рядом с полем Тело.
скопируйте строку с кодом из проекта Roistat Каталог интеграций → Comagic → 2. Инструкция по настройке → поле с кодом.
и добавьте эту строку в конец тела запроса.
если не хотите, чтобы Roistat создавал заявки в CRM, то в конец запроса добавьте &save_to_crm=0.

Внимание!

Настроить интеграцию можно со всеми аккаунтами внутри одного личного кабинета CoMagic. Для этого выполните настройку уведомлений по всем аккаунтам.

Сохраните созданные уведомления.
Проверьте, чтобы они были включены.

Шаг 4. Настройка уведомлений об отправки оффлайн-заявки¶

Чтобы заявки через оффлайн-форму из кабинета CoMagic выгружались в проект Roistat, необходимо настроить отправку специальных уведомлений.

В кабинете CoMagic перейдите в раздел Уведомления на вкладку Уведомления 2.0 (beta).
В этом разделе нужно будет добавить уведомление: оффлайн заявка. Уведомления создаются по одной схеме (см. ниже).
Нажмите кнопку Добавить уведомление.
На открывшейся странице настроек укажите следующие параметры:
Название уведомления - можно указать любое название, например Онлайн-чат Comagic.
Тип события - завершение чата.
Способы уведомлений - HTTP:
Метод - GET.
URL - URL-адрес webhook для пересылки данных. Его нужно скопировать из проекта Roistat → Каталог интеграций → Comagic → 2. Инструкция по настройке → Webhook URL.
Тело - тело запроса с параметрами звонка. Оно указывается следующим образом:
нажмите кнопку Вернуть шаблон по умолчанию рядом с полем Тело.
скопируйте строку с кодом из проекта Roistat Каталог интеграций → Comagic → 2. Инструкция по настройке → поле с кодом.
и добавьте эту строку в конец тела запроса.
если не хотите, чтобы Roistat создавал заявки в CRM, то в конец запроса добавьте &save_to_crm=0.

Внимание!

Настроить интеграцию можно со всеми аккаунтами внутри одного личного кабинета CoMagic. Для этого выполните настройку уведомлений по всем аккаунтам.

Сохраните созданные уведомления.

6. Проверьте, чтобы они были включены.