Send Voice Call
seven.send_voice
ActionVoice & SMSconnection required
Calls the seven.io API with the connection's credentials.
Place a text-to-speech call that reads a message out to the recipient.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- seven.io
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- sender, account_id, base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
5 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
to Recipient number in international format; separate several with commas. | string | Yes | — | — | +4917612345678 |
text The text the synthesised voice reads out on the call. | string | Yes | — | — | Your delivery arrives today. |
sender Sender ID for this message; overrides the connection's default sender. | string | No | — | ≤ 16 characters | AcmeInc |
ringtime How many seconds to let the phone ring before hanging up. | number | No | — | 5–60 | — |
foreign_id Your own identifier for this message, echoed back on status reports. | string | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"sender": "AcmeInc",
"text": "Your delivery arrives today.",
"to": "+4917612345678"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
code seven.io's return code; '100' means the gateway accepted it. | string | — |
accepted How many recipients the gateway accepted. | number | — |
requested How many recipients were in the request. | number | — |
ids The gateway's message id for each accepted recipient. | array | — |
messages One row per recipient, as seven.io returned it. | array | — |
total_price What the whole request cost, in the account's currency. | number | — |
balance The account balance left after the send. | number | — |
sms_type How the gateway routed the message, empty for voice. | string | — |
{
"accepted": 0,
"balance": 0,
"code": "",
"ids": [],
"messages": [],
"requested": 0,
"sms_type": "",
"total_price": 0
}See Send Voice Call run in a workflow.
In a technical demo we add the seven.io connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.