Brizo - CRM система и управленческий учет для бизнеса
Функциональность интеграции
- уведомления о входящих звонках
- прослушивание записей звонков в интерфейсе Brizo
После завершения разговора UIS отправляет в Brizo данные, в том числе номер телефона клиента. Далее возможны несколько сценариев:
- Если в проекте нет карточек с таким номером, будет создан контакт с этим номером и именем «Входящий звонок номер телефона» или «Исходящий звонок номер телефона». Также Brizo создаст новую сделку с таким же именем на первом этапе первой воронки и привяжет к ней контакт. Запись разговора появится в обеих карточках.
- Если в проекте есть контакт с таким номером, запись появится в его карточке и сделке: или в последней связанной с контактом, или в новой, если таких сделок нет.
- Если в проекте есть компания с таким номером, запись появится в ее карточке и сделке: или в последней связанной с компанией, или в новой, если таких сделок нет.
- Если в проекте есть контакт и компания с таким номером, запись появится в обеих карточках и сделке: или в последней связанной с ними, или в новой, если таких сделок нет.
Подключение интеграции
В Личном кабинете UIS войдите в раздел Тарифы и опции, разверните Все опции:
И подключите API «Базовые отраслевые решения»:
Чтобы UIS и Brizo могли обмениваться данными, необходимо разрешить запросы к серверу UIS от любых IP-адресов и создать авторизационный ключ API.
Перейдите в раздел Аккаунт — Правила и настройки безопасности — вкладка API добавьте 0.0.0.0/0 в белый список:
Чтобы получить авторизационный ключ API, войдите в Управление пользователями и разрешите одному из пользователей (например, Администратору) доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз, при создании, и понадобится для дальнейшей настройки:
В аккаунте Brizo нажмите «Подключить» в окне интеграции UIS и вставьте ваш ключ. После нажатия «Подключить» скопируйте полученную ссылку: она понадобится для дальнейшей настройки.
Настройка уведомлений для передачи данных о звонках
Чтобы данные из UIS передавались в Brizo, необходимо настроить пять HTTP-уведомлений (вебхуков) о событиях.
Для этого в Личном кабинете UIS войдите в раздел Уведомления и кликните Добавить:
Далее требуется создать 5 уведомлений.
1) Название: Входящий звонок на виртуальный номер
Тип события: Входящий звонок на виртуальный номер
Способ уведомления: HTTP
Метод: POST
URL: ссылка, полученная ранее в Brizo
Тело уведомления:
{
"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}},
"start_time": {{start_time}},
"direction": {{direction}}
}
2) Название: Завершение звонка
Тип события: Завершение звонка
Способ уведомления: HTTP
Метод: POST
URL: ссылка, полученная ранее в Brizo
Тело уведомления:
{
"notification_name": {{notification_name}},
"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}},
"total_time_duration": {{total_time_duration}},
"wait_time_duration": {{wait_time_duration}},
"finish_time": {{finish_time}}
}
3) Название: Записанный разговор
Тип события: Записанный разговор
Способ уведомления: HTTP
Метод: POST
URL: ссылка, полученная ранее в Brizo
Тело уведомления:
{
"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}},
"employee_full_name": {{employee_full_name}},
"file_duration": {{file_duration}},
"file_link": {{file_link}}
}
4) Название: Исходящий звонок
Тип события: Исходящий звонок
Способ уведомления: HTTP
Метод: POST
URL: ссылка, полученная ранее в Brizo
Тело уведомления:
{
"notification_name": {{notification_name}},
"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}},
"start_time": {{start_time}},
"direction": {{direction}}
}
5) Название: Начало разговора
Тип события: Начало разговора
Способ уведомления: HTTP
Метод: POST
URL: ссылка, полученная ранее в Brizo
Тело уведомления:
{
"notification_name": {{notification_name}},
"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}},
"virtual_phone_number": {{virtual_phone_number}}
}
Настройка завершена.