1С + CoMagic

14.02.19

Интеграция - Внешние источники данных

Делимся опытом: интегрировали 1С и ВАТС CoMagic. Стандартные механизмы и Calltracking.

Скачать файлы

Наименование Файл Версия Размер
1С + CoMagic:
.epf 7,45Kb
24
.epf 7,45Kb 24 Скачать

В нашей конфигурации «МедАнгел» (медицинская информационная система) реализована интеграция с сервисом 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.

МедАнгел CoMagic Calltracking

См. также

Автоматическая многопоточная выгрузка данных 1С 8.3 в БД Clickhouse (для работы с данными 1С в BI-системах)

Внешние источники данных Платформа 1С v8.3 Управляемые формы Анализ и прогнозирование Конфигурации 1cv8 Узбекистан Беларусь Кыргызстан Молдова Россия Казахстан Платные (руб)

Готовое решение для автоматизированной выгрузки данных из 1С 8.3, а также MS Excel в базу данных ClickHouse для работы с данными 1С в Yandex Datalens, Visiology, Apache Superset (и не только) - "Экстрактор данных 1С в BI". Решение отлично работает со всеми типовыми (и не только) конфигурациями 1С 8.3 для управляемых форм. Gозволяет автоматизировать работу бизнес-аналитика по ежедневной выгрузке данных из 1С в БД ClickHouse для последующей работы с этой БД в Yandex Datalens/ Система полностью автоматизирует работу с хранилищем данных в БД Clickhouse. Не надо быть программистом, чтобы одной кнопкой получать любые данные из 1С в Yandex Datalens

160000 руб.

15.11.2022    11328    10    47    

24

Перенос данных из Парус 8 в ЗГУ ред.3

Зарплата Внешние источники данных Бюджетный учет Платформа 1С v8.3 Сложные периодические расчеты 1С:Зарплата и кадры государственного учреждения 3 Государственные, бюджетные структуры Россия Бухгалтерский учет Бюджетный учет Платные (руб)

Обработка позволяет перенести кадровую информацию и данные по заработной плате, фактических удержаниях, НДФЛ, вычетах, страховых взносах из базы Парус 8 учреждений в конфигурацию 1С:Зарплата и кадры государственного учреждения ред. 3 (ЗГУ) и начать с ней работать с любого месяца года.

84000 руб.

19.08.2020    21156    15    0    

18

Перенос данных из Парус 8 в ЗУП ред.3

Зарплата Внешние источники данных Платформа 1С v8.3 Сложные периодические расчеты 1С:Зарплата и Управление Персоналом 3.x Россия Бухгалтерский учет Платные (руб)

Обработка позволяет перенести кадровую информацию и данные по заработной плате, фактических удержаниях, НДФЛ, вычетах, страховых взносах из базы Парус 8 организаций в конфигурацию 1С:Зарплата и управление персоналом, ред. 3 (ЗУП) и начать с ней работать с любого месяца года.

84000 руб.

07.06.2021    12356    1    0    

2

Перенос данных из Парус 7.хх в ЗГУ ред.3

Внешние источники данных Зарплата Бюджетный учет Платформа 1С v8.3 Сложные периодические расчеты 1С:Зарплата и кадры государственного учреждения 3 Государственные, бюджетные структуры Россия Бухгалтерский учет Бюджетный учет Платные (руб)

Обработка позволяет перенести кадровую информацию и данные по заработной плате, фактических удержаниях, НДФЛ, вычетах, страховых взносах из базы Парус 7.хх учреждений в конфигурацию 1С:Зарплата и кадры государственного учреждения ред. 3 (ЗГУ) и начать с ней работать с любого месяца года.

24000 руб.

24.04.2017    47498    92    153    

84

Перенос данных из Парус 10 в ЗГУ ред.3

