Twilio Voice é uma plataforma poderosa de comunicações na nuvem que permite às empresas fazer, receber e gerenciar chamadas telefônicas de forma programática por meio de uma API simples.
O Twilio Voice oferece uma API robusta para construir aplicações de voz sofisticadas com alcance global. Com cobertura em mais de 100 países, confiabilidade de nível de operadora e um SLA de uptime de 99,95%, a Twilio se consolidou como líder do setor em comunicações de voz programáveis.
Os principais recursos do Twilio Voice incluem:
- Rede de voz global: Faça e receba chamadas no mundo todo com números de telefone locais em vários países
- Controle programável de chamadas: Use TwiML para controlar o fluxo da chamada, gravar conversas, coletar entrada DTMF e implementar sistemas IVR
- Recursos avançados: Reconhecimento de fala, text-to-speech, encaminhamento de chamadas, conferência e detecção de secretária eletrônica
- Analytics em tempo real: Acompanhe qualidade da chamada, duração e custos, e otimize suas aplicações de voz
No Zoen, a integração do Twilio Voice permite que seus agentes aproveitem esses recursos de voz nos fluxos de trabalho. Isso abre cenários sofisticados de engajamento com clientes, como lembretes de compromisso, chamadas de verificação, linhas de suporte automatizadas e sistemas de resposta de voz interativa. A integração conecta seus fluxos de trabalho de IA aos canais de comunicação por voz, permitindo que os agentes entreguem informações oportunas e relevantes diretamente por telefone. Ao conectar o Zoen ao Twilio Voice, você pode criar agentes inteligentes que engajam clientes pelo canal preferido, melhorando a experiência do usuário e automatizando tarefas rotineiras de chamada.
Usage Instructions
Integrate Twilio Voice into the workflow. Make outbound calls and retrieve call recordings.
Actions
twilio_voice_make_call
Make an outbound phone call using Twilio Voice API.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
to | string | Yes | Phone number to call in E.164 format (e.g., +14155551234) |
from | string | Yes | Your Twilio phone number to call from in E.164 format (e.g., +14155559876) |
url | string | No | Webhook URL that returns TwiML instructions for the call (e.g., https://example.com/twiml\) |
twiml | string | No | TwiML instructions to execute. Use square brackets instead of angle brackets (e.g., [Response][Say]Hello[/Say][/Response]) |
statusCallback | string | No | Webhook URL for call status updates |
statusCallbackMethod | string | No | HTTP method for status callback (GET or POST) |
accountSid | string | Yes | Twilio Account SID |
authToken | string | Yes | Twilio Auth Token |
record | boolean | No | Whether to record the call |
recordingStatusCallback | string | No | Webhook URL for recording status updates |
timeout | number | No | Time to wait for answer before giving up (seconds, default: 60) |
machineDetection | string | No | Answering machine detection: Enable or DetectMessageEnd |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the call was successfully initiated |
callSid | string | Unique identifier for the call |
status | string | Call status (queued, ringing, in-progress, completed, etc.) |
direction | string | Call direction (outbound-api) |
from | string | Phone number the call is from |
to | string | Phone number the call is to |
duration | number | Call duration in seconds |
price | string | Cost of the call |
priceUnit | string | Currency of the price |
error | string | Error message if call failed |
twilio_voice_list_calls
Retrieve a list of calls made to and from an account.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
accountSid | string | Yes | Twilio Account SID |
authToken | string | Yes | Twilio Auth Token |
to | string | No | Filter by calls to this phone number in E.164 format (e.g., +14155551234) |
from | string | No | Filter by calls from this phone number in E.164 format (e.g., +14155559876) |
status | string | No | Filter by call status (e.g., queued, ringing, in-progress, completed, busy, failed, no-answer, canceled) |
startTimeAfter | string | No | Filter calls that started on or after this date (YYYY-MM-DD) |
startTimeBefore | string | No | Filter calls that started on or before this date (YYYY-MM-DD) |
pageSize | number | No | Number of records to return (max 1000, default 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the calls were successfully retrieved |
calls | array | Array of call objects |
total | number | Total number of calls returned |
page | number | Current page number |
pageSize | number | Number of calls per page |
error | string | Error message if retrieval failed |
twilio_voice_get_recording
Retrieve call recording information and transcription (if enabled via TwiML).
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
recordingSid | string | Yes | Recording SID to retrieve (e.g., RExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx) |
accountSid | string | Yes | Twilio Account SID |
authToken | string | Yes | Twilio Auth Token |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the recording was successfully retrieved |
recordingSid | string | Unique identifier for the recording |
callSid | string | Call SID this recording belongs to |
duration | number | Duration of the recording in seconds |
status | string | Recording status (completed, processing, etc.) |
channels | number | Number of channels (1 for mono, 2 for dual) |
source | string | How the recording was created |
mediaUrl | string | URL to download the recording media file |
file | file | Downloaded recording media file |
price | string | Cost of the recording |
priceUnit | string | Currency of the price |
uri | string | Relative URI of the recording resource |
transcriptionText | string | Transcribed text from the recording (if available) |
transcriptionStatus | string | Transcription status (completed, in-progress, failed) |
transcriptionPrice | string | Cost of the transcription |
transcriptionPriceUnit | string | Currency of the transcription price |
error | string | Error message if retrieval failed |
Triggers
A Trigger is a block that starts a workflow when an event happens in this service.
Twilio Voice Webhook
Trigger workflow when phone calls are received via Twilio Voice
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
accountSid | string | Yes | Your Twilio Account SID from the Twilio Console |
authToken | string | Yes | Your Twilio Auth Token for webhook signature verification |
twimlResponse | string | No | TwiML instructions to return immediately to Twilio. Use square brackets instead of angle brackets (e.g., [Response] instead of <Response>). This controls what happens when the call comes in (e.g., play a message, record, gather input). Your workflow will execute in the background. |
Output
| Parameter | Type | Description |
|---|---|---|
callSid | string | Unique identifier for this call |
accountSid | string | Twilio Account SID |
from | string | Caller's phone number (E.164 format) |
to | string | Recipient phone number (your Twilio number) |
callStatus | string | Status of the call (queued, ringing, in-progress, completed, etc.) |
direction | string | Call direction: inbound or outbound |
apiVersion | string | Twilio API version |
callerName | string | Caller ID name if available |
forwardedFrom | string | Phone number that forwarded this call |
digits | string | DTMF digits entered by caller (from <Gather>) |
speechResult | string | Speech recognition result (if using <Gather> with speech) |
recordingUrl | string | URL of call recording if available |
recordingSid | string | Recording SID if available |
called | string | Phone number that was called (same as "to") |
caller | string | Phone number of the caller (same as "from") |
toCity | string | City of the called number |
toState | string | State/province of the called number |
toZip | string | Zip/postal code of the called number |
toCountry | string | Country of the called number |
fromCity | string | City of the caller |
fromState | string | State/province of the caller |
fromZip | string | Zip/postal code of the caller |
fromCountry | string | Country of the caller |
calledCity | string | City of the called number (same as toCity) |
calledState | string | State of the called number (same as toState) |
calledZip | string | Zip code of the called number (same as toZip) |
calledCountry | string | Country of the called number (same as toCountry) |
callerCity | string | City of the caller (same as fromCity) |
callerState | string | State of the caller (same as fromState) |
callerZip | string | Zip code of the caller (same as fromZip) |
callerCountry | string | Country of the caller (same as fromCountry) |
callToken | string | Twilio call token for authentication |
raw | string | Complete raw webhook payload from Twilio as JSON string |