Overview
Twilio SMS integration allows your Callers text campaigns to send and receive text messages through Twilio’s messaging platform. This enables your AI agents to conduct intelligent, script-driven conversations over SMS with your contacts.If you already have Twilio connected for voice campaigns, you can use the same account for text campaigns. You may need to enable messaging capabilities on your phone numbers.
Prerequisites
- A Twilio account
- A Twilio phone number with SMS capabilities enabled
- Your Twilio Account SID and Auth Token
Step 1: Create or Verify Your Twilio Account
If you do not yet have a Twilio account:- Go to Twilio and click Start for free.
- Complete the registration form with your name, email, and password.
- Verify your email address via the confirmation link Twilio sends you.
- Complete phone verification by entering the code Twilio sends to your mobile number.
Step 2: Purchase an SMS-Enabled Phone Number
- Log in to the Twilio Console.
- Navigate to Phone Numbers > Manage > Buy a Number.
- Search for a number and ensure the SMS capability checkbox is selected.
- Click Buy and confirm your purchase.
For high-volume text campaigns, consider purchasing a toll-free number or registering for an A2P 10DLC campaign to improve deliverability and throughput. Twilio requires A2P 10DLC registration for US local numbers used for application-to-person messaging.
Step 3: Retrieve Your Account Credentials
- Open the Twilio Console Dashboard.
- Locate the Account Info section on the dashboard.
- Copy your Account SID and Auth Token.
Step 4: Register for A2P 10DLC (US Numbers)
If you are sending SMS to US phone numbers using a local (10-digit) number, you must register for A2P 10DLC. Contact our support team for help with the registration process.Step 5: Connect Twilio to Callers
- Log in to your Callers dashboard.
- Navigate to the App Center tab in the left sidebar.
- Find the Twilio integration and click Connect.
- Enter your Account SID and Auth Token in the fields provided.
- Click Connect to complete the integration.
- Your Twilio phone numbers will appear in the numbers list. Click Refresh if they are not immediately visible.
Step 6: Configure a Text Campaign with Twilio
- Create a new campaign and select Text as the campaign type.
- In Campaign Setup, under the Channel section, select Twilio SMS as your messaging provider.
- Choose the Twilio phone number(s) you want to use for this campaign.
Compliance and Opt-Out Management
Callers automatically handles SMS compliance requirements:- STOP/UNSUBSCRIBE: Contacts who reply with STOP are automatically opted out and will not receive further messages.
- HELP: Contacts who reply with HELP receive your configured help message.
Delivery Reports and Analytics
Twilio provides delivery status updates for each message:| Status | Description |
|---|---|
| Queued | Message accepted by Twilio, waiting to be sent |
| Sent | Message sent to the carrier network |
| Delivered | Message confirmed delivered to the contact’s device |
| Undelivered | Message could not be delivered (invalid number, carrier block, etc.) |
| Failed | Message failed to send (account issue, Twilio error) |
Troubleshooting
Messages are not being delivered
Messages are not being delivered
- Verify your Twilio account is active and has sufficient balance.
- Check that your phone number has SMS capabilities enabled.
- For US numbers, confirm your A2P 10DLC registration is approved.
- Review the Twilio Console error logs for specific error codes.
Phone numbers are not appearing in Callers
Phone numbers are not appearing in Callers
- Click the Refresh button in the App Center tab.
- Verify that your Account SID and Auth Token are correct.
- Ensure the phone numbers have SMS capability (not voice-only).
Messages are being filtered or blocked by carriers
Messages are being filtered or blocked by carriers
- Register for A2P 10DLC if using US local numbers.
- Use a toll-free number for higher throughput.
- Avoid sending identical messages to large lists - personalize using campaign variables.
- Ensure your message content complies with carrier guidelines.
Next Steps
- Configure campaign settings for message timing and availability.
- Review Twilio’s messaging documentation for advanced configuration.