Подготовка UIS к интеграции с Booking

Назад

База знаний

•

Интеграция с UIS

Содержание

К выбору статьи

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

Добавление сотрудников

Настройка распределения входящих звонков

Настройка сценария

Привязка сценария к виртуальному номеру

Завершите настройку в ЛК Booking

Подготовка UIS к интеграции с Booking

Контакты для помощи

Если вам необходима поддержка в регистрации учётной записи в UIS, обратитесь к вашему менеджеру Booking — мы поможем с подключением или заберём данный процесс полностью на себя.

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

Требование к тарифу UIS

Для корректной работы интеграции требуется опция «API расширенный».
В старом ЛК UIS в правом верхнем углe нажмите «Администратор» и в выпадающем списке — «Аккаунт». В боковом меню выберете «Тариф и опции».
Найдите блок «Доступные опции» — нажмите «Все опции». Подключите опцию «API расширенный».

В личном кабинете UIS перейдите в раздел «Уведомления». Нажмите на кнопку «Добавить уведомление». В открывшейся странице заполните поля в соответствии с таблицей:

Название события	Завершение звонка в booking
Тип события	Завершение звонка
Активно	ВКЛ
HTTP	ВКЛ
Метод	POST
URL	https://booking.keep-calm.ru/api/v1/comagic/{Токен CoMagic}/incoming вместо {Токен CoMagic} подставьте значение API-ключа, которое получите после реализации шагов инструкции «Как сгенерировать токен CoMagic»
Тело	{"notification_name":{{notification_name}}, "virtual_phone_number":{{virtual_phone_number}}, "notification_time":{{notification_time}}, "communication_id":{{communication_id}}, "record_link": {{full_record_file_link}}, "contact_phone_number":{{contact_phone_number}}, "direction":{{direction}}, "start_time":{{start_time}}, "finish_time":{{finish_time}}, "finish_reason":{{finish_reason}}, "employee_id" {{employee_id}}}

Инструкция «Как сгенерировать токен UIS»

Нажмите на кнопку «Сохранить». Добавьте ещё 3 уведомления в соответствии с таблицей:

Название события	Исходящий звонок booking	Начало разговора booking	Ожидание ответа booking
Тип события	Исходящий звонок	Поднятие трубки	Ожидание ответа
Активно	ВКЛ	ВКЛ	ВКЛ
HTTP	ВКЛ	ВКЛ	ВКЛ
Метод	POST	POST	POST
URL	https://booking.keep-calm.ru/api/v1/comagic/{Токен CoMagic}/incoming	https://booking.keep-calm.ru/api/v1/comagic/{Токен CoMagic}/incoming	https://booking.keep-calm.ru/api/v1/comagic/{Токен CoMagic}/incoming
Тело	{ "notification_name": {{notification_name}}, "virtual_phone_number": {{virtual_phone_number}}, "notification_time": {{notification_time}}, "communication_id":{{communication_id}}, "contact_phone_number": {{contact_phone_number}}, "direction":{{direction}}, "employee_full_name": {{employee_full_name}}, "employee_id":{{employee_id}}, "employee_phone_number": {{employee_phone_number}}}	{ "notification_name":{{notification_name}}, "virtual_phone_number":{{virtual_phone_number}}, "notification_time":{{notification_time}}, "communication_id":{{communication_id}}, "contact_phone_number":{{contact_phone_number}}, "direction":{{direction}}, "employee_id":{{employee_id}}}	{ "notification_name":{{notification_name}}, "virtual_phone_number":{{virtual_phone_number}}, "notification_time":{{notification_time}}, "communication_id":{{communication_id}}, "scenario_name":{{scenario_name}}, "source":{{source}}, "contact_phone_number":{{contact_phone_number}}, "direction":{{direction}}, "employee_id":{{employee_id}}, "employee_phone_number":{{employee_phone_number}}, "employee_full_name": {{employee_full_name}}}

ВКЛ — переключатель должен загореться зелёным как на скриншоте:

2. Добавление сотрудников

В личном кабинете UIS перейдите в раздел «Сотрудники». Нажмите на кнопку «Добавить сотрудника». В открывшейся странице заполните поле «Фамилия» информативно: так, чтобы вы понимали, к какому ресторану и какой сотрудник привязан.

