wehub-resource-sync
4b6817381b
CI (OpenClaw E2E) / openclaw test (push) Has been cancelled
CI / coverage-report (push) Has been cancelled
CI / test-kubernetes (push) Has been cancelled
CI / should-run-thorough (push) Has been cancelled
CI / test-thorough (cloudwatch-demo) (push) Has been cancelled
CI / test-thorough (flink-ecs) (push) Has been cancelled
CI / test-thorough (upstream-lambda) (push) Has been cancelled
CI / test-thorough (prefect-ecs-fargate) (push) Has been cancelled
Release / build-binaries (zip, opensre.exe, onefile, windows-latest, windows-x64) (push) Has been cancelled
Benchmark image — build + push to ECR (any adapter) / build + push (push) Has been cancelled
CI / quality (ubuntu-latest) (push) Has been cancelled
CI / test (tools-runtime) (push) Has been cancelled
CI / test (e2e-general) (push) Has been cancelled
CI / test (cli-runtime) (push) Has been cancelled
CI / test (e2e-provider-and-openclaw) (push) Has been cancelled
CI / test (integrations-and-misc) (push) Has been cancelled
Release / verify (push) Has been cancelled
Release / build-python-dist (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-15-intel, darwin-x64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, macos-latest, darwin-arm64) (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04, linux-x64) (push) Has been cancelled
Release / publish-release (push) Has been cancelled
Release / publish-main-release (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-checks (no-LLM) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Interactive Shell Live (PR + post-merge) / turn-live shard ${{ matrix.shard_index }} (push) Has been cancelled
Release / prepare (push) Has been cancelled
Release / build-binaries (tar.gz, opensre, onedir, ubuntu-22.04-arm, linux-arm64) (push) Has been cancelled
Synthetic Deterministic Tests / Synthetic offline (deterministic) (push) Has been cancelled
91 lines
1.9 KiB
Plaintext
91 lines
1.9 KiB
Plaintext
---
|
|
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.
|