Skip to main content

Documentation Index

Fetch the complete documentation index at: https://opensre.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.