Телефония и ИИ

Выгрузка записей разговоров из АТС по API и вебхукам

Общая схема получения записей и журнала звонков из любой АТС, список полей, типовые ошибки и два примера: МегаФон ВАТС и UIS.

голосовой робот от 1 990 ₽/мес
подписка
схема под вашу АТС
условия
✓ Демо на ваших данных до оплаты ✓ Схему подключения настраиваем под ваш тариф ✓ Данные хранятся на серверах в России

Чтобы разобрать звонки, нужно получить два набора данных: журнал (кто, когда, кому звонил, сколько говорили) и сами аудиофайлы. У большинства виртуальных АТС для этого есть API или вебхуки, но каждая делает это по-своему: другие адреса, другие названия полей, разные правила доступа. Общая схема у них одинаковая.

Ниже описано, как устроена выгрузка, какие бывают способы получения данных, что проверить заранее и как это выглядит на примере МегаФон ВАТС и UIS, которые мы уже читаем в рабочем режиме.

Общая схема выгрузки

1

Доступ

В кабинете АТС создаётся ключ или учётная запись с правом читать журнал и записи. Права ключа равны правам пользователя, поэтому его делают отдельным и с минимальным доступом.

2

Журнал звонков

Система запрашивает список звонков за период: время, направление, номер клиента, сотрудник или внутренний номер, длительность, статус, идентификатор записи.

3

Запись

По идентификатору или ссылке из журнала скачивается аудиофайл. Ссылки бывают постоянными и временными, поэтому файл сохраняют сразу.

4

Привязка

Звонок связывается с сотрудником (если АТС его передаёт) и с карточкой клиента в CRM по номеру телефона.

5

Хранение и обработка

Файл идёт на расшифровку и разбор. Метаданные записываются в нашу базу с уникальным идентификатором звонка, повторная выгрузка не создаёт дубликатов.

6

Контроль

Сверяем число звонков в журнале АТС с числом полученных записей, отдельно считаем звонки без записи.

Два способа получить данные: опрос и вебхук

Опрос журнала по расписаниюВебхук от АТС
Как работаетСистема сама раз в несколько минут запрашивает новые звонкиАТС присылает сообщение на наш адрес, когда звонок начался или закончился
ПлюсыПростая схема, не нужен открытый адрес, легко догнать пропущенноеДанные приходят сразу, нет лишних запросов
МинусыНебольшая задержка между звонком и даннымиНужен доступный адрес, а при сбое сообщения надо дублировать опросом
Когда выбиратьЗвонки нужны на разбор в течение часа, у АТС нет вебхуков на вашем тарифеНужна мгновенная реакция: карточка в CRM к концу звонка
Что используемОпрос плюс вебхук как ускоритель, если АТС его даётВебхук и периодическая сверка журнала

Какие поля нужны из журнала звонков

ПолеЗачем нужно
Идентификатор звонкаНе создавать дубликаты при повторной выгрузке
Время начала и длительностьСчитать время ответа и срок разговора
Направление (входящий / исходящий)Разделять разбор по типам звонков
Номер клиентаНайти карточку в CRM
Сотрудник или внутренний номерПодписывать звонок именем и считать результаты по людям
Статус (отвечен, пропущен, занято)Считать пропущенные и скорость перезвона
Ссылка или идентификатор записиСкачать файл
Линия или номер, на который звонилиРазделять по филиалам и рекламным источникам

Пример: МегаФон ВАТС

Журнал звонков компании и записи мы читаем через API личного кабинета ВАТС. В журнале есть идентификатор сотрудника и его имя, то есть звонок уже привязан к человеку. Запись приходит в mp3, моно, 8 кГц. Если для вашей задачи нужен официальный API, ключ выдаёт администратор ВАТС в разделе интеграций кабинета.

Кабинет ВАТС открывается из России, поэтому обращаемся к нему с российского адреса. Подробности по провайдеру собраны на странице МегаФон ВАТС.

Получите план в течение 24 часов, как усилить ваш бизнес с помощью ИИ

→Разбираем воронку и точки, где теряются обращения
→Считаем эффект в цифрах: конверсия, время ответа, экономия
→Список процессов, которые автоматизируются в первую очередь

