通过 Twilio 语音服务，使用文本转语音技术向指定号码发送语音消息。
配置
Phone settings（电话设置）
- Phone Number From — 呼叫发起方Twilio号码。须为E.164格式（如
+19995550123）。该字段支持 templatization。 - Phone Numbers To — 接收语音呼叫的号码列表（逗号分隔）。该字段支持 templatization。
Account settings
- Twilio Account SID – Your Twilio account identifier.
- Twilio Account Token – Your Twilio authentication token.
注意：若使用Professional Edition，建议使用 Secrets storage 安全存储账户令牌。
Voice settings（语音设置）
- Voice provider — 使用的文本转语音提供商。
- Language — 语音消息的语言，对应Twilio支持的语言。
- Voice — 使用的语音类型。
Audio output settings（音频输出设置）
- Pitch — 音高调整百分比（默认：
100）。值越大音调越高，越小音调越低。 - Rate — 语速百分比（默认：
100）。值越大语速越快，越小语速越慢。 - Volume — 音量调整（单位：分贝，默认：
0）。正值增大音量，负值减小。 - Pause before talking — 语音消息开始播放前的暂停时长（秒）。
JSON Schema
输出消息格式
节点不修改入站消息。消息数据和metadata均原样传递给链中下一节点。
消息确认行为
节点的消息确认行为由环境变量 ACTORS_RULE_EXTERNAL_NODE_FORCE_ACK 控制：
- 设为
true— 入站消息在接收后立即确认并标记为成功处理，创建副本。语音呼叫异步执行，完成后副本入队交由下一节点处理。 - 设为
false（默认）— 入站消息在整个语音呼叫过程中保持处理中状态。语音呼叫完成后将消息传递给下一节点。
消息处理算法
- 节点处理from模板，从入站消息数据和metadata中提取主叫号码。
- 节点处理to模板，从入站消息数据和metadata中提取被叫号码。
- 语音消息内容直接取自入站消息数据，去除首尾引号。
- 使用Twilio TwiML构建语音响应：
- 播报前按配置暂停指定时长
- 使用指定语言、语音、音高、语速和音量的文本转语音配置
- 通过Twilio异步向每个指定号码发起语音呼叫。
- 处理完成时：
- Success：所有语音呼叫成功发起后将消息路由到
Success连接。 - Failure：若任一起呼失败，将消息路由到
Failure连接。
- Success：所有语音呼叫成功发起后将消息路由到
输出连接
- Success
- 已成功向所有指定号码发起语音呼叫。
- Failure
- 发起语音呼叫时发生意外错误（如号码无效或Twilio API错误）。
示例
示例1 — 发送alarm通知
设备触发alarm时发送语音告警。
入站消息
数据：
1
"Attention. Device Temperature Sensor 01 has triggered a high temperature alarm."
Metadata：
1
2
3
4
5
6
{
"deviceName": "Temperature Sensor 01",
"alarmType": "HIGH_TEMPERATURE",
"userPhone": "+15551234567",
"twilioNumber": "+15559876543"
}
节点配置
1
2
3
4
5
6
7
8
9
10
11
12
{
"numberFrom": "${twilioNumber}",
"numbersTo": "${userPhone}",
"accountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"accountToken": "your_auth_token_here",
"language": "EN_US",
"voice": "WOMAN",
"pitch": 100,
"rate": 100,
"volume": 0,
"startPause": 1
}
出站消息
数据：未更改。
Metadata：未更改。
经 Success 连接路由。
结果
已从 +15559876543向 +15551234567发起语音呼叫。1秒暂停后，收件人将听到：
1
Attention. Device Temperature Sensor 01 has triggered a high temperature alarm.