3. Настройка распределения входящих звонков

Необходимо настроить распределение входящих звонков хотя бы по одному из 3-х описанных ниже методов. Вы можете использовать как один, так и несколько методов настройки.

1. Настройка FMC-линии

Для подключения FMC-линии обратитесь к менеджеру UIS и закажите sim-карту FMC Интернод.

После подписания документов и оплаты курьер доставит sim-карту на указанный адрес.

Вставьте sim-карту в смартфон, поддерживающий 3G связь. После установки sim-карты в настройках сотовых данных пропишите в поле APN одно слово uis.

После получения оригинала договора менеджер сможет активировать sim-карту, и она станет доступной для настройки в UIS.

Зайдите в раздел «Виртуальная АТС» — подраздел «FMC-линии». В списке отобразится купленный вами FMC-номер.

Нажмите на FMC-номер — вам откроется модальное окно. Настройте параметры:

Сотрудник: в выпадающем списке появятся добавленные в п. 2 сотрудники — выберете сотрудника ресторана, в котором активна sim-карта с данным FMC-номером.
Связь: выберете «Входящая и исходящая».
Исходящий номер: номер, который будут видеть гости, когда будут получать звонки от вас — выберете номер, выделенный для статической подмены исходящих.

2. Настройка SIP-линии

Зайдите в раздел «Виртуальная АТС» — подраздел «SIP-линии». Нажмите на кнопку «Создать SIP-линию».

В открывшейся странице настройте параметры:

«Для входящей и исходящей связи».
Сотрудник: в выпадающем списке появятся добавленные в п. 2 сотрудники — выберете сотрудника ресторана.
Исходящий номер: номер, который будут видеть гости, когда будут получать звонки от вас — выберете номер, выделенный для статической подмены исходящих.

Нажмите на кнопку «Создать». В открывшемся модальном окне отобразятся данные для настройки IP-трубки: сервер, порт, логин и пароль — запомните их. Для активации SIP-линии произведите настройку IP-трубки.

3. Переадресация на любой номер телефона

Вы можете настроить переадресацию на ваш уже существующий номер.

Для этого:

Перейдите в раздел «Сотрудники».
Нажмите на иконку карандаша в строке вашего сотрудника для перехода в режим редактирования.
В блоке «Телефоны» нажмите на «Добавить номер» и заполните поля строки.

Важно: при настройке по методу «Переадресация на любой номер телефона» UIS не будет фиксировать записи исходящих звонков. Поэтому настройка уведомления по событию «Исходящий звонок из booking» не требуется.

4. Настройка сценария

Зайдите в раздел «Виртуальная АТС» — подраздел «Сценарии». Нажмите на кнопку «Добавить сценарий».

На открывшейся странице задайте имя сценария в соответствии с названием ресторана. По клику на «Первая операция при входящем звонке» из выпадающего списка выберете «Переадресация на сотрудника». В открывшемся модальном окне выберете сотрудника, настроенного на данный ресторан.

Если в п. 3 вы произвели подключение сразу нескольких линий, и вам требуется более сложная настройка сценария, обратитесь к вашему менеджеру KC Booking за помощью.

5. Привязка сценария к виртуальному номеру

Зайдите в раздел «Виртуальная АТС» — подраздел «Виртуальные номера и правила». Нажмите на кнопку «Добавить сценарий». Нажмите на кнопку «Добавить виртуальный номер».

В открывшемся модальном окне поставьте галочку «Использовать в виртуальной АТС», выберете номер из списка, поставьте галочку «Согласен с пользовательским соглашением» и нажмите кнопку «Подключить».

На странице редактирования виртуального номера нажмите «Создать правило», из выпадающего списка выберете «Обработка звонка». На открывшейся странице в поле «Список АОНов» выберите значение «Для всех номеров» и в поле «Выполнять сценарий» выберите сценарий, созданный в п. 4.

6. Завершите настройку в ЛК Booking

Для завершения настройки интеграции UIS с Booking проделайте шаги из инструкции: «Настройка в Booking интеграции с UIS»

Если у вас не получилось настроить интеграцию, напишите нам — мы поможем 🧠

Если есть вопросы, задайте их команде KC Booking

Позвонить

Написать