๐ฑ SMS via Twilio
PulseHub sends and receives SMS messages through Twilio, one of the most widely available SMS APIs globally.
Prerequisitesโ
- A Twilio account โ free trial is available at twilio.com
- A Twilio phone number with SMS capability (purchased through the Twilio console)
Setup Stepsโ
1. Get Your Twilio Credentialsโ
Log in to the Twilio Console and note:
| Credential | Where to Find It |
|---|---|
| Account SID | Console home page, under "Account Info" |
| Auth Token | Console home page, click "Show" next to Auth Token |
| From Number | Phone Numbers โ Manage โ Active Numbers โ copy your Twilio number in E.164 format (e.g. +15551234567) |
2. Add the Channel in PulseHubโ
- Go to Channels โ Add Channel
- Select SMS (Twilio)
- Enter Account SID, Auth Token, and From Number
- Click Save Channel
- Copy the Webhook URL
3. Configure the Webhook in Twilioโ
- In the Twilio Console, go to Phone Numbers โ Manage โ Active Numbers
- Click your phone number
- Scroll to Messaging Configuration
- Under "A message comes in", select Webhook and paste your PulseHub webhook URL
- Method: HTTP POST
- Click Save
4. Testโ
Send an SMS to your Twilio number. It should appear as a new conversation in PulseHub within seconds.
Twilio Free Trial Limitationsโ
On a free trial account:
- You can only send SMS to verified phone numbers
- Your sent messages will have a Twilio promotional prefix
- There is a limited credit balance
Upgrade to a paid Twilio account to send to any number without restrictions.
Common Issuesโ
| Symptom | Likely Cause |
|---|---|
| No inbound messages in PulseHub | Webhook URL not set in Twilio console, or wrong URL |
| "Unverified number" error when sending | Free trial โ verify recipient number or upgrade |
| Duplicate messages | MessageSid deduplication should prevent this; check messages.external_id |