Телефония/SipUni
Страница участника СайтЗаказать чат-бот
Собственная платформа чат-ботов для Авито.
Любые интеграции. Оставляйте заявку на сайте!
Sipuni — сервис облачной телефонии, который позволяет быстро телефонизировать ваш бизнес без лишнего оборудования, проводов и географического присутствия.
Чтобы начать работу с провайдером, необходимо создать аккаунт или выполнить вход.
Промокод на 1 месяц бесплатного использования сервиса: SIPUNI_7670_5331.
Сервис имеет собственную интеграцию с AmoCRM. Sipuni легко настраивается в Salebot.
Как подключить сервис
- Для подключения Sipuni к Salebot необходимо получить ключ интеграции.
- Для осуществления звонков сотрудниками следует выполнить подключение внутренних номеров АТС.
Без подключенного внутреннего номера для сотрудника звонки из Salebot работать не будут!
Шаг 1. Настройка Sipuni
Выполняется на стороне sipuni
Переходим в раздел «Конструктор» → меню «Сотрудники» и добавляем необходимое количество сотрудников. В примере, 201 и 202 – короткие номера, которые будут использоваться в дальнейшем в функциях Salebot:
В этом же разделе настраиваются входящие и исходящие сценарии.
Настройте их в соответствии с вашими потребностями:
Входящая схема
Настройки схемы
Шаг 2. Получение ключа интеграции
Ключ интеграции в sipuni
Переходим в раздел «Настройки» → «API» или по ссылке: https://sipuni.com/ru_RU/settings/integration, копируем ключ и ваш номер User ID (на рисунке - 029596):
Шаг 3. Подключение к Salebot
Переходим в Salebot
Открываем вкладку Телефония и нажимаем Подключить:
Вставляем API-ключ и User ID в соответствующие поля:
.png)
Нажимаем Сохранить настройки. На этом подключение завершено.
При успешном подключении вы увидите статус интеграции – Подключено:
Сопоставление клиента
Последовательность сопоставления данных о клиенте:
- Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом.
- Если клиент не найден среди клиентов Телефонии и:
- к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона.
- к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет.
Функция Salebot обратный звонок
Для работы с телефонией используются номера в формате 71234567890, номер телефона клиента, должен:
- начинаться с 7 или с иного кода другой страны, например, 375,
- состоять из 11 и более цифр,
- не иметь лишних знаков и отступов.
 |
Для приведения номеров к данному формату используется функция normalizePhone()
|
Чтобы совершить звонок из бота, необходимо использовать функцию sipuni_internal_to_external_call(client_phone, short_number), которая принимает на вход следующие параметры:
- client_phone – номер телефона клиента, которому должен быть совершен звонок, строка, пример - '79004443322'.
- short_number – короткий номер сотрудника в системе, строка, пример - '100'. При звонке по сценарию следует поставить номер в формате '0-12', ( где 0 - номер голосового меню, 12 - номер сценария).
Код:
sipuni = sipuni_internal_to_external_call('79004443322', '201')
Функция звонок по сценарию
Для того, чтобы совершить звонок сотруднику из бота, необходимо использовать функцию sipuni_scheme_call(client_phone, short_employee_phone, tree_code), которая принимает на вход следующие параметры:
- client_phone – номер клиента, которому должен быть совершен звонок, пример - '79004443322'.
- short_employee_phone – короткий номер сотрудника в системе Sipuni, пример - '201'
- tree_code – номер схемы, по которой будет распределен звонок от клиента, пример - '000-624047'. Номер схемы можно узнать в настройках схемы sipuni (шаг 1).
Пример реализации функции:
sipuni = sipuni_scheme_call('79004443322', '201', '000-624047')
Настройка звонков из карточки клиента
Чтобы осуществлять звонки из карточки клиента, необходимо внести сотрудников в систему Salebot во вкладке Сотрудники.
После регистрации сотрудника, зайдите в редактирование его данных:
Редактирование данных сотрудников
Выбор способа совершения телефонных звонков
Выберите способ совершения телефонных звонков:
| Отключить звонки | сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться |
| Звонки через приложение | при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier или другое) |
| Звонки по API SipUni (нужно указать короткий номер сотрудника) | при нажатии на иконку телефона звонок поступит сначала сотруднику, а затем происходит дозвон клиенту |
После всех настроек, рядом с номером телефона клиента появится изображение телефонной трубки и можно осуществлять вызов:
Настройка вебхуков
Отправка вебхуков настраивается в системе Sipuni. На стороне salebot никаких действий не требуется.
Строка URL:
https://chatter.salebot.pro/sipuni_webhook/SipuniApiKey
Скопируйте ключ интеграции в разделе «Настройки» → «API» в поле Ключ интеграции.
Вставьте строку URL в поле URL принимающего скрипта, заменив SipuniApiKey на ваш ключ:
Нажимаем кнопку Сохранить.
После чего, в Salebot будут приходить уведомления о состоянии вызовов.
В системе используются следующие уведомления:
| Callback | Триггер | |
|---|---|---|
| Sipuni_call_status | ANSWER | вызов принят абонентом |
| Sipuni_call_status | BUSY | абонентом занят |
| Sipuni_call_status | NOANSWER | абонент не ответил на звонок |
| Sipuni_call_status | CANCEL | вызов был сброшен |
| Sipuni_call_status | CONGESTION | перегрузка сети |
| Sipuni_call_status | CHANUNAVAIL | абонент недоступен |
Также, если звонок содержит запись разговора, то у клиента будет создана переменная сделки sipuni_call_record_link, содержащая ссылку на запись.
