Skip to main content
OpenSRE’s WhatsApp integration delivers investigation findings to any WhatsApp number via Twilio’s Messaging API.
This integration uses Twilio as the WhatsApp provider.

​
Prerequisites

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

​
Step 1: Configure the integration

opensre integrations setup whatsapp
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)

​
Via environment variables

Add to your .env file: 
TWILIO_ACCOUNT_SID=AC...
TWILIO_AUTH_TOKEN=your_auth_token
TWILIO_WHATSAPP_FROM=whatsapp:+14155238886
WHATSAPP_DEFAULT_TO=+1234567890

​
Step 2: Verify

opensre integrations verify whatsapp
This calls the Twilio Account API to verify the credentials.

​
Step 3: Test with an investigation

Trigger a real investigation against a bundled fixture: 
opensre investigate --input tests/e2e/kubernetes/fixtures/datadog_k8s_alert.json
Findings should arrive in WhatsApp as a plain-text message. Long reports are truncated to WhatsApp limits.

​
Troubleshooting

​
opensre integrations verify whatsapp errors

Missing account_sid TWILIO_ACCOUNT_SID is empty. Missing auth_token TWILIO_AUTH_TOKEN is empty. Twilio API check failed: 401 The SID/token pair is invalid.

​
Messages never arrive but verify passes

  • Ensure TWILIO_WHATSAPP_FROM is a valid Twilio WhatsApp sender (sandbox or production).
  • Ensure recipient uses international format (for example +1234567890).
  • For sandbox usage, join the Twilio sandbox from the destination WhatsApp number.