Билайн

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

Настройка интеграции производится через личный кабинет, причем личный кабинет должен быть только НОВОГО типа. В левом меню нажмите “Услуги”, чтобы перейти к дополнительным услугам для АТС.

В конце списка найдите “Интеграция по API” и нажмите “Подключить”. Создайте токен для аутентификации API и скопируйте его.

Подключение интеграции в Salebot

В Salebot перейдите в раздел “Телефония” и заполните данные для подключения Билайн:

API key (токен для аутентификации API) мы скопировали ранее в личном кабинете Билайн, в настройках интеграции.

Нажмите “Сохранить настройки”. Теперь Вы сможете выбирать для своих сотрудников способ совершения телефонных звонков “Звонки по API Beeline”.

Настройка вебхуков

Вебхук - поможет отслеживать звонки на облачную АТС Beeline и передавать их в систему Salebot.

Привязка вебхуков происходит на стороне Salebot, в разделе Сотрудники.

Выберите сотрудника, нажмите … (Редактировать), далее выберите способ совершения телефонных звонков “Звонки по API Beeline” и укажите номер сотрудника.

Номер необходимо взять из личного кабинета Beeline и ввести только цифры: без скобок, пробелов или дефисов.

После нажатия кнопки Готово получение вебхуков от облачной АСТ Beeline будет настроено.

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

Для работы с телефонией используются номера в формате 71234567890: номер должен начинаться с цифры 7 или с иного кода другой страны (например, 375), состоять из 11 и более цифр и не иметь лишних знаков и отступов.

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

1. Осуществляется поиск клиента Телефонии.

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

1. Если клиент не найден среди клиентов Телефонии и:

• если к проекту подключен любой мессенджер, например, Whatsapp, то будет создан клиент Whatsapp с данным номером телефона;

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

Виды уведомлений

В диалог с клиентом будут поступать следующие уведомления:

beeline_call_event <call_type>, где < call_type >:

• Incoming – Входящий звонок.

• Outgoing – Исходящий звонок.

Также после звонка у клиента создаются переменные сделки с информацией о звонке.

• beeline_call_type – Incoming (входящий) или Outgoing (исходящий)

• beeline_client_phone - номер клиента.

• beeline_operator_phone – номер сотрудника (АТС Билайн)

• beeline_start_time – дата и время начала звонка

• beeline_release_time - дата и время завершения звонка

• beeline_record_link - ссылка на запись разговора. Не гарантируется что все звонки будут иметь ссылку на запись разговора, по независящим от Salebot причинам.

• beeline_call_description – Описание звонка: <Дата, время> принят (пропущен) входящий (исходящий). Абонент: <номер сотрудника> Клиент: <номер клиента>

Функция Salebot обратный звонок

Для того чтобы совершить звонок из бота, необходимо использовать функцию beeline_call(client_phone, user), которая принимает на вход следующие параметры:

• client_phone - номер клиента, которому должен быть совершен звонок, строка, пример - '79220001122'.

• user - телефонный номер вашего сотрудника, строка, номер должен начинаться с 9, пример - “9333221100”.

Если удалось установить созвон между client_phone и user, то функция возвращает результат {"status":"1","result":"Call ID: <идентификатор вызова>"}

Если созвон установить не удалось, то вернется {'status': '0', 'error': "<Описание ошибки>"}