SipOut

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

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

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

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

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

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

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

Шаг 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 - приходит с текстом разговора, если используется данная функция (описание ниже)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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