Skip to main content

​
Overview

OpenSRE’s WhatsApp integration delivers messages to any WhatsApp number via Twilio’s Messaging API. Delivery-only — no gateway or pairing.
This integration uses Twilio as the WhatsApp provider. SMS is a separate integration — see Twilio SMS.

​
Prerequisites

  • A Twilio account: Sign up
  • Twilio WhatsApp Sandbox (for demos) or a production WhatsApp-enabled sender

​
Setup

You’ll be prompted for:
  • Twilio Account SID (starts with AC...)
  • Twilio Auth Token
  • Twilio WhatsApp From number (for example whatsapp:+14155238886)
  • Default recipient phone number (optional)
WhatsApp is configured separately from first-run onboarding — use this setup command.

​
Option 2: Environment variables

​
Credentials

  1. Create or open a Twilio account.
  2. Enable WhatsApp Sandbox or a production WhatsApp sender.
  3. Copy Account SID and Auth Token from the Twilio Console.
  4. Set TWILIO_WHATSAPP_FROM to your WhatsApp-enabled sender.
  5. Set WHATSAPP_DEFAULT_TO as the default recipient.
From/to numbers are auto-prefixed with whatsapp: in delivery. No WhatsApp-specific agent tools are registered — this is a delivery channel only. Long messages are truncated to WhatsApp limits.

​
Verify

This calls the Twilio Account API to verify the credentials. It does not prove WhatsApp sender readiness for a specific destination.

​
Troubleshooting

​
Security

  • Treat Twilio auth tokens like passwords.
  • Prefer a dedicated Twilio project for OpenSRE.
  • Store credentials in .env or your secret manager — not in source control.