Интеграция 1С и Comagic. Определение номера звонящего и открытие карточки в 1С

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

• Менеджеры по продажам
• Служба поддержки клиентов
• Маркетологи
• Аналитики
• Колл-центры
   

Преимущества автоматического открытия карточки клиента:

• Экономия времени: Сотрудники не тратят время на поиск информации о клиенте.

• Улучшение сервиса: Клиенты получают более персонализированное обслуживание.

• Повышение конверсии: Менеджеры могут быстрее закрывать сделки, имея под рукой всю необходимую информацию.

• Снижение ошибок: Операторы меньше ошибаются, так как видят историю взаимодействий.

Интеграция 1С и системы Comagic

Для работы нужно включить API Базовый в настройках Comagic. (API для обмена данными. Включает компоненты: dataapi для настройки и получения отчетов и статистики, http-уведомления.
На момент написания статьи, стоимость 890 рублей в месяц.)

1. В личном кабинете Comagic настраиваем уведомление при входящем звонке. 

Заходим в Уведомления - Добавить уведомление. Тип события входящий звонок на виртуальный номер.

{  
 "contact_phone_number":{{contact_phone_number}},
  "notification_name":{{notification_name}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "site_domain_name":{{site_domain_name}},
  "advertising_campaign":{{campaign_name}},
  "contact_info":{  
    "contact_phone_number":{{contact_phone_number}},
    "visitor_id":{{visitor_id}},
    "search_query":{{search_query}},
    "communication_number":{{communication_number}},
    "visitor_is_new":{{visitor_is_new}},
    "search_engine":{{search_engine}}
  },
  "call_session_id":{{call_session_id}}
}

2. Идем в 1С и создаем http сервис, который будем указывать в методе Get  в кабинете Comagic. 

В моем случае это http://IP:port/crmtest1/hs/Comagic/Phone

Я получаю только 4 параметра от звонка
 

Функция GetPhone(Запрос) 
	
	НомерТелефона     = Запрос.ПараметрыЗапроса["contact_phone_number"];
	ВнутреннийНомер   = Запрос.ПараметрыЗапроса["virtual_phone_number"];
	ВремяСобытия 	  = Запрос.ПараметрыЗапроса["notification_time"];   
	РекламнаяКомпания = Запрос.ПараметрыЗапроса["advertising_campaign"];
	
	МенеджерЗаписи = РегистрыСведений.ВходящиеЗвонки.СоздатьМенеджерЗаписи(); 
	МенеджерЗаписи.НомерАбонента = НомерТелефона; 
	МенеджерЗаписи.ТелефонВнутренний = ВнутреннийНомер; 
	МенеджерЗаписи.Время   = ТекущаяДата(); 
	МенеджерЗаписи.Комментарий = "Время события comagic: " + ВремяСобытия + " Рекламная компания: " + РекламнаяКомпания; 
	МенеджерЗаписи.Открыт = Ложь;
	МенеджерЗаписи.Записать();   
	
	ЗаписьЖурналаРегистрации("GetCustomersList", УровеньЖурналаРегистрации.Информация,,,
    "Звонил " + НомерТелефона, РежимТранзакцииЗаписиЖурналаРегистрации.Транзакционная);

		
    //3. формируем ответ
    Ответ = Новый HTTPСервисОтвет(200);
    Ответ.Заголовки.Вставить("Content-type", "application/JSON;  charset=utf-8");
    Ответ.УстановитьТелоИзСтроки("", КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать);
    Возврат Ответ;

КонецФункции

В результате звонок попадает в регистр сведений "ВходящиеЗвонки" дальше можно обработкой показывать звонок менеджеру, который отвечает за этот внутренний номер. Соответствие внутренних номеров задается в личном кабинете Comagic в меню Сценарии. 

3. Новые входящие звонки в регистре сведений разбираем через обработку "ОжиданиеВходящихЗвонков". В ней подключаем обработчик ожидания с интервалом каждую секунду на проверку новых звонков. Как только звонок поступил открывается карточка клиента, если в базе найден номер существующего клиента. В момент пока открыта карточка клиента, проверка новых звонков выключается. Когда менеджер закончил разговор, он заполняет событие и закрывает карточку клиента. В этот момент заново запускаем ожидание новых звонков.

4. Публикуем базу на web сервере. В моем случае я использовал Apache. При публикации не забываем поставить флаг публикации http сервисов.

5. Тестируем

• Проверяем, что база 1С доступна через браузер

• Проверяем из личного кабинета Comagic из уведомления что метод get работает и отправляет данные в 1С, и что 1С корректно их обрабатывает.

Я использовал версию платформы 8.3.25.1501. Конфигурация - самописная CRM.
 

Другие возможности.

Запись звонков в Comagic также можно реализовать с помощью уведомлений.

- Cоздать http сервис в 1С, который принимает ссылку на файл разговора и сохраняет его в регистр сведений.

- Отправка данных о записи звонка на почту.

Я решил протестировать второй вариант. Настраиваем уведомление при завершении звонка и отправляем ссылку record_file_links на почтовый адрес. Далее из 1С можно пробежаться по почтовому ящику получить ссылку на запись и проиграть её. Я выложу новой статьей проигрывание телефонных звонков клиента в 1С.