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

WhatsApp,
conversado no
Claude Code.

Bridge oficial WhatsApp Business Cloud API. Recebe webhooks, envia mensagens, áudios OGG Opus, documentos e reações — direto do terminal, com allowlist embutida e permission relay sanitizando secrets.

Cloud API
oficial Meta
v0.1.6
auditoria · 6 fixes
5 min
setup local
RJ
Cliente · Roberto J.
online · digitando…
14:31
preciso da minuta de hoje
14:30
Minuta pronta ✅ revisei prazos e citei art. 5º. Te mando o pdf?
14:32 ✓✓
minuta_2026-04-30.pdf
142 KB · enviado pelo Claude
via /skills/reply
§ 01 — capacidades

Tudo que a Cloud API entrega.
Nada que ela não entrega.

API oficial significa: limites de mensagens reais, templates HSM, opt-in/opt-out, conformidade com a política Meta. Sem hacks, sem suspensões.

recebimento

Webhook oficial /messages

Recebe text, image, audio (OGG Opus, transcrito), document, video, sticker, location e reactions. Verifica assinatura HMAC X-Hub-Signature-256 da Meta.

  • Texto, mídia, áudio, docs
  • Reactions (👍 ❤️ 😂 …)
  • HMAC verificação automática
  • Re-tries idempotentes
envio

Skills de resposta

O Claude chama skills tipadas — não monta JSON na mão.

  • reply.text(to, body)
  • reply.audio(to, opus)
  • reply.document(to, file)
  • reply.template(name)
segurança

Allowlist + permission relay

Só números autorizados acionam o Claude. Secrets nunca aparecem no contexto — são injetados pelo relay.

v0.1.6 · 6 fixes de auditoria
deploy

Self-hosted, hoje. Cloud, em breve.

Local via cloudflared/ngrok. Quando o Cloud abrir: Embedded Signup + webhook hospedado, Coexistence opcional pra rodar junto com o atendimento humano.

comparar self-hosted × cloud →
§ 02 — instalar

Cole as três linhas.
Pronto.

Você precisa de: token da WhatsApp Business Cloud API (Meta) + Phone Number ID + cloudflared instalado. O resto é o plugin.

  1. 1
    marketplace

    Adicionar marketplace RIA

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

    Instalar plugin WhatsApp

    /plugin install whatsapp@riasistemas
  3. 3
    tunnel

    Subir webhook local

    cloudflared tunnel --url http://localhost:8787
.env (exemplo)
WHATSAPP_TOKEN=EAAG…
WHATSAPP_PHONE_NUMBER_ID=12345…
WHATSAPP_VERIFY_TOKEN=um-segredo-qualquer
ALLOWLIST=+5511999992104,+5511988887777
§ 03 — faq

Perguntas que todo dev faz.

01É API oficial mesmo?

Sim. É a WhatsApp Business Cloud API oficial da Meta — o mesmo endpoint que parceiros enterprise usam. Sem reverse-engineering, sem bibliotecas não-oficiais, sem risco de banimento de conta, com SLA da própria Meta.

02Preciso de uma conta Business verificada?

Pra produção sim — qualquer integração Meta exige WABA. Pra testes, o Meta dá um número sandbox grátis dentro do app.

03E se eu não quiser rodar cloudflared?

Cloud (beta privado) hospeda o webhook na infra da RIA. Você só faz Embedded Signup com 5 cliques — entrar na fila pelo formulário do hub.

04Funciona com agentes não-Claude?

É um plugin Claude Code — usa MCP nativo. O webhook é HTTP padrão, então em teoria dá pra adaptar, mas a allowlist e o permission relay foram desenhados pro modelo do Claude Code.

05Tem custo?

Self-hosted é grátis, Apache-2.0. A Meta cobra suas próprias tarifas por conversa (template/utility/marketing). Cloud (RIA) terá pricing próprio quando abrir.

§ 04 — próximo passo

Cinco minutos.
Um terminal aberto.