AI workers for Twilio

What is an AI worker for Twilio?

An AI worker using Twilio is an AI agent that can send a text message as part of its job, through your own Twilio account and your own sending number. Text is the channel people genuinely read within minutes, which makes it right for a small set of urgent and expected messages, and wrong for everything that could have waited for email.

What these workers do

Remind people about appointments

Sends a short reminder ahead of a booking with the time and place, drawn from the calendar rather than typed by hand.

Confirm a booking immediately

Texts the confirmation as soon as a booking is made, so the person has the detail in a message they can find later.

Alert an on-call person

Reaches whoever is responsible when something needs attention now, on the channel most likely to wake them.

Send a time-critical change

Notifies people when a time or location has moved, where an email would arrive too late to help.

How an AI worker runs in Twilio

Reserve it for what genuinely needs a phone

The message is short, so the detail must be right

Consent is not optional on this channel

Twilio questions, answered.

Whose phone number do messages come from?

Your own Twilio number, through your own account. The worker sends as your business rather than through some shared service, so recipients see a number you control and can recognise, and your own account holds the delivery record of everything that was sent.

How are opt-outs handled?

Your contact rules determine who may be contacted, enforced outside the worker at the point of sending, so a person you have opted out cannot be reached even by mistake. Your Twilio account's own compliance handling continues to apply alongside that.

Can it text anyone the worker decides to?

No. Recipients are checked against your contact rules as the message goes out, not inside the worker's reasoning. A worker that concludes it should text somebody outside those rules simply finds the message refused, which is the behaviour you want on a channel that reaches a personal phone.

Does sending cost money?

Text messages are billed by Twilio on your own account, as they would be for any other sender. That is worth knowing when you decide how often a worker should send, since a chatty worker on this channel has a real bill attached.

What AI workers can do in Twilio

The tools a worker can be granted in Twilio once you connect it. A kit grants only the ones its job needs, and you can narrow them further on the worker.

Send Message

Send a message through Messaging behind the WorkerKit firewall. Recipients are checked against the token's contact rules and the suppression/opt-out list before anything is sent (blocked → RECIPIENT_SUPPRESSED); the sender/channel must be permitted for this token. Provider support varies: scheduledAt and idempotencyKey are RESEND-only, mediaUrls TWILIO/RESEND-only, and 'from' is required for email providers — check providerCapabilities in the capabilities manifest.

Send Template Message

Send a Messaging template message with variable substitution. Discover template IDs with messaging_list_templates. The same firewall gates as messaging_send_message apply.

Dry-Run Send

Validate a Messaging send WITHOUT sending: runs every firewall gate (permissions, sender/channel scope, recipient contact rules, suppression list) and reports the verdict. Use before a real send to surface blocks early.

Preview Message

Preview a Messaging send WITHOUT sending: builds the message (template variables applied) and runs the same firewall gates as a real send, returning what would happen. Prefer messaging_dry_run_send when only the gate verdict matters.

Get Message Status

Get the delivery status of a Messaging message by the messageId returned from a send (status, recipient, timestamps, failure reason).

List Activity

List recent Messaging send activity (message metadata + delivery status; bodies are masked per the token's field visibility).

Get Stats

Get aggregate Messaging sending stats (volumes and outcome counters for the recent period). TWILIO and SENDGRID only; RESEND has no stats API.

List Senders

List the sender identities this Messaging connection can send from (a sender identity the connection can send from (see messaging_list_senders)). Use one of these as 'from'.

List Templates

List Messaging message templates available to this connection.

Get Template

Get a single Messaging template by ID.

Validate Recipient

Check whether a recipient address/number is valid and reachable via Messaging before sending. TWILIO only (Lookup).

Check Opt-Out

Check whether a recipient has opted out / is suppressed on Messaging. Sends to suppressed recipients are blocked automatically. SENDGRID only in v1.

List Suppressions

List recipients on the Messaging suppression list (opted-out / unsubscribed). SENDGRID only in v1.

Suppress Recipient

Add a recipient to the Messaging suppression list so future sends to them are blocked (records an opt-out). SENDGRID only in v1.

Unsuppress Recipient

Remove a recipient from the Messaging suppression list (higher-trust: only do this when the recipient asked to receive messages again). SENDGRID only in v1.

Cancel Scheduled Message

Cancel a scheduled Messaging message that has not been delivered yet, by the messageId the send returned. RESEND only in v1.

Send Twilio Message

Send a message through Twilio behind the WorkerKit firewall. Recipients are checked against the token's contact rules and the suppression/opt-out list before anything is sent (blocked → RECIPIENT_SUPPRESSED); the sender/channel must be permitted for this token. Twilio sends are one recipient per message; opted-out recipients (STOP) are rejected by Twilio at send time.

Send Twilio Template Message

Send a Twilio template message with variable substitution. Discover template IDs with twilio_list_templates. The same firewall gates as twilio_send_message apply. Templates are Twilio Content API templates (HX… SIDs).

Dry-Run Twilio Send

Validate a Twilio send WITHOUT sending: runs every firewall gate (permissions, sender/channel scope, recipient contact rules, suppression list) and reports the verdict. Use before a real send to surface blocks early.

Preview Twilio Message

Preview a Twilio send WITHOUT sending: builds the message (template variables applied) and runs the same firewall gates as a real send, returning what would happen. Prefer twilio_dry_run_send when only the gate verdict matters.

Get Twilio Message Status

Get the delivery status of a Twilio message by the messageId returned from a send (status, recipient, timestamps, failure reason).

List Twilio Activity

List recent Twilio send activity (message metadata + delivery status; bodies are masked per the token's field visibility).

Get Twilio Stats

Get aggregate Twilio sending stats (volumes and outcome counters for the recent period). Aggregates Twilio usage records for the current month.

List Twilio Senders

List the sender identities this Twilio connection can send from (an E.164 phone number or Messaging Service SID (MG…) from twilio_list_senders). Use one of these as 'from'.

List Twilio Templates

List Twilio message templates available to this connection.

Get Twilio Template

Get a single Twilio template by ID.

Validate Twilio Recipient

Check whether a recipient address/number is valid and reachable via Twilio before sending. Uses Twilio Lookup to verify the number is real and reachable.