SipOut

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

Для того, чтобы у Вас появилась возможность интеграции c Salebot, обратитесь в техподдержку SipOut

Шаг 1. Перейдите в раздел Документация и скопируйте API-ключ:

Раздел Документация в SipOut

Шаг 2. Переходим в настройки подключения в Salebot, раздел Телефония и нажимаем кнопку Подключить для сервиса SipOut:

Раздел Телефония в Salebot

Шаг 3. Вводим API-ключ, скопированный в SipOut, и нажимаем кнопку Сохранить настройки:

Форма ввода ключа для подключения Salebot к SipOut

Шаг 4. Возвращаемся в кабинет SipOut и в подключенных интеграциях появится Salebot (возможно нужно будет обновить страницу):

Раздел интеграции в SipOut

Нажимаем иконку Редактировать: в SipOut подтянутся все сотрудники из Вашего проекта. Для каждого сотрудника назначаем внутренние номера, которые будут использоваться при звонке по click2call:

Настройка внутренних номеров для каждого из сотрудников проекта в Salebot

Шаг 5. Возвращаемся в Salebot и переходим в раздел Сотрудники. Для каждого сотрудника необходимо указать способ совершения телефонных звонков, выбрав из трех доступных режимов: Звонки через приложение, Звонки по API SipOut и Отключить звонки:

Раздел Сотрудники Salebot

Настройка способа совершения телефонных звонков

Если выбрать пункт Отключить звонки, то этот сотрудник не сможет совершать звонки и иконка телефона возле номеров телефона у него не будет отображаться.

Звонки через приложение - при нажатии на иконку телефона звонок будет перенаправлен в приложение, установленное для звонков на Вашем устройстве (Zopier и тд).

Звонки по API SipOut - при клике на иконку телефона АТС звонит сначала сотруднику на номер, указанный в настройках SipOut для этого сотрудника, а уже после ответа сотрудника звонок поступит клиенту.

Для осуществления звонка выбранным методом достаточно в карточке клиента нажать на иконку телефонной трубки рядом с его номером телефона:

Вид карточки клиента Salebot

Как работать с уведомлениями

Для телефонии создан специальный тип уведомлений: Уведомление Телефонии. На такие уведомления бот не реагирует.

После начала разговора приходит уведомление с типом Телефония, содержащее данные о звонке:

Уведомление Телефонии

После окончания разговора и получения вебхука все данные будут сохранены в переменных сделки:

Переменные сделки в карточке клиента Salebot

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 цифр и не иметь лишних знаков и отступов).

Последовательность сопоставления данных о клиенте:

1. Осуществляется поиск клиента Телефонии. Если клиент не найден, то происходит поиск по значениям всех переменных по всему списку клиентов проекта. Первая найденная запись о клиенте считается тем самым "искомым" клиентом.

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

Как использовать виджет обратного звонка или "звонок из блока"

Еще один из вариантов использования интеграции - это возможность заказа обратного звонка.

Для этого в SipOut переходим в раздел Click2Call и создаем виджет.

Далее нажимаем кнопку Редактировать:

Настройка виджета обратного звонка SipOut

Скопируйте строку с адресом API-url:

Получение адреса API-Url

В нужном блоке сделать GET-запрос с использованием полученного API-Url. Вместо <номер телефона> укажите номер клиента, например:

При таком варианте реализации сначала вызов поступит клиенту и только потом менеджеру. Внимательно продумайте схему работы перед использованием.

Как получить весь разговор в виде текста

Данная функция платная. С размером тарифа Вы можете ознакомиться на сайте SipOut

Включение режима речевой аналитики (транскрибация текста через Яндекс)

Если включена функция Речевая аналитика (транскрибация текста через Яндекс), то по окончании звонка, через пару минут придет текст разговора в виде уведомления Телефонии, а также колбек telephony_call_text, который можно использовать для реакции бота на это событие:

Уведомление по окончании разговора с включенным режимом речевой аналитики

Как подключить уведомления Телефонии в AMO CRM и Bitrix24

В Bitrix24 и AMO CRM уведомления Телефонии будут поступать при подключении отправки уведомлений о действиях пользователя:

Настройки при подключении Bitrix24

Настройки при подключении AMO CRM