Messaging
Twilio
Send SMS and WhatsApp notifications from Atlas and route inbound replies onto the right customer record.
What this connector does
- Send outbound SMS and WhatsApp messages from Atlas workflows.
- Route inbound messages onto the matching Atlas customer record.
- Show delivery and read receipts on the Atlas message log.
- Listen for status callbacks with signed payloads.
Before you begin
- You have a Twilio account with at least one verified sending number.
- You can create API Keys on the Twilio console.
- You have a test number to validate the first message.
Get your credentials
Open the Twilio console
Sign in with the account owner. console.twilio.com
Open Account, API keys and tokens
In the left menu, open Account, then API keys and tokens.
Create a Standard API Key
Click Create API Key, name it Atlas Connector, and pick Standard.
Copy the SID, Secret, and Account SID
Copy the API SID, API Secret, and Account SID into the Atlas Twilio connector settings page.
Set inbound webhook URLs
On the Phone Number configuration page, set A Message Comes In webhook to https://YOUR-ATLAS-HOST/webhooks/twilio.
Required scopes and permissions
ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxSKxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxAPI_KEY_SECRETSetup checklist
- Create the provider app in a sandbox or development workspace.
- Add the Atlas redirect URL to the provider app configuration.
- Copy the client id, client secret, or API key.
- Paste the credentials into the Atlas connector settings page.
- Click Connect and complete the provider sign-in screen.
- Run Test connection from the connector page to verify health.
Troubleshooting
Authentication Error
API Key Secret is shown only once. Re-create the key if you did not capture it.
21610 unsubscribed recipient
The recipient replied STOP to opt out. Update Atlas customer record opt-in state.
Webhook signature failed
Atlas validates the X-Twilio-Signature header. Confirm the receiver URL matches what Twilio is configured to call.
Webhooks
Twilio POSTs application/x-www-form-urlencoded payloads to the configured Atlas URL. Atlas validates the X-Twilio-Signature header on every request.
Events Atlas listens for
- inbound SMS
- inbound WhatsApp message
- delivery status callback
Provider docs: https://www.twilio.com/docs/usage/webhooks/messaging-webhooks
Disconnect and data deletion
- Click Disconnect on the Atlas Twilio connector page.
- Open Account, API keys and revoke the Atlas Connector API key.
- Atlas stops sending and receiving messages immediately on disconnect.
Once you have the credentials above, paste them into the live connector page to finish connecting Twilio.
Open the Twilio connector page