Rriasistemas/claude-plugins
riasistemas/claude-plugins/whatsapp/ v0.1.7
live/WhatsApp Business Cloud API/Apache-2.0

WhatsApp,
conversational inside
Claude Code.

Official WhatsApp Business Cloud API bridge. Receives webhooks, sends messages, OGG Opus audio, documents, and reactions — straight from your terminal, with built-in allowlist and a permission relay that scrubs secrets.

Cloud API
official Meta
v0.1.6
audit · 6 fixes
5 min
local setup
RJ
Customer · Roberto J.
online · typing…
14:31
I need today's draft
14:30
Draft is ready ✅ I reviewed deadlines and cited art. 5. Should I send the PDF?
14:32 ✓✓
draft_2026-04-30.pdf
142 KB · sent by Claude
via /skills/reply
§ 01 — capabilities

Everything the Cloud API delivers.
Nothing it doesn’t.

Official API means: real message limits, HSM templates, opt-in/opt-out, full Meta policy compliance. No hacks, no suspensions.

receive

Official /messages webhook

Receives text, image, audio (OGG Opus, transcribed), document, video, sticker, location, and reactions. Verifies Meta’s HMAC X-Hub-Signature-256 automatically.

  • Text, media, audio, docs
  • Reactions (👍 ❤️ 😂 …)
  • Automatic HMAC verification
  • Idempotent retries
send

Reply skills

Claude calls typed skills — no hand-rolled JSON.

  • reply.text(to, body)
  • reply.audio(to, opus)
  • reply.document(to, file)
  • reply.template(name)
security

Allowlist + permission relay

Only authorized numbers reach Claude. Secrets never enter the context — they’re injected by the relay.

v0.1.6 · 6 audit fixes
deploy

Self-hosted today. Cloud soon.

Local via cloudflared/ngrok. When Cloud opens: Embedded Signup + hosted webhook, optional Coexistence to run alongside human support.

compare self-hosted × cloud →
§ 02 — install

Paste three lines.
Done.

You’ll need: a WhatsApp Business Cloud API token (Meta) + Phone Number ID + cloudflared installed. The plugin handles the rest.

  1. 1
    marketplace

    Add the RIA marketplace

    /plugin marketplace add riasistemas/claude-plugins
  2. 2
    install

    Install the WhatsApp plugin

    /plugin install whatsapp@riasistemas
  3. 3
    tunnel

    Run the local webhook

    cloudflared tunnel --url http://localhost:8787
.env (sample)
WHATSAPP_TOKEN=EAAG…
WHATSAPP_PHONE_NUMBER_ID=12345…
WHATSAPP_VERIFY_TOKEN=a-secret-token
ALLOWLIST=+15551234567,+15557654321
§ 03 — faq

Questions every dev asks.

01Is this really the official API?

Yes. It's Meta's official WhatsApp Business Cloud API — the same endpoint enterprise partners use. No reverse-engineering, no unofficial libraries, no risk of account bans, with Meta's own SLA.

02Do I need a verified Business account?

For production, yes — any Meta integration requires WABA. For testing, Meta provides a free sandbox number inside the app.

03What if I don't want to run cloudflared?

Cloud (private beta) hosts the webhook on RIA's infra. You only do Embedded Signup with 5 clicks — join the waitlist via the hub form.

04Does it work with non-Claude agents?

It's a Claude Code plugin — uses native MCP. The webhook is plain HTTP, so in theory it's adaptable, but the allowlist and permission relay were designed around the Claude Code model.

05Any cost?

Self-hosted is free, Apache-2.0. Meta charges its own per-conversation fees (template/utility/marketing). Cloud (RIA) will have its own pricing when it opens.

§ 04 — next step

Five minutes.
One terminal open.