Внешние источники данных Кадровый учет Файловый обмен (TXT, XML, DBF), FTP Обмен между базами 1C Платформа 1С v8.3 Сложные периодические расчеты 1С:Зарплата и кадры государственного учреждения 3 Государственные, бюджетные структуры Россия Бухгалтерский учет Бюджетный учет Платные (руб)

Обработка позволяет перенести кадровую информацию и данные по заработной плате, фактических удержаниях, НДФЛ, вычетах, страховых взносах из базы Парус 10 учреждений в конфигурацию 1С:Зарплата и кадры государственного учреждения ред. 3 (ЗГУ) и начать с ней работать с любого месяца года.

60000 руб.

05.10.2022    8649    5    8    

8

Перенос данных из Парус 10 (Торнадо) в ЗГУ ред.3 через Excel

Внешние источники данных Загрузка и выгрузка в Excel Зарплата Бюджетный учет Платформа 1С v8.3 Сложные периодические расчеты 1С:Зарплата и кадры государственного учреждения 3 Государственные, бюджетные структуры Россия Бухгалтерский учет Бюджетный учет Платные (руб)

Обработка позволяет перенести кадровую информацию и данные по заработной плате из Парус 10(Торнадо) учреждений через файлы Excel в конфигурацию 1С:Зарплата и кадры государственного учреждения ред. 3 (ЗГУ). В принципе, обработка может быть использована для загрузки из файлов Excel, полученных из любых информационных систем.

24000 руб.

16.11.2018    29546    18    31    

19

Перенос начальных остатков из Парус 7.71 в БГУ

Внешние источники данных Взаиморасчеты Учет ОС и НМА Логистика, склад и ТМЦ Бюджетный учет Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия государственного учреждения Государственные, бюджетные структуры Россия Бюджетный учет Платные (руб)

Перенос словарей и начальных остатков из ПП Парус-Бухгалтерия Бюджет 7.71 в 1Сv8 БГУ2. Заполнение словарей и документов по вводу начальных остатков. Не требуется установка ПП Парус7. Возможна дозагрузка. Внешняя обработка с открытым кодом.

9000 руб.

08.12.2011    80562    123    123    

143

Загрузка данных из F3 TAIL 3 (еФарма 2) в 1С: Бухгалтерия 3.0 (базовая, ПРОФ, КОРП)

Розничная торговля Внешние источники данных Файловый обмен (TXT, XML, DBF), FTP Бухгалтерский учет 1С:Бухгалтерия 3.0 Фармацевтика, аптеки Россия Бухгалтерский учет Платные (руб)

Внешняя обработка загрузки данных из файла-выгрузки, сформированного в программе F3 TAIL версии 3.4 (и выше) или еФарма версии 2.1, в базу конфигурации 1С: Бухгалтерия предприятия 8, ред. 3.0 (базовая, ПРОФ, КОРП).

13200 руб.

19.12.2016    44389    81    101    

66
Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. Dmitrij-2 45 14.02.19 19:41 Сейчас в теме
круто
2. mvgfirst 6 15.02.19 10:21 Сейчас в теме
В случае со входящим звонком, http-сервис обрабатывает ведь Сервер 1С? Я правильно понял?
А как реализовано уведомление конкретного пользователя что ему пришел звонок?
То есть как организована передача с сервера в конкретное клиентское приложение?
3. medangel 83 15.02.19 15:21 Сейчас в теме
Всё верно, передача через регистр сведений "Очередь звонков" и обработчик ожидания.
К нам приходит событие о соединении с абонентом (в нем есть информация о внутреннем номере). У нас в МедАнгеле номер опционально привязывается к пользователю или компьютеру. Обработчик ожидания опрашивает РС "Очередь печати" и в случае совпадения внутреннего номера - вызывает окно Входящего звонка.
Понимаем, что идем на компромисс - но РС практически всё время пустой, всё отрабатывает достаточно быстро.
У нас еще подключена по умолчанию Система взаимодействия (пользователи активно используют), тестировали оповещение через неё. Но результат отрицательный, пользователям не удобно (лишнее нажатие).
Оставьте свое сообщение