Пример: UIS

У UIS данные отдают Data API (журнал звонков, сотрудники, номера, сценарии), Call API (управление звонками, в частности исходящие) и вебхук событий. Для журнала используется отчёт по звонкам, в нём указан сотрудник, ответивший на вызов, а для записи есть ссылка на файл.

Доступ по API у UIS по умолчанию закрыт: в настройках безопасности кабинета нужно добавить наш адрес в белый список, иначе запрос вернёт ошибку. Ключ создаётся пользователем и действует с его правами. Подробнее: UIS.

Что почти всегда идёт не так

ПроблемаПричинаКак закрываем
Часть звонков без записиЗапись выключена на линии или у сотрудника, либо файл ещё не готовСчитаем долю звонков без записи, повторяем запрос через время
Ссылка на запись перестала работатьСсылка временнаяСкачиваем сразу и сохраняем у себя
Дубликаты звонковПовторная выгрузка или вебхук и опрос вместеИдентификатор звонка как ключ, вставка без повторов
Не совпадает времяРазные часовые поясаПриводим к одному поясу при загрузке
Ошибка доступаНет права на журнал, адрес вне белого спискаПроверяем права ключа и настройки безопасности
Пропали старые записиОграниченный срок хранения у АТСЗабираем записи сразу, настраиваем срок хранения у нас
Много запросов подрядЛимиты APIПакетные запросы с паузами, повтор при ошибке

Требования к безопасности и праву

Что получаете на выходе

Записи с подписью сотрудника, расшифровки, карточки в Битрикс24 с заполненными полями, ежедневные и месячные отчёты по звонкам. Если АТС не передаёт сотрудника, подпись определяем по голосу, как описано в соответствующем разделе. Цены на дополнительные продукты на странице тарифов.

Если вы не уверены, что доступно на вашем тарифе, пришлите название АТС и тариф. Мы ответим, какой способ выгрузки у вас сработает и что нужно включить в кабинете.

Подключение по провайдерам и смежные страницы

МегаФон ВАТС

Журнал и записи через API кабинета, сотрудник в данных.

UIS

Data API, Call API и вебхуки.

Zadarma

Запрос записи и уведомления о звонках.

Mango Office

Вебхуки событий и API ВАТС.

Расшифровка звонков

Что происходит с записью после выгрузки.

Подключение ИИ к телефонии

Общая схема: SIP, API, вебхуки.

Частые вопросы

Через API журнала звонков: запрашиваете список звонков за период, по каждому берёте ссылку или идентификатор записи и скачиваете файл. Либо принимаете вебхук от АТС и скачиваете запись по событию.

Да, лучше создать отдельный ключ с правами только на чтение журнала и записей. Тогда его можно отозвать, не затрагивая работу сотрудников.

Подскажем другие пути: выгрузка по расписанию из кабинета, SIP-подключение, подключение на старшем тарифе. Для этого пришлите название АТС и тариф.

Опрос ходит за данными сам по расписанию, вебхук приходит от АТС в момент события. Надёжнее сочетание: вебхук для скорости и периодическая сверка журнала.

Срок задаёт провайдер и тариф. Мы забираем записи в момент появления и храним у себя столько, сколько вы укажете.

Это зависит от формата записи на вашей АТС. Подробнее читайте на странице стерео или моно запись.

По номеру клиента и времени звонка. Подпись сотрудника берём из данных АТС или определяем по голосу, ответственный ставится в карточке.

Как правило, да. Добавляют фразу в приветствие линии. Формулировку и срок хранения согласуйте с юристом.

C

Продукт команды PapAI Soft

Записи звонков с АТС — в оценку по регламенту

CANAL берёт записи разговоров, расшифровывает их и оценивает работу менеджеров по чек-листу из вашего регламента, с цитатой под каждым выводом. Подключение самостоятельное, бесплатный тариф без карты.

Посмотреть CANAL →

Покажите журнал звонков за несколько дней

По выгрузке или скриншоту кабинета определим, откуда забирать записи, есть ли сотрудник в данных и сколько звонков без записи.