Twilio

send_sms

Send a text message.

Request body:

{
  "user_id": "...",
  "action": "send_sms",
  "payload": { "to": "+15551234567", "text": "Hello!" },
  "target_app": "twilio"
}

provider_response.result shape:

{ "sid": "SM...", "status": "queued" }

send_whatsapp

Send a WhatsApp message (requires WhatsApp-enabled sender).

Request body:

{
  "user_id": "...",
  "action": "send_whatsapp",
  "payload": { "to": "+15551234567", "text": "Hello!" },
  "target_app": "twilio"
}

provider_response.result shape:

{ "sid": "SM...", "status": "queued" }

make_call

Place a phone call using TwiML instructions from a URL.

Request body:

{
  "user_id": "...",
  "action": "make_call",
  "payload": { "to": "+15551234567", "twiml_url": "https://.../twiml.xml" },
  "target_app": "twilio"
}

provider_response.result shape:

{ "sid": "CA...", "status": "queued" }

get_message_status

Check delivery status of a sent message.

Request body:

{
  "user_id": "...",
  "action": "get_message_status",
  "payload": { "messageSid": "SM1234567890abcdef" },
  "target_app": "twilio"
}

provider_response.result shape:

{ "sid": "SM...", "status": "delivered" }

list_messages

List recent messages (up to 20).

Request body:

{
  "user_id": "...",
  "action": "list_messages",
  "payload": {},
  "target_app": "twilio"
}

provider_response.result shape:

{ "messages": [{"sid":"...","status":"..."}] }

custom

Escape hatch for any Twilio REST endpoint.

Request body:

{
  "user_id": "...",
  "action": "custom",
  "payload": { "path": "Messages.json", "method": "GET", "form_encoded": false, "body": {} },
  "target_app": "twilio"
}

provider_response.result shape:

{...}

21211 "Invalid 'To' Phone Number"

Cause: Phone number missing the + and country code.

Fix: Always use full E.164 format, e.g. +15551234567, never a local format.

21608 "The number is unverified" (trial accounts)

Cause: Twilio trial accounts can only send to verified numbers.

Fix: Verify the recipient in Twilio Console, or upgrade out of trial mode.

401 Authenticate (inside provider_response)

Cause: Account SID or Auth Token is wrong.

Fix: Re-copy both from the Twilio Console dashboard exactly.