Телефония и ИИ
Выгрузка записей разговоров из АТС по API и вебхукам
Общая схема получения записей и журнала звонков из любой АТС, список полей, типовые ошибки и два примера: МегаФон ВАТС и UIS.
Чтобы разобрать звонки, нужно получить два набора данных: журнал (кто, когда, кому звонил, сколько говорили) и сами аудиофайлы. У большинства виртуальных АТС для этого есть API или вебхуки, но каждая делает это по-своему: другие адреса, другие названия полей, разные правила доступа. Общая схема у них одинаковая.
Ниже описано, как устроена выгрузка, какие бывают способы получения данных, что проверить заранее и как это выглядит на примере МегаФон ВАТС и UIS, которые мы уже читаем в рабочем режиме.
Общая схема выгрузки
Доступ
В кабинете АТС создаётся ключ или учётная запись с правом читать журнал и записи. Права ключа равны правам пользователя, поэтому его делают отдельным и с минимальным доступом.
Журнал звонков
Система запрашивает список звонков за период: время, направление, номер клиента, сотрудник или внутренний номер, длительность, статус, идентификатор записи.
Запись
По идентификатору или ссылке из журнала скачивается аудиофайл. Ссылки бывают постоянными и временными, поэтому файл сохраняют сразу.
Привязка
Звонок связывается с сотрудником (если АТС его передаёт) и с карточкой клиента в CRM по номеру телефона.
Хранение и обработка
Файл идёт на расшифровку и разбор. Метаданные записываются в нашу базу с уникальным идентификатором звонка, повторная выгрузка не создаёт дубликатов.
Контроль
Сверяем число звонков в журнале АТС с числом полученных записей, отдельно считаем звонки без записи.
Два способа получить данные: опрос и вебхук
| Опрос журнала по расписанию | Вебхук от АТС | |
|---|---|---|
| Как работает | Система сама раз в несколько минут запрашивает новые звонки | АТС присылает сообщение на наш адрес, когда звонок начался или закончился |
| Плюсы | Простая схема, не нужен открытый адрес, легко догнать пропущенное | Данные приходят сразу, нет лишних запросов |
| Минусы | Небольшая задержка между звонком и данными | Нужен доступный адрес, а при сбое сообщения надо дублировать опросом |
| Когда выбирать | Звонки нужны на разбор в течение часа, у АТС нет вебхуков на вашем тарифе | Нужна мгновенная реакция: карточка в CRM к концу звонка |
| Что используем | Опрос плюс вебхук как ускоритель, если АТС его даёт | Вебхук и периодическая сверка журнала |
Какие поля нужны из журнала звонков
| Поле | Зачем нужно |
|---|---|
| Идентификатор звонка | Не создавать дубликаты при повторной выгрузке |
| Время начала и длительность | Считать время ответа и срок разговора |
| Направление (входящий / исходящий) | Разделять разбор по типам звонков |
| Номер клиента | Найти карточку в CRM |
| Сотрудник или внутренний номер | Подписывать звонок именем и считать результаты по людям |
| Статус (отвечен, пропущен, занято) | Считать пропущенные и скорость перезвона |
| Ссылка или идентификатор записи | Скачать файл |
| Линия или номер, на который звонили | Разделять по филиалам и рекламным источникам |
Пример: МегаФон ВАТС
Журнал звонков компании и записи мы читаем через API личного кабинета ВАТС. В журнале есть идентификатор сотрудника и его имя, то есть звонок уже привязан к человеку. Запись приходит в mp3, моно, 8 кГц. Если для вашей задачи нужен официальный API, ключ выдаёт администратор ВАТС в разделе интеграций кабинета.
Кабинет ВАТС открывается из России, поэтому обращаемся к нему с российского адреса. Подробности по провайдеру собраны на странице МегаФон ВАТС.
Получите план в течение 24 часов, как усилить ваш бизнес с помощью ИИ
Пример: UIS
У UIS данные отдают Data API (журнал звонков, сотрудники, номера, сценарии), Call API (управление звонками, в частности исходящие) и вебхук событий. Для журнала используется отчёт по звонкам, в нём указан сотрудник, ответивший на вызов, а для записи есть ссылка на файл.
Доступ по API у UIS по умолчанию закрыт: в настройках безопасности кабинета нужно добавить наш адрес в белый список, иначе запрос вернёт ошибку. Ключ создаётся пользователем и действует с его правами. Подробнее: UIS.
Что почти всегда идёт не так
| Проблема | Причина | Как закрываем |
|---|---|---|
| Часть звонков без записи | Запись выключена на линии или у сотрудника, либо файл ещё не готов | Считаем долю звонков без записи, повторяем запрос через время |
| Ссылка на запись перестала работать | Ссылка временная | Скачиваем сразу и сохраняем у себя |
| Дубликаты звонков | Повторная выгрузка или вебхук и опрос вместе | Идентификатор звонка как ключ, вставка без повторов |
| Не совпадает время | Разные часовые пояса | Приводим к одному поясу при загрузке |
| Ошибка доступа | Нет права на журнал, адрес вне белого списка | Проверяем права ключа и настройки безопасности |
| Пропали старые записи | Ограниченный срок хранения у АТС | Забираем записи сразу, настраиваем срок хранения у нас |
| Много запросов подряд | Лимиты API | Пакетные запросы с паузами, повтор при ошибке |
Требования к безопасности и праву
- Ключ API создавайте отдельный, с правами только на чтение журнала и записей.
- Храните ключ в защищённом хранилище, не передавайте его в письмах и чатах.
- Если разговоры записываются, как правило, собеседника предупреждают: добавьте фразу в приветствие и согласуйте текст с юристом.
- Записи содержат персональные данные клиентов. Мы работаем по договору поручения, храним данные на серверах в России, срок хранения задаётся вами.
- Голос сотрудника для определения личности относят к биометрическим данным, нужно письменное согласие сотрудника по 152-ФЗ. Проверьте формулировку с юристом.
Что получаете на выходе
Записи с подписью сотрудника, расшифровки, карточки в Битрикс24 с заполненными полями, ежедневные и месячные отчёты по звонкам. Если АТС не передаёт сотрудника, подпись определяем по голосу, как описано в соответствующем разделе. Цены на дополнительные продукты на странице тарифов.
Если вы не уверены, что доступно на вашем тарифе, пришлите название АТС и тариф. Мы ответим, какой способ выгрузки у вас сработает и что нужно включить в кабинете.
Подключение по провайдерам и смежные страницы
МегаФон ВАТС
Журнал и записи через API кабинета, сотрудник в данных.
UIS
Data API, Call API и вебхуки.
Zadarma
Запрос записи и уведомления о звонках.
Mango Office
Вебхуки событий и API ВАТС.
Расшифровка звонков
Что происходит с записью после выгрузки.
Подключение ИИ к телефонии
Общая схема: SIP, API, вебхуки.
Частые вопросы
Через API журнала звонков: запрашиваете список звонков за период, по каждому берёте ссылку или идентификатор записи и скачиваете файл. Либо принимаете вебхук от АТС и скачиваете запись по событию.
Да, лучше создать отдельный ключ с правами только на чтение журнала и записей. Тогда его можно отозвать, не затрагивая работу сотрудников.
Подскажем другие пути: выгрузка по расписанию из кабинета, SIP-подключение, подключение на старшем тарифе. Для этого пришлите название АТС и тариф.
Опрос ходит за данными сам по расписанию, вебхук приходит от АТС в момент события. Надёжнее сочетание: вебхук для скорости и периодическая сверка журнала.
Срок задаёт провайдер и тариф. Мы забираем записи в момент появления и храним у себя столько, сколько вы укажете.
Это зависит от формата записи на вашей АТС. Подробнее читайте на странице стерео или моно запись.
По номеру клиента и времени звонка. Подпись сотрудника берём из данных АТС или определяем по голосу, ответственный ставится в карточке.
Как правило, да. Добавляют фразу в приветствие линии. Формулировку и срок хранения согласуйте с юристом.
Продукт команды PapAI Soft
Записи звонков с АТС — в оценку по регламенту
CANAL берёт записи разговоров, расшифровывает их и оценивает работу менеджеров по чек-листу из вашего регламента, с цитатой под каждым выводом. Подключение самостоятельное, бесплатный тариф без карты.
