Интеграция коллтрекнга 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. Проверьте, чтобы они были включены.