TAI42 — the OS for AI tools

Channel plugin · listing tai42/channel-twilio

Install

tai plugins install tai42-channel-twilio

Permissions

Capability	Declared
Network	yes
Subprocess	no
Filesystem	no

Provides

twilio

Channel — Deliver ask_user questions to a phone over Twilio SMS/WhatsApp and bridge the reply back. Bridge a WhatsApp number carried by Twilio to an agent. Twilio sends and receives text only.

Enable it

manifest.yml

channel_modules:
  - tai42_channel_twilio

Configuration

The CHANNEL_TWILIO_ env group. CHANNEL_TWILIO_REDIS_URL (and the inherited connection-tuning fields) point the plugin-owned correlation store.

Variable	Default	Effect
`CHANNEL_TWILIO_ACCOUNT_SID`	unset	Twilio account SID.
`CHANNEL_TWILIO_AUTH_TOKEN`	unset	Authenticates the outbound send and keys the inbound signature check (a mis-signed webhook is rejected). Secret.
`CHANNEL_TWILIO_FROM`	unset	The WhatsApp sender, `whatsapp:`-prefixed (Twilio’s `From`).
`CHANNEL_TWILIO_ALLOWED_RECIPIENTS`	empty	Whitelist of `To` numbers a caller-requested recipient must be on. Comma-separated or JSON list.
`CHANNEL_TWILIO_DEFAULT_RECIPIENT`	unset	`To` number used when the caller requests none; not allowlist-checked.
`CHANNEL_TWILIO_HTTP_TIMEOUT_SECONDS`	`30`	Timeout for the outbound send and the loopback answer forward.
`CHANNEL_TWILIO_DEDUPE_TTL`	`172800`	Seconds a handled `MessageSid` stays remembered (replay guard).
`CHANNEL_TWILIO_REDIS_URL`	unset	Connection for the correlation store.

Point the webhooks at the deployment

Twilio calls two webhooks (configured in the Twilio console or REST — the plugin never mutates your Twilio account):

Inbound message (HTTP POST) → {public base URL}/api/channels/twilio/inbound
Delivery status callback (HTTP POST) → {public base URL}/api/channels/twilio/status

The status callback surfaces a late delivery failure: Twilio accepts the send, then posts a failed/undelivered status, which flips the answer record to failed. This is how the WhatsApp 24-hour service window is surfaced on the async path.

Create a bridge route

our_identity is the number the client texts — the Twilio WhatsApp sender, whatsapp:-prefixed:

tai conversations create chat-line \
  --door channel --target-name chat --execution-key chat-bot \
  --channel twilio --identity whatsapp:+14155238886

A (channel, identity) pair may be claimed by only one route; more senders are more rows.

Get started

Concepts

Guides

Operate

Self-hosted

Marketplace

Integrations

Babelfish

Plugins

channel-twilio

Install

Permissions

Provides

twilio

Enable it

Configuration

Point the webhooks at the deployment

Create a bridge route

See also

​Install

​Permissions

​Provides

​twilio

​Enable it

​Configuration

​Point the webhooks at the deployment

​Create a bridge route

​See also

Install

Permissions

Provides

twilio

Enable it

Configuration

Point the webhooks at the deployment

Create a bridge route

See also