Salebot.pro
Search…
⌃K

UISCOM

UIS – надежный провайдер услуг телефонии по всей России

Как подключить сервис

1.Подключение компонента

Для настройки интеграции UISCOM c Salebot.pro в кабинете UIS необходимо подключить компонент API Оптимальный. Подключить компонент можно только под правами Администратора.
Для этого необходимо в верхнем правом углу нажать "Администратор - Аккаунт". Слева в меню выбрать раздел "Тарифы и опции", в предоставленном списке опций найти "API Оптимальный" и нажать кнопку "Подключить".

2. Настройка доступов API

Для работы интеграции необходимо сформировать ключ API, а также добавить IP-адрес salesbot.pro в список разрешенных.
Для формирования ключа API в верхнем правом углу перейдите в "Администратор - Управление пользователями".
Можно редактировать либо уже имеющегося пользователя, либо создать нового.
При редактировании или создании пользователя внизу должны быть выбраны следующие пункты: Data API Call API Использовать ключ API - бегунок в положении включен Время жизни - Вечно
При проставлении галочки Использовать ключ API генерируется сразу ключ, который нужно скопировать. Ключ отображается один раз до момента сохранения данных при редактировании или создании пользователя. Если вы не скопировали сразу ключ, то можно сгенерировать новый. Полученный ключ API укажите в настройках подключения телефонии UISCOM в вашем проекте Salebot:
В Uiscom, после создания пользователя, нужно перейти в "Администратор - Аккаунт", слева выбрать раздел "Правила и настройки безопасности", вкладка API. Нажать кнопку "Добавить", ввести в поле IP/Маска IP-адрес 138.68.73.64 (адрес salesbot.pro) и нажать на дискету, чтобы сохранить указанный адрес.

3. Настройка телефонии

Если у вас еще не подключен номер UISCOM, то его можно подключить, перейдя "Администратор - Аккаунт", слева выбрать раздел "Управление номерами" и нажать кнопку "Подключить".
Во всплывающем окне выбрать понравившийся номер, проставить галочку "Согласен с условиями" и нажать кнопку "Подключить".
Для совершения звонков по сценарию, требуется создать сценарий в разделе "Виртуальная АТС - Сценарии".
После создания сценария необходимо получить id сценария, по которому должны обрабатываться звонки. Для этого нужно перейти в редактирование сценария и в адресной строке найти значение параметра "controller.params=xxxxxx" (вам нужны цифры, которые в дальнейшем понадобятся для настроек в salesbot.pro)
Для того, чтобы звонки поступали конкретному сотруднику требуется создать соответствующего сотрудника в разделе "Сотрудники".
После создания сотрудника необходимо получить id сотрудника, на которого должны поступать звонки. Для этого нужно перейти в редактирование сотрудника и в адресной строке найти значение параметра "controller.params.recorId=xxxxxxx" (вам нужны цифры, которые в дальнейшем понадобятся для настроек в salesbot.pro)

Как происходит сопоставление клиента

Для работы с телефонией используются номера в формате 71234567890 (должен начинаться с 7, состоять из 11 цифр и не иметь лишних знаков и отступов).
Последовательность сопоставления данных о клиенте:
1. Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом.
2. Если клиент не найден среди клиентов Телефонии и: - к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона. - к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет.

Функция звонок сотруднику в Salebot

Для того, чтобы совершить звонок сотруднику из бота, необходимо использовать функцию uiscom_employee_call(virtual_phone, client_phone, employee_id), которая принимает на вход следующие параметры: virtual_phone - виртуальный номер, строка, пример - '78001002752' client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'. employee_id - идентификатор сотрудника, которому будет направлен звонок клиента, строка, пример - ‘2339292’.
Пример бота:

Функция звонок по сценарию в Salebot

Для того, чтобы совершить звонок сотруднику из бота, необходимо использовать функцию uiscom_scenario_call( virtual_phone, client_phone, scenario_id) , которая принимает на вход следующие параметры: virtual_phone - виртуальный номер, строка, пример - '78001002752' client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'. scenario_id - идентификатор сценария, по которому будет распределен звонок клиента, строка, пример - ‘328746’. Пример реализации функции в боте:

Настройка звонков из карточки клиента

Чтобы настроить осуществление звонков непосредственно из карточки клиента. Для этого в систему Salebot вы должны внести своих сотрудников. После того, как вы зарегистрировали сотрудника, зайдите в редактирование его данных.
В позиции “Способ совершения телефонных звонков” выберите звонки по API Uiscom.
  • Если выбрать пункт Отключить звонки, то этот сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться.
  • Звонки через приложение - при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier и тд).
  • Звонки по API Uiscom - при клике на иконку телефона АТС звонок поступит сначала сотруднику, чей id вы указали в карточке, а затем перенаправляет звонок клиенту.
Далее потребуется указать виртуальный номер, зарегистрированный в Uiscom, а также id данного сотрудника в системе Uiscom.
Для осуществления звонка выбранным методом достаточно в карточке клиента нажать на иконку телефонной трубки рядом с его номером телефона:

Настройка вебхуков

Чтобы настроить прием вебхуков, с сервисе UIS стоит зайти в Администратор - Управление пользователями - Уведомления и нажать “Добавить уведомление”
Внизу стоит поставить свитчер HTTP в положение ВКЛ, метод - POST, а URL прописать вида https://chatter.salebot.pro/uiscom_webhook/<апи-ключ>, например, https://chatter.salebot.pro/uiscom_webhook/9xd99uobn9efrkjlx9ybsuz99c9m9nmz9fossm93
В тело запроса следует вставить следующий список: { "external_id":{{external_id}}, "notification_name":{{notification_name}}, "virtual_phone_number":{{virtual_phone_number}}, "notification_time":{{notification_time}}, "scenario_name": {{scenario_name}}, "wait_time_duration" : {{wait_time_duration}}, "employee_ids":{{employee_ids}}, "contact_info":{ "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}} }
При подключении вебхуков после совершения звонка клиенту, в боте будут приходить следующие уведомления(клиент их видеть не будет!)
Last modified 8mo ago