Что это
Twilio Voice Recordings API работает с записями Programmable Voice. Он помогает найти аудио, связать его с вызовом по CallSid и передать в следующий этап обработки. Это часть Twilio, а не самостоятельный сервис оценки менеджеров.
Сначала проверяют состояние записи. Для скачивания аудио нужны completed, наличие файла в Twilio и авторизация. Даже готовые метаданные не гарантируют, что файл остался в хранилище: он мог быть удален или перенесен.
Расшифровка, разделение говорящих и выводы о разговоре - отдельные задачи. Начните с чтения метаданных собственной учебной записи; клиентское аудио не нужно отправлять внешней модели только ради проверки подключения.
Ключевые параметры
- Категория: Автоматизация
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- RecordingSid и CallSid помогают сопоставить запись с вызовом.
- API возвращает состояние, длительность и число каналов записи.
- Готовое аудио можно получить в WAV или MP3 с авторизацией.
- RecordingStatusCallback позволяет отслеживать готовность записи.
Ограничения
- Файл доступен для скачивания только в подходящем состоянии и при наличии в хранилище.
- Запись и хранение имеют собственные тарифы и настройки.
- Расшифровка и оценка качества не возникают от чтения Recordings.
- Аудио содержит чувствительные сведения и требует контроля обработки.
Как использовать
1. Подготовка. Выберите собственную разрешенную учебную запись в Twilio Console и запишите ее RecordingSid и CallSid. Если записей нет, остановитесь на проверке пустого списка: новый платный звонок для этого не обязателен.
2. Настройка. Храните API Key SID и Secret на сервере интеграции. Для REST используйте их как логин и пароль Basic Auth; Account SID укажите в пути. Проверьте права ключа на чтение записей.
3. Первый результат. Выполните GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Recordings.json?PageSize=3 и выведите recordings: sid, call_sid, status, duration и channels. Для выбранной completed-записи при наличии разрешения получите /Recordings/{RecordingSid}.mp3 с авторизацией и сохраните файл в закрытой папке.
4. Проверка. Сверьте SID и длительность с Console, прослушайте только собственное учебное аудио. Проверьте обработку processing, absent, 404 и next_page_uri; не превращайте ошибку скачивания в пустую расшифровку. Для дальнейшего процесса проверяйте подпись callback и исключайте повторную обработку по RecordingSid.
Примеры сценариев
- Получить метаданные без скачивания клиентских разговоров.
- Проверить готовность собственной записи.
- Передать согласованное аудио в отдельный этап расшифровки.
Доступ и оплата
- Модель оплаты: Оплата по использованию
- Бесплатный тариф: Нет
- Пробный доступ: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Стоимость записи, хранения, звонков и дополнительных функций нужно считать отдельно по тарифам Twilio. Trial ограничен и не равен бесплатной рабочей телефонии. Регистрация, направления и оплата из России в этом проходе не проверены.
Когда не подходит
- Оценить разговор без прослушивания или расшифровки
- Открыть записи клиентов по публичной ссылке
- Считать завершенный звонок готовым аудиофайлом
Альтернативы
Twilio Voice API управляет вызовами той же платформы. Aircall API получает записи телефонии Aircall. OpenAI Audio API может участвовать в последующей расшифровке, но не заменяет запись звонков Twilio.