ПрофСалон - Программа для салонов красоты и бьюти индустрии
Функциональность интеграции
- уведомление о входящем звонке и открытие карточки действующего клиента:
- история звонков в карточке клиента с возможностью прослушивания разговоров (записи хранятся в течение времени, ограниченного тарифным планом UIS):
- уведомления о потерянных звонках (звонки, пропущенные во время того, как сотрудник не был авторизован в CRM, будут показаны при авторизации):
Подключение и настройка интеграции
В Личном кабинете UIS войдите в раздел Администратор — Аккаунт — Тарифы и опции, разверните Все опции:
и подключите API «Базовые отраслевые решения»:
Чтобы UIS и ПрофСалон могли обмениваться данными, необходимо внести IP-адрес 195.211.122.131 и 195.211.122.132 в белый список UIS и создать авторизационный ключ API.
Перейдите в раздел Аккаунт — Правила и настройки безопасности — вкладка API добавьте 195.211.122.131 и 195.211.122.132 в белый список:
Чтобы получить авторизационный ключ API, войдите в Управление пользователями:
Разрешите Администратору доступ к API по ключу. Обязательно скопируйте и сохраните ключ — он показывается только один раз, при создании:
В аккаунте ПрофСалон войдите в раздел меню Маркетплейс и подключите интеграцию с UIS:
После подключения перейдите в Настройки:
В открывшейся форме кликните Показать ключи:
В соседней вкладке откройте ссылку, введите ключ API, полученный в Личном кабинете UIS и кликните Войти:
В открывшейся форме введите ключи из аккаунта ПрофСервис:
- в поле «Ключ API Телефонии» вставьте токен салона
- в поле «Логин салона» — логин салона
- в поле «ID салона» — ID салона
Включите интеграцию.
Синхронизация сотрудников
Сотрудники не копируются автоматически из одного сервиса в другой. Это значит, что сотрудники должны быть созданы вручную и в Личном кабинете UIS, и в сервисе ПрофСалон.
В Личном кабинете UIS перейдите в раздел Сотрудники и выберите из списка нужного сотрудника:
Присвойте сотрудникам внутренние номера, если этого не было сделано ранее. Внутренние номера понадобятся в настройках сервиса ПрофСалон:
В аккаунте ПрофСалон откройте раздел Сотрудники, нажмите Найти и выберите нужного:
В карточке сотрудника кликните Добавить в разделе Контакты:
В открывшейся форме выберите тип SIP-номер и введите добавочный номер сотрудника в поле Значение:
Повторите с каждым из сотрудников, которые должны быть синхронизированы с UIS.
Настройка уведомлений
Чтобы данные из UIS передавались в ПрофСалон, необходимо настроить пять типов HTTP-уведомлений о событиях.
В Личном кабинете UIS войдите в раздел Уведомления, кликните Добавить уведомление:
Необходимо настроить пять видов уведомлений:
1) Название уведомления: Ожидание ответа (ПрофСалон)
Тип события: Ожидание ответа
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/profsalon/api/webhook/
В тело уведомления вставьте текст:
{
"app_id":{{app_id}},
"call_id":{{call_session_id}},
"action": "wait",
"extension_phone_number": {{extension_phone_number}},
"phone": {{contact_phone_number}},
"direction": {{direction}},
"virtual_phone_number": {{virtual_phone_number}},
"call_source": {{call_source}},
"comm_type": {{communication_type}}
}2) Название уведомления: Начало разговора (ПрофСалон)
Тип события: Начало разговора
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/profsalon/api/webhook/
В тело уведомления вставьте текст:
{
"app_id":{{app_id}},
"call_id":{{call_session_id}},
"action": "answer",
"extension_phone_number": {{extension_phone_number}},
"phone": {{contact_phone_number}},
"direction": {{direction}},
"virtual_phone_number": {{virtual_phone_number}},
"call_source": {{call_source}},
"comm_type": {{communication_type}}
}3) Название уведомления: Исходящий звонок (ПрофСалон)
Тип события: Исходящий звонок
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/profsalon/api/webhook/
В тело уведомления вставьте текст:
{
"app_id":{{app_id}},
"call_id":{{call_session_id}},
"action": "callout",
"extension_phone_number": {{extension_phone_number}},
"phone": {{contact_phone_number}},
"direction": {{direction}},
"virtual_phone_number": {{virtual_phone_number}},
"call_source": {{call_source}},
"comm_type": {{communication_type}}
}4) Название уведомления: Завершение плеча (ПрофСалон)
Тип события: Завершение плеча
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/profsalon/api/webhook/
В тело уведомления вставьте текст:
{
"app_id":{{app_id}},
"call_id":{{call_session_id}},
"action": "hangup",
"extension_phone_number": {{extension_phone_number}},
"phone": {{contact_phone_number}},
"direction": {{direction}},
"virtual_phone_number": {{virtual_phone_number}},
"is_failed": {{is_failed}},
"call_source": {{call_source}},
"comm_type": {{communication_type}}
}5) Название уведомления: Завершение звонка (ПрофСалон)
Тип события: Завершение звонка
Способ уведомления: HTTP
Метод: POST
URL: https://custom.uiscom.ru/profsalon/api/webhook/
В тело уведомления вставьте текст:
{
"app_id":{{app_id}},
"call_id":{{call_session_id}},
"action": "record",
"direction": {{direction}},
"employee_ids": {{employee_ids}},
"full_record_file_link": {{full_record_file_link}},
"is_lost": {{is_lost}},
"total_time_duration": {{total_time_duration}},
"lost_reason": {{lost_reason}},
"phone": {{contact_phone_number}},
"virtual_phone_number": {{virtual_phone_number}},
"call_source": {{call_source}},
"comm_type": {{communication_type}}
}Настройка завершена.
