Чтобы получить авторизационный ключ API, войдите в Управление пользователями и разрешите одному из пользователей (например, Администратору) доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз, при создании, и понадобится для дальнейшей настройки:

Перейдите по адресу: https://custom.uiscom.ru/alfacrm/ и в открывшейся форме вставьте ключ API, полученный в Личном кабинете UIS:

В случае успешной авторизации откроется окно с настройками:

Не закрывайте это окно, оно понадобится для дальнейшей настройки.

В новой вкладке браузера откройте аккаунт АльфаCRM: в верхнем меню, рядом с логотипом, перейдите в Настройки и в открывшемся списке выберите Интеграции — Телефония:

Выберете поставщика UIS:

В открывшемся окне вставьте ключ API, полученный в личном кабинете UIS, в поле API ключ; скопируйте URL из поля Webhook URL, он понадобится для дальнейшей настройки; задайте логику для всплывающих уведомлений и создания лидов:

Не забудьте сохранить.

Вернитесь на вкладку с авторизацией, вставьте ключ в поле Webhook URL АльфаCRM и сохраните:

Включите интеграцию:

Настройка сотрудников

Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в личном кабинете UIS, и в сервисе AlfaCCRM.

В личном кабинете UIS перейдите в раздел Сотрудники и выберите из списка нужного сотрудника:

Присвойте сотрудникам внутренние номера, если этого не было сделано ранее. Внутренние номера понадобятся в настройках сервиса AlfaCRM:

Перейдите в аккаунт AlfaCRM и в меню слева выберите пункт Доступ в CRM. Выберете нужного сотрудника и нажмите Править:

В поле Номер SIP введите добавочный соответствующего сотрудника в UIS и сохраните:

Повторите со всеми сотрудниками, которые будут работать со звонками.

Настройка уведомлений для передачи данных о звонках

Чтобы данные из UIS передавались в АльфаCRM, необходимо настроить четыре типа HTTP-уведомлений (вебхуков) о событиях.

В Личном кабинете UIS войдите в раздел Уведомления и кликните Добавить:

Необходимо настроить четыре вида уведомлений:

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

Тип события: Входящий звонок на виртуальный номер
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/alfacrm/webhook/

В тело уведомления вставьте текст:

Копировать

{
"action": "wait", 
"app_id": {{app_id}}, 
"callId": {{call_session_id}}, 
"call_source": {{call_source}}, 
"communication_type": {{communication_type}}, 
"from":{{contact_phone_number}}, 
"direction": {{direction}}, 
"is_transferred": {{is_transferred}}, 
"leg_id": {{leg_id}}, 
"startTime": {{start_time}}, 
"called_phone_number": {{called_phone_number}}, 
"trunkNumber": {{virtual_phone_number}},
"to": {{extension_phone_number}},
"utm": {"source": {{utm_source}},
"medium": {{utm_medium}}, 
"campaign": {{utm_campaign}}, 
"term":{{utm_term}}, 
"content":{{utm_content}}}
}

2) Название уведомления: Завершение звонка

Тип события: Завершение звонка
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/alfacrm/webhook/

В тело уведомления вставьте текст:

Копировать

{
"app_id":{{app_id}},
"action":"hangup",
"direction":{{direction}},
"callId":{{call_session_id}},
"cause":{{lost_reason}},
"audioUrl":{{record_file_links}},
 "from": {{contact_phone_number}},
"local_number": {{extension_phone_number}},
"duration": {{total_time_duration}},
"is_lost": {{is_lost}},
"finish_reason": {{lost_reason}},
"noanswered_employee_full_names":{{noanswered_employee_full_names}}
}

3) Название уведомления: Начало разговора

Тип события: Начало разговора
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/alfacrm/webhook/

В тело уведомления вставьте текст:

Копировать

{
 "app_id":{{app_id}},
 "action":"answer",
 "direction":{{direction}},
 "callId":{{call_session_id}},
 "answer": {{extension_phone_number}},
 "from": {{contact_phone_number}}
}

4) Название уведомления: Ожидание ответа

Тип события: Ожидание ответа
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/alfacrm/webhook/

В тело уведомления вставьте текст:

Копировать

{
"action": "wait", 
"app_id": {{app_id}}, 
"callId": {{call_session_id}}, 
"call_source": {{call_source}}, 
"communication_type": {{communication_type}}, 
"from":{{contact_phone_number}}, 
"direction": {{direction}}, 
"is_transferred": {{is_transferred}}, 
"leg_id": {{leg_id}}, 
"startTime": {{start_time}}, 
"called_phone_number": {{called_phone_number}}, 
"trunkNumber": {{virtual_phone_number}},
"to": {{extension_phone_number}},
"utm": {"source": {{utm_source}},
"medium": {{utm_medium}}, 
"campaign": {{utm_campaign}}, 
"term":{{utm_term}}, 
"content":{{utm_content}}}
}

Настройка завершена.

Эта статья была полезна для людей. Эта статья помогла Вам?

Да, помогла!

Вопрос не решён