Инструкция для подключения Asterisk, Cisco, Avaya, Oktell, MightyCall, Naumen и других программных АТС.

С вашей стороны нужен шлюз (посредник между Speech Analytics и телефонией), с которым мы будем общаться по HTTP и получать все необходимые данные.

От вашей телефонии нам нужно три вещи:

  1. Запись звонка в стерео-режиме
  2. Мета-параметры по каждому звонку (дата и время звонка, ID и т.д.)
  3. Имена операторов (не обязательно, но желательно)

Как только разработаете API согласно техническому заданию, пришлите нам URL и данные для авторизации, после этого мы подключимся и заведем аккаунт.

Как работает интеграция

Регулярно (каждые несколько минут) мы запрашиваем метод /calls (получение метаданных звонков). Запрашиваем его двигающимся окном с перекрытием. Так же регулярно запрашиваем метод /operators

Отдельно по мере обработки звонков в соответствующей очереди на нашей стороне запрашиваем метод /recording (скачивание аудиофайла). Один звонок может быть скачан несколько раз в процессе обработки. Сами звонки мы у себя не храним и удаляем после обработки.

В веб интерфейсе есть возможность прослушать звонок и просмотреть осциллограмму звонка, в этот момент мы повторно скачиваем звонок по API через вызов /recording

Описание API

API доступен из интернета по доменному имени, взаимодействуя с нашим приложением по протоколу https и только по нему.

Авторизация

Все запросы к API снабжаются авторизационным заголовком с указанием API-ключа.

Authorization: Bearer <api-key>