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

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

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

1. Пользователь заходит на сайт.

2. Звонит по номеру CoMagic / пишет сообщение в онлайн-чат / оставляет заявку в оффлайн-форме.

3. Звонок фиксируется в кабинете CoMagic.

4. Моментально звонок отображается и в вашем проекте в Roistat на странице Коллтрекинг → История звонков и при этом привязывается к сессии пользователя:

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

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

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

2. Если звонок завершился успешно, то в Истории звонков в Roistat появляется запись разговора; в обратном случае запись будет недоступна.

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

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

Настройка¶

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

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

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

2. Скопируйте скрипт из пункта 1.Подключение скрипта.

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

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

1. В кабинете CoMagic перейдите в раздел Уведомления на вкладку Уведомления 2.0 (beta).
2. В этом разделе нужно будет добавить 2 уведомления: для отправки данных о входящем звонке и для отправки записанного разговора\ Уведомления создаются по одной схеме (см. ниже).
3. Нажмите кнопку Добавить уведомление.

4. На открывшейся странице настроек укажите следующие параметры:

5. Название уведомления - можно указать любое название, например Входящий звонок Comagic.

6. Тип события - одно уведомление с типом Входящий звонок на виртуальный номер, другое - с типом Завершение звонка.

7. Способы уведомлений - HTTP:

8. Метод - GET.

9. URL - URL-адрес webhook для пересылки данных. Его нужно скопировать из проекта Roistat Каталог интеграций → Comagic → 2. Инструкция по настройке → Webhook URL.

10. Тело - тело запроса с параметрами звонка. Оно указывается следующим образом:

11. нажмите кнопку Вернуть шаблон по умолчанию рядом с полем Тело.

12. скопируйте строку с кодом из проекта Roistat Каталог интеграций → Comagic → 2. Инструкция по настройке → поле с кодом.

13. и добавьте эту строку в конец тела запроса.

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

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

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

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

1. В кабинете CoMagic перейдите в раздел Уведомления на вкладку Уведомления 2.0 (beta).
2. В этом разделе нужно будет добавить уведомление: завершение чата. Уведомления создаются по одной схеме (см. ниже).
3. Нажмите кнопку Добавить уведомление.

4. На открывшейся странице настроек укажите следующие параметры: 

5. Название уведомления - можно указать любое название, например Оналайн-чат Comagic.

6. Тип события - завершение чата.

7. Способы уведомлений - HTTP:

8. Метод - GET.

9. URL - URL-адрес webhook для пересылки данных. Его нужно скопировать из проекта Roistat → Каталог интеграций → Comagic → 2. Инструкция по настройке → Webhook URL.

10. Тело - тело запроса с параметрами звонка. Оно указывается следующим образом:

11. нажмите кнопку Вернуть шаблон по умолчанию рядом с полем Тело.

12. скопируйте строку с кодом из проекта Roistat Каталог интеграций → Comagic → 2. Инструкция по настройке → поле с кодом.

13. и добавьте эту строку в конец тела запроса.

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

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

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

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

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

1. В кабинете CoMagic перейдите в раздел Уведомления на вкладку Уведомления 2.0 (beta).
2. В этом разделе нужно будет добавить уведомление: оффлайн заявка. Уведомления создаются по одной схеме (см. ниже).
3. Нажмите кнопку Добавить уведомление.

4. На открывшейся странице настроек укажите следующие параметры:

5. Название уведомления - можно указать любое название, например Оналайн-чат Comagic.

6. Тип события - завершение чата.

7. Способы уведомлений - HTTP:

8. Метод - GET.

9. URL - URL-адрес webhook для пересылки данных. Его нужно скопировать из проекта Roistat → Каталог интеграций → Comagic → 2. Инструкция по настройке → Webhook URL.

10. Тело - тело запроса с параметрами звонка. Оно указывается следующим образом:

11. нажмите кнопку Вернуть шаблон по умолчанию рядом с полем Тело.

12. скопируйте строку с кодом из проекта Roistat Каталог интеграций → Comagic → 2. Инструкция по настройке → поле с кодом.

13. и добавьте эту строку в конец тела запроса.

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

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

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