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

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

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 Success on initiation. Message data and metadata are not modified.
Route via Failure on invalid phone numbers, Twilio API error, or unexpected error.

Output connections

Connection	Condition
`Success`	Voice calls initiated to all recipients.
`Failure`	Invalid phone numbers, Twilio API error, or unexpected error.

Examples

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

{
  "$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" }
  }
}