> ## 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.

# WhatsApp

> Deliver investigation findings to WhatsApp via Twilio.

OpenSRE's WhatsApp integration delivers investigation findings to any WhatsApp number via Twilio's Messaging API.

<Note>
  This integration uses Twilio as the WhatsApp provider.
</Note>

***

## Prerequisites

* A Twilio account: [Sign up](https://www.twilio.com/try-twilio)
* Twilio WhatsApp Sandbox (for demos) or a production WhatsApp-enabled sender

***

## Step 1: Configure the integration

### Via CLI wizard (recommended)

```bash theme={null}
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:

```bash theme={null}
TWILIO_ACCOUNT_SID=AC...
TWILIO_AUTH_TOKEN=your_auth_token
TWILIO_WHATSAPP_FROM=whatsapp:+14155238886
WHATSAPP_DEFAULT_TO=+1234567890
```

***

## Step 2: Verify

```bash theme={null}
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:

```bash theme={null}
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.