SMS (Twilio)
Connect a Twilio number, store credentials securely, and dispatch scheduled texts.
Twilio SMS is available today. Credentials are encrypted at rest and verified against the Twilio API when you save a sender.
Before you connect
Your deployment needs two server-only environment variables:
INTEGRATIONS_ENCRYPTION_KEY— a 32-byte base64 key used to encrypt Auth Tokens at rest. Generate withopenssl rand -base64 32and set it in your server environment (see.env.example).TEST_PHONE— an E.164 number (e.g.+15551234567) that receives SMS when Test Mode is on instead of live recipients.
Without INTEGRATIONS_ENCRYPTION_KEY, RallyForge cannot save Twilio credentials — the Connected Accounts modal will show a configuration error.
Connect in the app
- Open your workspace and choose Connect → Connected Accounts.
- Select the SMS tab (or view all channels).
- Add a sender with a label, Twilio Account SID, Auth Token, and your Twilio phone number in E.164 format.
- Toggle SMS export enabled when you want scheduled posts to dispatch through this sender.
RallyForge verifies credentials against Twilio on save. Auth Tokens are never stored in plain text — only the encrypted value is persisted.
Test Mode
When Test Mode is enabled (admin toggle or RALLYFORGE_TEST_MODE=true), scheduled SMS routes to TEST_PHONE instead of live recipients. This lets you validate copy and timing without sending to your full list.
Facebook and Instagram in Test Mode send preview emails to TEST_EMAIL via Resend. X posts live via OAuth even in Test Mode — see X (Twitter).
Scheduling and dispatch
Schedule SMS from Quick Post or the workspace calendar. Due posts dispatch via /api/cron/dispatch-test-posts (GET from Vercel Cron, or POST from a manual / external scheduler) — protect it with CRON_SECRET in production. The route name is historical; live X and SMS dispatch do not require Test Mode.
Each scheduled SMS must reference an enabled Twilio sender. Segment count and rough cost estimates appear in the UI before send; carrier fees bill through your Twilio account.
Trial and production notes
- Twilio trial accounts can only send to verified numbers — add your test handset in the Twilio console before scheduling.
- Upgrade to a paid Twilio account before sending to unverified recipients in production.
- Keep Auth Tokens server-side only; rotate them in Twilio if exposed.
Related
All connection guides · Tier limits · Campaigns & scheduling