Twilio Connector
Connect your agent to SMS and WhatsApp messaging via Twilio
The Twilio connector lets users interact with your deployed agent through SMS and WhatsApp messaging. The webhook is auto-configured on deploy — no manual setup needed.
Prerequisites
You need a Twilio account with a phone number:
- Sign up at twilio.com and create a project
- In the Twilio Console, note your Account SID and Auth Token
- Purchase or configure a phone number with SMS and/or WhatsApp capabilities
- Note the From Phone Number (in E.164 format, e.g.,
+1234567890)
Setup
Step 1: Create the Connector
- Open your agent in Agent Studio
- In the Connectors panel, click Add Connector
- Select Twilio as the provider
- Enter a Connector Name (lowercase with underscores, e.g.,
production_sms) - Fill in the connector parameters:
- Account SID — Your Twilio Account SID
- Auth Token — Your Twilio Auth Token
- From Phone Number — The Twilio phone number to send messages from
- Configure access:
- Toggle Onboarding on to require approval for new users, or leave it off for open access
- If onboarding is enabled, set an Onboarding Message
- Use the Test button to validate your credentials
Step 2: Configure the Inbound Route
The inbound route filters which messages reach your agent. All parameters are optional — leave them empty to accept all messages.
| Parameter | Description |
|---|---|
| From Number | Limit to messages from a specific phone number |
| To Number | Limit to messages sent to a specific Twilio number (useful if you have multiple numbers) |
Step 3: Configure the Outbound Route
The outbound route controls where your agent sends responses.
- Enable use sender as receiver to reply to the same phone number that sent the message (recommended)
- If disabled, specify a To Number as the explicit response target
Step 4: Save
Save the agent revision to persist the connector configuration.
Deploy and Activate
- Click Deploy to publish the agent revision
- The webhook is automatically configured with Twilio during deployment
- The connector status should show Connected once activation completes
Twilio does not require manual webhook configuration. The platform registers the webhook automatically during deployment.
How Users Interact
Once the connector is connected, users can interact with your agent:
- SMS — Send a text message to your Twilio phone number
- WhatsApp — Send a WhatsApp message to your Twilio WhatsApp-enabled number (if configured)
The agent processes each message and responds via the same channel (SMS or WhatsApp).
Viewing Conversations
All Twilio conversations are tracked in your agent's Conversations tab:
- Filter by Twilio provider to see only SMS/WhatsApp conversations
- View full message history including user messages and agent responses
- Each message links back to its execution record for debugging
Next Steps
- Access Control — Manage who can interact with your agent
- 360Dialog Connector — WhatsApp via 360Dialog
- Conversations — Browse all conversations