Как подключить сервис
Для того, чтобы у Вас появилась возможность интеграции c Salebot, обратитесь в техподдержку SipOut
Шаг 1. Перейдите в раздел Документация и скопируйте API-ключ:
Шаг 2. Переходим в настройки подключения в Salebot, раздел Телефония и нажимаем кнопку Подключить для сервиса SipOut:
Шаг 3. Вводим API-ключ, скопированный в SipOut, и нажимаем кнопку Сохранить настройки:
Шаг 4. Возвращаемся в кабинет SipOut и в подключенных интеграциях появится Salebot (возможно нужно будет обновить страницу):
Нажимаем иконку Редактировать: в SipOut подтянутся все сотрудники из Вашего проекта. Для каждого сотрудника назначаем внутренние номера, которые будут использоваться при звонке по click2call:
Шаг 5. Возвращаемся в Salebot и переходим в раздел Сотрудники. Для каждого сотрудника необходимо указать способ совершения телефонных звонков, выбрав из трех доступных режимов: Звонки через приложение, Звонки по API SipOut и Отключить звонки:
Если выбрать пункт Отключить звонки, то этот сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться.
Звонки через приложение - при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier и тд).
Звонки по API SipOut - при клике на иконку телефона АТС звонит сначала сотруднику на номер, указанный в настройках SipOut для этого сотрудника, а уже после ответа сотрудника звонок поступит клиенту.
Для осуществления звонка выбранным методом достаточно в карточке клиента нажать на иконку телефонной трубки рядом с его номером телефона:
Как работать с уведомлениями
Для телефонии создан специальный тип уведомлений: Уведомление Телефонии. На такие уведомления бот не реагирует.
После начала разговора приходит уведомление с типом Телефония, содержащее данные о звонке:
После окончания разговора и получения вебхука все данные будут сохранены в переменных сделки:
call_action - dial (начало разговора) или complete (окончание разговора)
call_status - статус звонка, примеры: Success, Busy, Missed
call_total_duration_sec - продолжительность в секундах (учитывая гудки)
call_talk_duration_sec - продолжительность разговора в секундах
call_record_link - ссылка на запись
call_did - при входящем вызове номер, на который поступил вызов.
А также придет уведомление Телефонии со всеми данными звонка и обычное уведомление, на которое можно поставить условие и запускать бот:
Уведомления бывают 4 разновидностей:
telephony_call_success - успешный звонок
telephony_call_busy - занято
telephony_call_missed - пропущенный звонок
telephony_call_text - приходит с текстом разговора, если используется данная функция (описание ниже)
Как происходит сопоставление клиента
Для работы с телефонией используются номера в формате 71234567890 (должен начинаться с 7, состоять из 11 цифр и не иметь лишних знаков и отступов).
Последовательность сопоставления данных о клиенте:
- Осуществляется поиск клиента Телефонии.
Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом. - Если клиент не найден среди клиентов Телефонии и:
- к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона.
- к проекту не подключены иные виды мессенджеров (Whatsapp, Viber, Instagram и т.д.), то будет создан клиент Телефонии. Такому клиенту Вы сможете совершать только звонки с получением информации о них. Написать такому клиенту возможности нет.
Как использовать виджет обратного звонка или "звонок из блока"
Еще один из вариантов использования интеграции - это возможность заказа обратного звонка.
Для этого в SipOut переходим в раздел Click2Call и создаем виджет.
Далее нажимаем кнопку Редактировать:
Скопируйте строку с адресом API-url:
В нужном блоке сделать GET-запрос с использованием полученного API-Url. Вместо <номер телефона> укажите номер клиента, например:
При таком варианте реализации сначала вызов поступит клиенту и только потом менеджеру. Внимательно продумайте схему работы перед использованием.
Как получить весь разговор в виде текста
Данная функция платная. С размером тарифа Вы можете ознакомиться на сайте SipOut
Если включена функция Речевая аналитика (транскрибация текста через Яндекс), то по окончании звонка, через пару минут придет текст разговора в виде уведомления Телефонии, а также колбек telephony_call_text, который можно использовать для реакции бота на это событие:
Как подключить уведомления Телефонии в AMO CRM и Bitrix24
В Bitrix24 и AMO CRM уведомления Телефонии будут поступать при подключении отправки уведомлений о действиях пользователя:
