UISCOM
UIS – надежный провайдер услуг телефонии по всей России
Last updated
UIS – надежный провайдер услуг телефонии по всей России
Last updated
Для настройки интеграции UISCOM c Salebot.pro в кабинете UIS необходимо подключить компонент API Оптимальный. Подключить компонент можно только под правами Администратора.
Для этого необходимо в верхнем правом углу нажать "Администратор - Аккаунт". Слева в меню выбрать раздел "Тарифы и опции", в предоставленном списке опций найти "API Оптимальный" и нажать кнопку "Подключить".
Для работы интеграции необходимо сформировать ключ API, а также добавить IP-адрес salesbot.pro в список разрешенных.
Для формирования ключа API в верхнем правом углу перейдите в "Администратор - Управление пользователями".
Можно редактировать либо уже имеющегося пользователя, либо создать нового.
При редактировании или создании пользователя внизу должны быть выбраны следующие пункты:
Data API
Call API
Использовать ключ API - бегунок в положении включен
Время жизни - Вечно
При проставлении галочки Использовать ключ API генерируется сразу ключ, который нужно скопировать. Ключ отображается один раз: до момента сохранения данных при редактировании или создании пользователя. Если вы не скопировали сразу ключ, то можно сгенерировать новый. Полученный ключ API укажите в настройках подключения телефонии UISCOM в вашем проекте Salebot:
В Uiscom после создания пользователя нужно перейти в "Администратор - Аккаунт", слева выбрать раздел "Правила и настройки безопасности", вкладка API. Нажать кнопку "Добавить", ввести в поле IP/Маска IP-адрес 62.84.125.172 (адрес salesbot.pro) и нажать на дискету, чтобы сохранить указанный адрес.
Если у вас еще не подключен номер UISCOM, то его можно подключить, перейдя "Администратор - Аккаунт", слева выбрать раздел "Управление номерами" и нажать кнопку "Подключить".
Во всплывающем окне выбрать понравившийся номер, проставить галочку "Согласен с условиями" и нажать кнопку "Подключить".
Для совершения звонков по сценарию, требуется создать сценарий в разделе "Виртуальная АТС - Сценарии".
После создания сценария необходимо получить id сценария, по которому должны обрабатываться звонки. Для этого нужно перейти в редактирование сценария и в адресной строке найти значение параметра "controller.params=xxxxxx" (вам нужны цифры, которые в дальнейшем понадобятся для настроек в salesbot.pro)
Для того чтобы звонки поступали конкретному сотруднику требуется создать соответствующего сотрудника в разделе "Сотрудники".
После создания сотрудника необходимо получить id сотрудника, на которого должны поступать звонки. Для этого нужно перейти в редактирование сотрудника и в адресной строке найти значение параметра "controller.params.recorId=xxxxxxx" (вам нужны цифры, которые в дальнейшем понадобятся для настроек в salebot.pro)
Вебхук - это уведомление о произошедшем событии. Такое уведомление содержит значения измененных переменных.
Для получения полного вебхука от UISCOM достаточно присвоить любое значение переменной save_webhook Переменная может быть как константой проекта, так и переменной сделки.
При этом ответ UISCOM будет записываться в переменную uiscom_request
, которую вы найдете в карточке клиента среди переменных сделки.
Для работы с телефонией используются номера в формате 71234567890 (должен начинаться с 7, состоять из 11 цифр и не иметь лишних знаков и отступов).
Последовательность сопоставления данных о клиенте:
1. Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом.
2. Если клиент не найден среди клиентов Телефонии и: - к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона. - к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет.
Для того, чтобы совершить звонок сотруднику из бота, необходимо использовать функцию uiscom_employee_call(virtual_phone, client_phone, employee_id), которая принимает на вход следующие параметры: virtual_phone - виртуальный номер, строка, пример - '78001002752' client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79004443322'. employee_id - идентификатор сотрудника, которому будет направлен звонок клиента, строка, пример - ‘2339292’.
Пример бота:
Для того чтобы совершить звонок сотруднику из бота, необходимо использовать функцию 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}} }
Тип события уведомления и название уведомления вы выбираете самостоятельно:
При подключении вебхуков после совершения звонка клиенту в диалог приходят вебхуки вида "Uiscom_event {название_уведомления}":
Где название вы задали самостоятельно в настройках Uiscom.
Для включения функциональности загрузки заявок в личном кабинете UIS / CoMagic, в разделе Тарифы и опции требуется подключить опцию "Загрузка коммуникаций из внешних систем".
Если такой опции в личном кабинете нет, скорее всего у Вас тариф, на котором данная опция не поддерживается. В таком случае пользователю нужно будет обратиться к своему менеджеру UIS / CoMagic.
uiscom_offline_messages(message, site_id, campaign_id, visitor_session_id, phone, name)
Параметры: message - текст заявки из параметров site_id, campaign_id, visitor_session_id должен быть передан только один
site_id - уникальный идентификатор сайта, с которого будет передана заявка (подробнее ниже)
campaign_id - уникальный идентификатор рекламной кампании в CoMagic (подробнее ниже)
Внимание!!! Если в campaign_id выберете id -1, то указывать надо site_id
visitor_session_id - Уникальный идентификатор сессии посетителя, полученный из CoMagic. Для получения ID необходимо использовать метод JS API Comagic.getSessionId() ВАЖНО! эти данные нужно будет получать с использованием JS API на своем сайте, а не через Salebot
phone - необязательный параметр, контактный номер телефона. Будет добавлен автоматически, если номер телефона присваивался какой-либо переменной ранее и не был передан в текущей функции.
name - имя клиента, если не передать в функции, то будет взято имя клиента из раздела клиенты
uiscom_get_sites() - вернет словарь вида: {'test.ru': 80913}. Ключ - доменное имя сайта, значение - его id
uiscom_get_campaigns() - вернет словарь вида: {'Тестовый источник': 401745, 'Посетители без рекламной кампании': -1}, где ключ - имя кампании, значение - его id. id равный -1 использовать нельзя!