Инструкция по подключению UIS/CoMagic

• Настройка интеграции между 1С:CRM и UIS/CoMagic в блоке сквозной аналитики
• Регистрация Web-сервиса softphoneCoMagic
• Создание Источника получения заявок
• Подключение интеграции с 1С:CRM в UIS/CoMagic
• Настройка доп. реквизитов и статусов сделок в 1C:CRM
• Просмотр списка звонков

Настройка интеграции между 1С:CRM и UIS/CoMagic в блоке сквозной аналитики

На данном этапе подразумевается, что интеграция между сайтом и UIS/CoMagiс выполнена. Настройка выполняется системным администратором, веб-разработчиком или специалистом UIS/CoMagic.

Для настойки понадобятся:

• Терминальный доступ на компьютер, где находится база «1С», а также веб-сервер (опционально), права на изменение настроек веб-сервера и файлов настроек сервисов.
• Доступ в базу CRM  и к конфигуратору с административными правами.
• Доступ в аккаунт UIS/CoMagic с административными правами.

Регистрация Web-сервиса softphoneCoMagic

На момент настройки Web-сервис softphoneCoMagic должен быть уже опубликован и настроен по инструкции. Обычно этим занимается системный администратор клиента или приглашенный специалист.

Установка и настройка веб-сервера, необходимая для публикации, описана в статье Публикация сервисов 1С:CRM.

Инструкция по публикации web-сервиса описана в разделе Интеграция с UIS/CoMagic.

Рекомендуется сразу включить возможность отладки опубликованного сервиса при помощи тега «debug»:

Пример файла настроек:

<?xml  version="1.0" encoding="UTF-8"?>
<point  xmlns="http://v8.1c.ru/8.2/virtual-resource-system"
           xmlns:xs="http://www.w3.org/2001/XMLSchema"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           base="/crm_softphoneCoMagic"
           ib="Srvr=&quot;<имясервера>&quot;;Ref=&quot;norma&quot;;Usr=httpService;Pwd=&quot;Rhp5931QwL&quot;"
           enable="false">
<ws>
           <point  name="softphoneCoMagic"
                             alias="CoMagic.1cws"
                             enable="true"
                             reuseSessions="autouse"
                             sessionMaxAge="20"
                             poolSize="10"
                             poolTimeout="5"/>
</ws>
<debug enable="true" url="tcp://<имя сервера>:<порт при необходимости>"/>
</point>

Адрес сервиса прописывается в настройках источника получения заявков (создание источника описано ниже):

Если все настроено корректно, то, введя в браузере в строку адреса путь до web-сервиса, на экране должна отобразиться wsdl-схема сервиса без запроса авторизации. Например:

АРМ Сквозная аналитика рекомендуется сразу вынести на Рабочий стол:

В «1С:CRM» основным интерфейсом является универсальный Рабочий стол. Для подключения рабочего места «Сквозная аналитика» необходимо зайти в настройки универсального рабочего стола и выбрать форму «Сквозная аналитика», как показано ниже:

Подключение рабочего места «Сквозная аналитика»

Подключение рабочего места «Сквозная аналитика»

Рабочее место можно подключить как индивидуально для пользователя, так и для всех пользователей решения. Для это необходимо выбрать один из вариантов применения подключения: «Общие | Подразделения | Пользователи».

Применение подключения к группе пользователей

Создание Источника получения заявок

Добавьте новый источник заявок: откройте список Клиенты → Справочники и настройки → Заявки → Источники получения заявок и выполните команду «Создать».

Второй способ — в АРМ «Сквозная аналитика» выполнить команду «Настройка источников»:

На форме нового Источника заявок выберите вариант Call-трекинг и тип источника «UIS» или «CoMagic»:

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

Укажите в соответствующих полях логин и пароль от личного кабинета UIS/CoMagic.

Ключ доступа будет получен позже, пока оставляем поле пустым.

Необходимо включить режим «Использовать звонки». При этом, если интеграция с телефонией настроена, будет отображаться индикатор зеленого цвета, а если интеграция с телефонией не подключена - красный:

Светофор настройки интеграции с телефонией

Введите адрес публикации сервиса в формате: http(s)://ИмяСервера:порт/ИмяПубликации. Где <ИмяСервера> — имя или IP-адрес сервера на котором опубликованы сервисы, <порт> — порт сервера на котором опубликованы сервисы, <ИмяПубликации> — имя публикации сервисов.

