dispatch_sms_campaign
Send outbound SMS campaigns to a target audience using Twilio. Supports personalized message templates, auto-manages STOP/HELP replies, and enforces TCPA 8am-9pm window.
Instructions
Send outbound SMS to the granted audience via Twilio. Body template supports {{first_name}}-style row substitution. STOP/HELP keywords are auto-handled at inbound. TCPA 8am-9pm window enforced. Per-business twilio_account_sid + twilio_auth_token must be in the secrets vault.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"offer_id": "<offer_id>",
"audience_upload_id": "<audience_upload_id>",
"from_phone_number": "<from_phone_number>",
"body_template": "<body_template>"
},
"name": "dispatch_sms_campaign"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| offer_id | Yes | Offer the agent has accepted. | |
| audience_upload_id | Yes | Audience id; rows must include a phone column. | |
| from_phone_number | Yes | E.164 of the Twilio-provisioned sending number. | |
| body_template | Yes | Message body, supports {{column_name}} placeholders. Twilio appends STOP=END text automatically for A2P US numbers. | |
| help_reply | No | Optional override for the carrier-mandated HELP reply. |