ПрофСалон - Программа для салонов красоты и бьюти индустрии

Функциональность интеграции

• уведомление о входящем звонке и открытие карточки действующего клиента:



• история звонков в карточке клиента с возможностью прослушивания разговоров (записи хранятся в течение времени, ограниченного тарифным планом 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:

После подключения перейдите в Настройки:

В открывшейся форме кликните Показать ключи:

В соседней вкладке откройте ссылку https://custom.uiscom.ru/profsalon/, введите ключ API, полученный в Личном кабинете UIS и кликните Войти:

В открывшейся форме введите ключи из аккаунта ПрофСервис:

• в поле «Ключ API Телефонии» вставьте токен салона
• в поле «Логин салона» - логин салона
• в поле «ID салона» - ID салона

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

Синхронизация сотрудников

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

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

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

В аккаунте ПрофСалон откройте раздел Сотрудники, нажмите Найти и выберите нужного:

В карточке сотрудника кликните Добавить в разделе Контакты:

В открывшейся форме выберите тип SIP-номер и введите добавочный номер сотрудника в поле Значение:

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

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

Чтобы данные из UIS передавались в ПрофСалон, необходимо настроить пять типов HTTP-уведомлений о событиях.

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

В открывшейся форме заполните следующие поля:

• для первого типа уведомлений:

Название уведомления: Ожидание ответа (ПрофСалон)

Тип события: Ожидание ответа

Способ уведомления: 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}}
}

Кликните Создать.

• для второго типа:

Название уведомления: Начало разговора (ПрофСалон)

Тип события: Начало разговора

Способ уведомления: 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}}
}

Кликните Создать.

• для третьего типа:

Название уведомления: Исходящий звонок (ПрофСалон)

Тип события: Исходящий звонок

Способ уведомления: 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}}
}

Кликните Создать.

• для четвертого типа:

Название уведомления: Завершение плеча (ПрофСалон)

Тип события: Завершение плеча

Способ уведомления: 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}}
}

Кликните Создать.

• для пятого типа:

Название уведомления: Завершение звонка (ПрофСалон)

Тип события: Завершение звонка

Способ уведомления: 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}}
}

Кликните Создать.

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