---
title: "WhatsApp"
description: "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
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
TWILIO_ACCOUNT_SID=AC...
TWILIO_AUTH_TOKEN=your_auth_token
TWILIO_WHATSAPP_FROM=whatsapp:+14155238886
WHATSAPP_DEFAULT_TO=+1234567890
```

---

## Step 2: Verify

```bash
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
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.
