Что это
Twilio Voice API - интерфейсы Programmable Voice для голосовых приложений. Через REST можно работать с вызовами, а TwiML описывает действия во время звонка. События помогают понять, начался ли вызов, был ли ответ и как он завершился.
Статус completed не доказывает, что менеджер поговорил с человеком: ответить может автоответчик или голосовое меню. Для оценки качества разговора нужны разрешенная запись, расшифровка и проверяемые критерии, а не один статус.
Начните с чтения разрешенной истории Calls. Такой тест проверяет интеграцию без нового платного вызова; реальную телефонию затем проверяют отдельно на согласованном номере и бюджете.
Ключевые параметры
- Категория: Автоматизация
- Сложность: Для разработчика
- Запуск: Проектное внедрение
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- CallSid помогает связывать вызов и дальнейшие события.
- REST дает метаданные для проверяемого журнала.
- TwiML позволяет описывать действия голосового приложения.
- StatusCallback отделяет этапы звонка от результата создания запроса.
Ограничения
- Нужны подходящий аккаунт, номер, направления и права.
- Звонки и дополнительные функции имеют отдельную стоимость.
- Call status не раскрывает смысл и качество разговора.
- Записи и callback требуют отдельной обработки доступности и безопасности.
Как использовать
1. Подготовка. Получите разрешение на чтение учебной истории аккаунта без клиентских записей. Найдите Account SID и ожидаемые собственные CallSid в Console. Если истории нет, не создавайте платный вызов только ради заполнения таблицы.
2. Настройка. Создайте подходящий API key и храните его закрыто. Для REST используйте Basic Auth с API Key SID и Secret, а Account SID - в пути. Не считайте test credentials универсальным доступом к обычной истории аккаунта.
3. Первый результат. Выполните GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls.json?PageSize=3. Выведите calls: sid, status, direction, start_time и duration; телефоны не включайте в общий отчет. Пустая история допустима, но не проверяет голосовой сценарий.
4. Проверка. Сверьте CallSid и статусы с Console, проверьте next_page_uri и обработку ошибок. Для будущего вызова отдельно настройте TwiML, разрешенные направления и бюджет. Проверяйте подпись StatusCallback, исключайте повторы; готовность записи проверяйте по RecordingStatusCallback, а не только завершению Calls.
Примеры сценариев
- Сверить статусы собственных учебных вызовов.
- Подготовить отчет о busy и no-answer для оператора.
- Передать разрешенную готовую запись на отдельный этап анализа.
Доступ и оплата
- Модель оплаты: Оплата по использованию
- Бесплатный тариф: Нет
- Пробный доступ: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Это API платной телефонии, а не подписка на безлимитного ИИ. Стоимость зависит от номера, страны, минут и дополнительных функций. Trial ограничивает возможности и получателей. Направления, регистрацию, оплату и правила записи для своего случая проверяйте отдельно; российский доступ здесь не подтвержден.
Когда не подходит
- Определять качество разговора только по статусу
- Записывать разговоры без разрешенных правил
- Считать любую запись готовой сразу после завершения звонка
Альтернативы
Asterisk позволяет строить собственную телефонию, но требует администрирования и подключения операторов. Aircall API работает с телефонией Aircall. Общая карточка Twilio описывает выбор каналов платформы, не альтернативного поставщика Voice.
