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

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

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

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

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

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

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

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

    1.png

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

    Внимание!

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

  5. Для уникального звонка создается заявка в Roistat в разделе ИнтеграцииНастроить интеграцию (для подключенной CRM) → Список отправленных заявок:

    2.png

    Внимание!

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

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

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

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

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

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

Внимание!

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

Внимание!

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

Настройка

Внимание!

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

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

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

  1. В проекте Roistat раскройте главное меню в левом верхнем углу и перейдите в раздел Интеграции. Нажмите Добавить интеграцию. В появившемся окне найдите CoMagic, кликните по карточке и нажмите Добавить:

    3.png

    Затем откройте настройки интеграции CoMagic:

    4.png

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

    5.png

  3. Откройте код сайта или конструктор и вставьте скопированный скрипт внутри тега <body></body> на все нужные страницы (порядок расположения скрипта и счетчиков Roistat и CoMagic значения не имеет).

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

Для настройки уведомлений вы можете следовать этой инструкции или использовать инструкцию, описанную в настройках интеграции в разделе Инструкция по настройке.

Уведомления о звонках

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

  1. В кабинете CoMagic перейдите в раздел Уведомления:

    6.png

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

  2. Нажмите кнопку Добавить уведомление:

    7.png

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

    • Название уведомления – можно указать любое название, например, Входящий звонок CoMagic;

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

    • Способы уведомлений – HTTP;

    • Метод – GET;

    • URL – URL-адрес вебхука для пересылки данных. Его нужно скопировать из проекта Roistat в настройках интеграции с CoMagic в разделе Инструкция по настройке:

      8.png

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

      • Нажмите кнопку Вернуть шаблон по умолчанию рядом с полем Тело;
      • Скопируйте строку с кодом из проекта Roistat в настройках интеграции с CoMagic в разделе Инструкция по настройке (для каждого типа уведомления нужно скопировать нужную строку):

        9.png

      • Добавьте эту строку в конец тела запроса:

        10.png

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

    Внимание!

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

  4. Сохраните каждое созданное уведомление, нажав Создать.

  5. Включите уведомления:

    11.png

Уведомления о завершении онлайн-чата

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

Для настройки уведомлений о завершении чата у вас должен быть настроен и включен Онлайн-консультант CoMagic.

  1. В кабинете CoMagic перейдите в раздел Уведомления:

    12.png

  2. Нажмите кнопку Добавить уведомление:

    13.png

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

    • Название уведомления – можно указать любое название, например, Онлайн-чат CoMagic;

    • Тип события – Завершение чата;

    • Способы уведомлений – HTTP;

    • Метод – GET;

    • URL – URL-адрес вебхука для пересылки данных. Его нужно скопировать из проекта Roistat в настройках интеграции с CoMagic в разделе Инструкция по настройке:

      14.png

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

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

      • Скопируйте строку с кодом из проекта Roistat в настройках интеграции с CoMagic в разделе Инструкция по настройке:

        15.png

      • Добавьте эту строку в конец тела запроса:

        16.png

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

    Внимание!

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

  4. Сохраните созданное уведомление, нажав Создать.

  5. Включите уведомление:

    17.png

Уведомления об отправке оффлайн-заявки

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

  1. В кабинете CoMagic перейдите в раздел Уведомления:

    18.png

  2. Нажмите кнопку Добавить уведомление:

    19.png

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

    • Название уведомления - можно указать любое название, например, Оффлайн-заявка;

    • Тип события - Офлайн заявка;

    • Способы уведомлений - HTTP;

    • Метод - GET;

    • URL - URL-адрес вебхука для пересылки данных. Его нужно скопировать из проекта Roistat в настройках интеграции с CoMagic в разделе Инструкция по настройке:

      ![20.png](/img/CoMagic/8.png)
      
    • Тело – тело запроса с параметрами звонка. Оно указывается следующим образом:

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

      • Скопируйте строку с кодом из проекта Roistat в настройках интеграции с CoMagic в разделе Инструкция по настройке:

        21.png

      • Добавьте эту строку в конец тела запроса:

        22.png

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

    Внимание!

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

  4. Сохраните созданное уведомление, нажав Создать.

  5. Включите уведомление:

    23.png

Шаг 3. Настройка поведения

В настройках интеграции с CoMagic в разделе Настройка поведения вы можете:

  • Настроить отправку заявок в CRM:

    24.png

    Если отключить опцию Отправлять заявки в CRM, лиды будут создаваться в списке отправленных заявок, но не будут отправляться в CRM.

  • Настроить отправку звонков в CRM:

    25.png

    Если опция включена, информация по звонкам будет отправляться в подключенную CRM.

  • Создать сценарии отправки заявок:

    26.png

    Сценарий позволяет автоматически создавать заявки в определенном статусе или назначать их на определенного менеджера в зависимости от выбранных условий. Подробнее – в статье Сценарии отправки заявок.

  • Настроить отправку целей в Google Analytics и Яндекс.Метрику:

    27.png

Шаг 4. Настройка дополнительных полей

При необходимости настройте передачу значений в дополнительные поля сделки в CRM:

28.png

  1. Нажмите Добавить поле.

  2. В раскрывающемся списке Выберите поле выберите название дополнительного поля в CRM. 

    Список полей загружается из подключенной к проекту Roistat CRM.

  3. В поле ниже введите значение дополнительного поля сделки в виде текста или переменной.

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