Skip to main content

​
Overview

OpenSRE’s WhatsApp integration delivers investigation findings 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 not in the onboard Incident & Comms menu — 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 for automatic delivery after investigations.
From/to numbers are auto-prefixed with whatsapp: in delivery.

​
Investigation tools

No WhatsApp-specific investigation tools are registered. Delivery happens when an investigation finishes and WhatsApp is configured as a notify channel / default recipient.

​
Test with an investigation

Findings should arrive in WhatsApp as a plain-text message. Long reports 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.