1С + CoMagic

В нашей конфигурации «МедАнгел» (медицинская информационная система) реализована интеграция с сервисом CoMagic, позволяющая:

• совершать исходящие звонки
• отображать входящие звонки
• получать пропущенные звонки
• прослушивать записи разговоров
• отслеживание рекламных компаний

Исходящий вызов
Для совершения исходящего звонка необходимо отправить  GET  или POST запрос на адрес «callapi.comagic.ru». Мы реализовали с помощью POST запроса. В тело запроса передается json вида

{
"id": "e209c793-b062-4d8b-a637-1ef08fab086f",
"method": "start.simple_call",
"jsonrpc": "2.0",
"params": {
"access_token": " КлючАутентификации ",
"first_call": "operator",
"virtual_phone_number": "ВиртуальныйНомер",
"contact": "12",
"operator": "НомерТелефона",
"direction": "out"
}
}

Параметры:
— id – ид исходящего звонка в нашей МИС
— method – имя метода
— access_token – ключ аутентификации. Можно получать двумя способами: или вызвать перед  звонком метод авторизации, который вернет ключ, или в личном кабинете CoMagic настроить статичный ключ.
— first_call – указываем, куда сначала нужно дозвониться
— virtual_phone_number – виртуальный номер, зарегистрированный в CoMagic, с которого будет осуществляться вызов
— contact – номер SIP
— operator – номер телефона, на который нужно дозвониться
— direction – направление звонка

В случае успешного выполнения запроса в синхронном режиме возвращается ответ

{
"jsonrpc": "2.0",
"id": "req1",
"result": {
"data": {
"call_session_id": 237859081
}
}
}

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

В личном кабинете CoMagic есть возможность настроить различные уведомления. В нашем случае это «Соединение» — когда оператор поднимает трубку, приходит уведомление и на экране открывается форма с данными звонка (номер телефона, ФИО пациента, рекламная компания).

Для получения уведомлений был создан http-сервис с POST методом.
Структура уведомления настраивается в личном кабинете CoMagic. В нашем случае json имеет структуру

{
"notification_name":{{notification_name}},           //название уведомления
"external_id":{{external_id}},                       //идентификатор звонка во внешней системе
"contact_phone_number":{{contact_phone_number}},     //номер абонента
"contact_id":{{contact_id}},                         //идентификатор контакта
"employee_full_name":{{employee_full_name}},         //фио сотрудника
"employee_id":{{employee_id}},                       //ид сотрудника
"call_session_id":{{call_session_id}},               //идентификатор звонка
"direction":{{direction}},                           //направление
"campaign_id":{{campaign_id}},                       //ид рекламной компании
"connection_time":{{connection_time}},               //дата время поднятия трубки
"extension_phone_number":{{extension_phone_number}}  //внутренний номер сотрудника
"communication_id":{{communication_id}}              //ид обращения
}

Благодаря параметру «campaign_id»  мы понимаем,  откуда пришел пациент и сохраняем эту информацию для дальнейшего анализа.

Пропущенные звонки

Получить полный журнал звонков, в том числе и пропущенные, можно с помощью GET запроса, в котором можно задать период, за который нужны звонки, а также дополнительные отборы

api.comagic.ru/api/v1/call /?session_key= КлючАутентификации &date_from=Дата1&date_till=Дата2

В ответ в синхронном режиме вернется json со всей необходимой информацией. 
Один из параметров «file_link» — ссылка для скачивания записи разговора.

Уведомление CoMagic об успешности звонка

При входящем звонке мы сохраняем у себя его идентификатор. Если звонок оказался успешным, т.е. произошла запись, в МИС сохраняется связь записи и звонка. В дальнейшем, после оплаты записи, мы этому звонку в CoMagic ставим тег «продажа» с указанием даты и суммы.
Для этого отправляется POST запрос на адрес  «dataapi.comagic.ru/v2.0». В тело запроса передается json вида

{
"id": "e209c793-b062-4d8b-a637-1ef08fab086f",
"method": " set.tag_sales",
"jsonrpc": "2.0",
"params": {
"access_token": " КлючАутентификации ",
" communication_id": "идЗвонка",
" communication_type": "call",
" date_time": "ДатаОплаты",
" transaction_value": "Сумма"
}
}

Этот механизм используется в Calltracking  для анализа, подробнее расскажем в следующей статье. 

Тестировалось на версии платформы 8.3.14.1565.