После ввода адреса публикации сервисов, адрес публикации web-сервиса softphoneCoMagic будет автоматически заполнен:

Обмен данными с сервисов UIS/CoMagic происходит со стороны 1C:CRM, поэтому необходимо настроить расписание  — периодичность, с которой будет происходить обмен данными. На скриншоте настроен обмен как «каждый день каждые 3600 секунд» (то есть раз в час).

После того, как создан Источник получения заявок и опубликован web-сервис «softphoneCoMagic», можно приступить к настройке интеграции с 1С:CRM в рабочем кабинете UIS/CoMagiс.

Подключение интеграции с 1С:CRM в UIS/CoMagic

Заходим в рабочий кабинет UIS/CoMagiс и выбираем в меню с именем пользователя пункт «Аккаунт»:

Далее в меню выбираем раздел «Интеграция», выбираем интеграцию с «1С-Рарус» и нажимаем кнопку «Подключить»:

В открывшейся форме настройки указываем необходимые данные:

Web-адрес вашей CRM — указываем путь к опубликованному ранее веб-сервису «softphoneCoMagic», с указанием строки «?wsdl» (для доступа к wsdl-схеме сервиса). Напомним, что эта строка уже прописана в 1C:CRM в Источнике получения заявок:

Чтобы убедиться, что настройки корректны и UIS/Comagic имеет доступ к опубликованному web-сервису, нажмите в форме настройки интеграции на сайте  кнопку «Проверить»: 

Если все настроено корректно, будет написано, что соединение «Активно»:

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

Популярные проблемы:

• Публикация выполнена без анонимного доступа, то есть логин и пароль не указаны явно в файле публикации default.vrd. Это необходимо, иначе сервис будет требовать авторизацию (см. инструкцию по публикации).
• Пусть к сервису указан не полностью, например без окончания «?wsdl».
• Есть проблемы с сетевым доступом «из-вне», необходимо привлечение системного администратора.

Далее необходимо включить настройки «Передача данных коллтрекинга» и «Подключение 1С-Рарус СофтФон»:

Сгенерированный ключ доступа необходимо скопировать и вставить в соответствующее поле в Источнике получения заявок:

Для завершения настройки на сайте UIS/Comagic нажимаем «Сохранить», все данные будут сохранены в системе. Также будет создан служебный пользователь «1c_rarus_native»:

Настройка доп. реквизитов и статусов сделок в 1C:CRM

Для корректного обмена данными с UIS/CoMagic в1С:CRM должны быть созданы или введены  определенные данные:

• Служебные доп. реквизиты для хранения идентификаторов Заявок и Маркетинговых кампаний в 1C:CRM.
• Теги в кабинете UIS/CoMagic.

Служебные доп. реквизиты для хранения идентификаторов создаются в момент включения настройки «Использовать сквозную аналитику». Рекомендуется на всякий случай снять данный флаг и заново его установить - если база создана давно и идентификаторы не были ранее созданы, они появятся:

При интеграции UIS/CoMagic с 1C:CRM  теги используются для указания статусов заявок (звонков). Используются три статуса:

• В работе.
• Отмененные.
• Продажа (данный тег есть в системе по умолчанию).

Статусы меняются программно, в зависимости от состояния Заявок или введенных на их основании Интересов. Более подробно про соответствие статусов описано в статье  «Интеграция с системами коллтрекинга».

На текущий момент интеграция не поддерживает возможность программно создать теги, поэтому необходимо в кабинете UIS/CoMagic зайти в раздел Теги и вручную ввести теги «В работе» и «Отмененные»:

После настройки тегов нужно убедиться, что автоматически созданное регламентное задание работает и не выдает ошибок. Обычно оно называется «Лидогенерация Comagic. источник : Comagic» или как то похоже (зависит от названия источника).

Просмотр списка звонков

Звонки удобно смотреть через раздел «Список обращений — Звонки»:

Если в колонке «Теги» присутствуют теги «В работе», «Продажа» или «Отмененные»» — это означает, что звонок был получен в CRM и заявка обрабатывается или созданный Интерес завершен удачно или не удачно.

В списке звонков дополнительно можно вывести информацию о сумме и дате сделки. Для этого нужно зайти в «Общие настройки сайта» и включить флаг «Учитывать продажи»:

Активация настройки «Учитывать продажи»

После этого в списке звонков появятся новые колонки: