Интеграция с CoMagic: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
Строка 24: Строка 24:
https://p.pfx.so/pf/VK/kWDmrT.jpg
https://p.pfx.so/pf/VK/kWDmrT.jpg


3. Укажите короткие номера сотрудников
3. Укажите короткие номера сотрудников.




Строка 30: Строка 30:




5. В личном кабинете CoMagic разрешите доступ к Call API и к Data API с любых IP-адресов::
5. В личном кабинете CoMagic разрешите доступ к Call API и к Data API с любых IP-адресов:


https://p.pfx.so/pf/wl/MJaPQ7.jpg
https://p.pfx.so/pf/wl/MJaPQ7.jpg
Строка 201: Строка 201:


== Настройка интеграции пользователем без прав администратора в Comagic ==
== Настройка интеграции пользователем без прав администратора в Comagic ==
Для работы интеграции нам трубется доступ к Data API и списку сотрудников.  
Для работы интеграции нам требуется доступ к Data API и списку сотрудников.  
В настройках сотрудника в Comagic это задаётся следуюшщим образом:
В настройках сотрудника в Comagic это задаётся следующим образом:
https://p.pfx.so/pf/m6/KHECA7.jpg
https://p.pfx.so/pf/m6/KHECA7.jpg



Текущая версия от 15:20, 24 марта 2021

Для настройки интеграции с виртуальной АТС CoMagic:

1. Перейдите в раздел Управление аккаунтом / Интеграции (доступен владельцу или администратору аккаунта). Нажмите на Виртуальные АТС:


lz3sz6.png


и в появившемся списке нажмите Активировать напротив CoMagic.


hJgtTB.jpg


2. В открывшемся окне введите логин, пароль от личного кабинета CoMagic, а также принадлежащий вам виртуальный номер, который будет использоваться при исходящих вызовах:

kWDmrT.jpg

3. Укажите короткие номера сотрудников.


4. В личном кабинете CoMagic для работы интеграции должны быть активированы тарифные опции "Уведомления", "Call API Базовый набор" и "Data API"


5. В личном кабинете CoMagic разрешите доступ к Call API и к Data API с любых IP-адресов:

MJaPQ7.jpg


6. Обратитесь в поддержку CoMagic, чтобы вам прописали необходимые для интеграции с ПланФиксом уведомления, указав им адрес для уведомлений из параметров интеграции в ПланФиксе:

DL9KlS.jpg


При необходимости можно прописать их самостоятельно в Личном кабинете CoMagic в разделе "Уведомления"

qtP92Z.jpg


Все уведомления отправляются методом POST на адрес для уведомлений из параметров интеграции.

1. Входящий звонок на виртуальный номер

{  
  "notification_mnemonic":{{notification_mnemonic}},
  "notification_name":{{notification_name}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "scenario_name": {{scenario_name}},
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "contact_id": {{contact_id}},
    "contact_full_name": {{contact_full_name}},
  "call_session_id":{{call_session_id}}
}

2. Завершение звонка

{  
  "notification_name":{{notification_name}},
  "notification_mnemonic":{{notification_mnemonic}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "external_id": {{external_id}},
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}},
    "call_source": {{call_source}},
    "direction": {{direction}},
    "call_session_id":{{call_session_id}},
    "scenario_name": {{scenario_name}},
    "talk_time_duration": {{talk_time_duration}},
    "total_time_duration": {{total_time_duration}},
    "wait_time_duration": {{wait_time_duration}},
    "tag_names": {{tag_names}}
}

3. Записанный разговор

{
  "notification_name": {{notification_name}},
  "notification_mnemonic":{{notification_mnemonic}},
  "virtual_phone_number": {{virtual_phone_number}},
  "notification_time": {{notification_time}},
  "scenario_name": {{scenario_name}},
    "contact_phone_number": {{contact_phone_number}},
    "communication_number": {{communication_number}},
    "contact_id": {{contact_id}},
    "contact_full_name": {{contact_full_name}},
  "call_session_id": {{call_session_id}},
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}},
    "file_link": {{file_link}},
    "file_duration": {{file_duration}},
  "tag_ids": {{tag_ids}},
  "tag_names": {{tag_names}}
}

4. Ожидание ответа

{  
  "notification_name":{{notification_name}},
  "notification_mnemonic":{{notification_mnemonic}},
  "notification_time":{{notification_time}},
  "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_source": {{call_source}},
  "call_session_id":{{call_session_id}},
  "direction": {{direction}},
  "leg_id": {{leg_id}}
}

5. Исходящий звонок

{
  "notification_name": {{notification_name}},
  "notification_mnemonic":{{notification_mnemonic}},
  "virtual_phone_number": {{virtual_phone_number}},
  "notification_time": {{notification_time}},
    "contact_phone_number":{{contact_phone_number}},
    "contact_id":{{contact_id}},
    "contact_full_name":{{contact_full_name}},
  "call_session_id":{{call_session_id}},
    "employee_full_name":{{employee_full_name}},
    "employee_id":{{employee_id}},
    "employee_phone_number":{{employee_phone_number}}
}

6. Начало разговора

{  
  "notification_name":{{notification_name}},
  "notification_mnemonic":{{notification_mnemonic}},
  "notification_time":{{notification_time}},
  "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_source": {{call_source}},
  "call_session_id":{{call_session_id}},
  "direction": {{direction}},
  "leg_ids": {{leg_ids}}
}

7. Окончание разговора

{  
  "notification_name":{{notification_name}},
  "notification_mnemonic":{{notification_mnemonic}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "external_id": {{external_id}},
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "employee_full_name": {{employee_full_name}},
    "employee_id": {{employee_id}},
    "call_source": {{call_source}},
    "call_session_id":{{call_session_id}},
    "direction": {{direction}},
    "scenario_name": {{scenario_name}},
    "talk_time_duration": {{talk_time_duration}},
  "leg_ids": {{leg_ids}}
}

8. Потерянный звонок

{  
  "notification_name":{{notification_name}},
  "notification_mnemonic":{{notification_mnemonic}},
  "virtual_phone_number":{{virtual_phone_number}},
  "notification_time":{{notification_time}},
  "scenario_name": {{scenario_name}},
  "wait_time_duration" : {{wait_time_duration}},
  "employee_ids":{{employee_ids}},
    "contact_phone_number":{{contact_phone_number}},
    "communication_number":{{communication_number}},
    "contact_id": {{contact_id}},
    "contact_full_name":{{contact_full_name}},
  "call_session_id":{{call_session_id}}
}

Настройка интеграции пользователем без прав администратора в Comagic

Для работы интеграции нам требуется доступ к Data API и списку сотрудников. В настройках сотрудника в Comagic это задаётся следующим образом: KHECA7.jpg

Перейти