Backend · Integrações

WhatsApp Cloud API

Envia texto e template aprovado pela API oficial da Meta, valida o webhook (GET e assinatura X-Hub-Signature-256) e normaliza as mensagens recebidas. Atendimento e notificação no WhatsApp sem intermediário.

WhatsApp · Meta · Webhook · 8 testes automatizados · Licença MIT · Criado por FlowCore Soluções LTDA

Como instalar

  1. Funciona onde você já roda Node 18+, Cloudflare Workers, Deno, Bun, Vercel e Netlify Functions. Zero dependência: só fetch e Web Crypto, que já vêm no runtime.
  2. Crie src/lib/whatsapp-cloud.ts Cole o código da aba Código.
  3. Use
    const wa = criarClienteWhatsApp({ token: env.WA_TOKEN, phoneNumberId: env.WA_PHONE_ID });
    await wa.enviarTemplate("11987654321", "pedido_confirmado", "pt_BR", [parametrosCorpo("Ana", "#1234")]);
    // webhook POST:
    if (!(await verificarAssinaturaWebhook(corpoBruto, req.headers.get("x-hub-signature-256"), env.WA_APP_SECRET))) return new Response(null, { status: 401 });
    const { mensagens } = parsearWebhook(JSON.parse(corpoBruto));
  4. Rode o teste junto O arquivo de teste (aba Teste) cobre 8 cenários. Copie para src/lib/ ao lado e rode:
    npm install -D vitest
    npx vitest run src/lib

Código no GitHub · Biblioteca de códigos

Mais em Integrações