Twilio Voice
Use this node to initiate a Twilio text-to-speech voice call — for example, calling an operations manager’s phone to read out a critical alarm message, or delivering a maintenance reminder via automated voice when an email or SMS may be missed.
Configuration
Section titled “Configuration”- Number From — required. Twilio caller phone number in E.164 format. Supports templatization.
- Numbers To — required. Comma-separated recipient phone numbers. Supports templatization.
- Account SID / Account Token — required. Twilio credentials.
- Provider — TTS provider (e.g., Amazon Polly).
- Language — TTS language code.
- Voice — TTS voice name.
- Pitch / Rate / Volume / Start pause — audio output tuning parameters.
The voice content is taken from the incoming message data.
Message processing algorithm
Section titled “Message processing algorithm”- Resolve caller and recipient phone numbers from templates.
- Initiate a voice call to each recipient via the Twilio API, using the configured TTS settings to read the incoming message data.
- Route via
Successon initiation. Message data and metadata are not modified. - Route via
Failureon invalid phone numbers, Twilio API error, or unexpected error.
Output connections
Section titled “Output connections”| Connection | Condition |
|---|---|
Success | Voice calls initiated to all recipients. |
Failure | Invalid phone numbers, Twilio API error, or unexpected error. |
Examples
Section titled “Examples”Example 1 — Voice alarm call
Section titled “Example 1 — Voice alarm call”Data: "Critical alarm: server room temperature exceeds 40 degrees Celsius." | Metadata: { "managerPhone": "+15551234567" }.
{ "numberFrom": "+19995550123", "numbersTo": "${managerPhone}", "accountSid": "ACxxxxxxxx", "accountToken": "your_token", "provider": "Amazon Polly", "language": "en-US", "voice": "Joanna"}Result: voice call placed to +15551234567; Twilio reads the message aloud. Routes via Success.
JSON schema
Section titled “JSON schema”{ "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "TbTwilioVoiceNodeConfiguration", "type": "object", "required": ["numberFrom", "numbersTo", "accountSid", "accountToken"], "additionalProperties": false, "properties": { "numberFrom": { "type": "string" }, "numbersTo": { "type": "string" }, "accountSid": { "type": "string" }, "accountToken": { "type": "string" }, "provider": { "type": "string" }, "language": { "type": "string" }, "voice": { "type": "string" } }}