Twilio Voice — это мощная облачная платформа коммуникаций, которая позволяет бизнесам совершать, принимать и управлять телефонными звонками программно через простой API.
Twilio Voice предоставляет надежный API для создания сложных голосовых приложений с глобальным охватом. С покрытием в более чем 100 странах, надежностью уровня оператора связи и SLA доступности 99,95%, Twilio утвердила себя как лидера отрасли в области программируемых голосовых коммуникаций.
Ключевые особенности Twilio Voice включают:
- Глобальная голосовая сеть: Совершайте и принимайте звонки по всему миру с локальными телефонными номерами в нескольких странах
- Программируемое управление звонками: Используйте TwiML для управления потоком звонков, записи разговоров, сбора DTMF-ввода и реализации IVR-систем
- Расширенные возможности: Распознавание речи, преобразование текста в речь, переадресация звонков, конференц-связь и обнаружение автоответчика
- Аналитика в реальном времени: Отслеживайте качество звонков, продолжительность, затраты и оптимизируйте свои голосовые приложения
В AACFlow интеграция с Twilio Voice позволяет вашим агентам использовать эти мощные голосовые возможности как часть своих рабочих процессов. Это создает возможности для сложных сценариев взаимодействия с клиентами, таких как напоминания о встречах, звонки для верификации, автоматизированные линии поддержки и интерактивные голосовые системы ответа. Интеграция устраняет разрыв между вашими ИИ-рабочими процессами и каналами голосовой связи, позволяя вашим агентам доставлять своевременную, релевантную информацию напрямую через телефонные звонки. Подключая AACFlow к Twilio Voice, вы можете создавать интеллектуальных агентов, которые взаимодействуют с клиентами через их предпочтительный канал связи, улучшая пользовательский опыт при автоматизации рутинных задач звонков.
Инструкции по использованию
Интегрируйте Twilio Voice в рабочий процесс. Совершайте исходящие звонки и получайте записи звонков.
Инструменты
twilio_voice_make_call
Совершить исходящий телефонный звонок с использованием API Twilio Voice.
Входные параметры
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
to | string | Да | Номер телефона для звонка в формате E.164 (например, +14155551234) |
from | string | Да | Ваш номер телефона Twilio для звонка в формате E.164 (например, +14155559876) |
url | string | Нет | URL вебхука, возвращающий инструкции TwiML для звонка (например, https://example.com/twiml) |
twiml | string | Нет | Инструкции TwiML для выполнения. Используйте квадратные скобки вместо угловых (например, [Response][Say]Привет[/Say][/Response]) |
statusCallback | string | Нет | URL вебхука для обновлений статуса звонка |
statusCallbackMethod | string | Нет | HTTP-метод для статусного колбэка (GET или POST) |
accountSid | string | Да | Twilio Account SID |
authToken | string | Да | Twilio Auth Token |
record | boolean | Нет | Записывать ли звонок |
recordingStatusCallback | string | Нет | URL вебхука для обновлений статуса записи |
timeout | number | Нет | Время ожидания ответа перед отменой (секунды, по умолчанию: 60) |
machineDetection | string | Нет | Обнаружение автоответчика: Enable или DetectMessageEnd |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
success | boolean | Успешно ли инициирован звонок |
callSid | string | Уникальный идентификатор звонка |
status | string | Статус звонка (queued, ringing, in-progress, completed и т.д.) |
direction | string | Направление звонка (outbound-api) |
from | string | Номер телефона, с которого совершен звонок |
to | string | Номер телефона, на который совершен звонок |
duration | number | Продолжительность звонка в секундах |
price | string | Стоимость звонка |
priceUnit | string | Валюта стоимости |
error | string | Сообщение об ошибке, если звонок не удался |
twilio_voice_list_calls
Получить список звонков, совершенных на аккаунт и с аккаунта.
Входные параметры
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
accountSid | string | Да | Twilio Account SID |
authToken | string | Да | Twilio Auth Token |
to | string | Нет | Фильтр по звонкам на этот номер телефона в формате E.164 (например, +14155551234) |
from | string | Нет | Фильтр по звонкам с этого номера телефона в формате E.164 (например, +14155559876) |
status | string | Нет | Фильтр по статусу звонка (например, queued, ringing, in-progress, completed, busy, failed, no-answer, canceled) |
startTimeAfter | string | Нет | Фильтр звонков, начавшихся в эту дату или позже (ГГГГ-ММ-ДД) |
startTimeBefore | string | Нет | Фильтр звонков, начавшихся в эту дату или раньше (ГГГГ-ММ-ДД) |
pageSize | number | Нет | Количество записей для возврата (макс. 1000, по умолчанию 50) |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
success | boolean | Успешно ли получены звонки |
calls | array | Массив объектов звонков |
total | number | Общее количество возвращенных звонков |
page | number | Текущий номер страницы |
pageSize | number | Количество звонков на странице |
error | string | Сообщение об ошибке, если получение не удалось |
twilio_voice_get_recording
Получить информацию о записи звонка и транскрипцию (если включено через TwiML).
Входные параметры
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
recordingSid | string | Да | Recording SID для получения (например, RExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx) |
accountSid | string | Да | Twilio Account SID |
authToken | string | Да | Twilio Auth Token |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
success | boolean | Успешно ли получена запись |
recordingSid | string | Уникальный идентификатор записи |
callSid | string | Call SID, к которому принадлежит эта запись |
duration | number | Продолжительность записи в секундах |
status | string | Статус записи (completed, processing и т.д.) |
channels | number | Количество каналов (1 для моно, 2 для стерео) |
source | string | Как была создана запись |
mediaUrl | string | URL для загрузки медиафайла записи |
file | file | Загруженный медиафайл записи |
price | string | Стоимость записи |
priceUnit | string | Валюта стоимости |
uri | string | Относительный URI ресурса записи |
transcriptionText | string | Транскрибированный текст из записи (если доступен) |
transcriptionStatus | string | Статус транскрипции (completed, in-progress, failed) |
transcriptionPrice | string | Стоимость транскрипции |
transcriptionPriceUnit | string | Валюта стоимости транскрипции |
error | string | Сообщение об ошибке, если получение не удалось |