WhatsApp Business API — oficial, e sem te prender num BSP.

curl -X POST https://api.interaflow.com.br/v1/messages \
  -H "Authorization: Bearer $IF_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 9f2b-4821" \
  -d '{
    "to": "+5511998887777",
    "channel": "whatsapp",
    "template": "order_update",
    "vars": { "nome": "Ana", "pedido": "#4821" }
  }'

const res = await fetch("https://api.interaflow.com.br/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.IF_TOKEN}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "9f2b-4821",
  },
  body: JSON.stringify({
    to: "+5511998887777",
    channel: "whatsapp",
    template: "order_update",
    vars: { nome: "Ana", pedido: "#4821" },
  }),
});
const data = await res.json();
// { id: "wamsg_01HN...", status: "queued", bsp: "gupshup" }

import os, httpx

resp = httpx.post(
    "https://api.interaflow.com.br/v1/messages",
    headers={
        "Authorization": f"Bearer {os.environ['IF_TOKEN']}",
        "Idempotency-Key": "9f2b-4821",
    },
    json={
        "to": "+5511998887777",
        "channel": "whatsapp",
        "template": "order_update",
        "vars": {"nome": "Ana", "pedido": "#4821"},
    },
)
print(resp.json())
# {'id': 'wamsg_01HN...', 'status': 'queued', 'bsp': 'gupshup'}

Os três exemplos produzem exatamente a mesma chamada. A API é a verdade canônica, não o SDK. Ver todos os endpoints de WhatsApp → · Baixar OpenAPI →

• GA

  Send (outbound)

  POST /v1/messages

  Você chama a Interaflow pra enviar mensagem — sessão livre ou template HSM.

  Quando usar

  Envio transacional, resposta de chatbot, disparo ativo com template fora da janela.

  Atenção

  Fora da janela de 24h, só via template aprovado pelo Meta. Sessão livre dá 403.

• GA · HMAC

  Webhook inbound

  evento message.received

  A Interaflow chama o seu endpoint quando chega mensagem do cliente (texto, mídia, botão, reação).

  Quando usar

  Receber mensagem, disparar chatbot, abrir conversa no seu sistema.

  Atenção

  Seu endpoint precisa ser idempotente — retransmitimos em falha (retry + DLQ). Valide HMAC.

• GA · retry + DLQ

  Delivery callback

  eventos sent / delivered / read / failed

  A Interaflow chama o seu endpoint com o status de cada envio — enfileirado, entregue, lido, falhou.

  Quando usar

  Monitorar taxa de entrega e leitura, alertar em template com baixa conversão, auditar campanha.

  Atenção

  Meta não garante ordem — sua lógica tem que tolerar read chegando antes de delivered.

• UI + sync via BSP · CRUD API needs-release-flag

  Template (HSM)

  approval externa + evento template.updated

  CRUD de templates HSM — criar, editar, submeter pra aprovação do Meta, consultar status.

  Quando usar

  Preparar notificação proativa. Cada template é aprovado pelo Meta antes de poder ser enviado.

  Atenção

  Aprovação é do Meta, não da Interaflow — rejeição volta com motivo (ex: 'too promotional').

• Validar a ideia — Baileys em minutos

  Go-live em ~10 min com QR code. Zero onboarding.

  Você está validando caso de uso (chatbot novo, notificação nova, integração com CRM) e não quer gastar 3 dias em Business Verification. Conecta via Baileys (escaneia QR code, sobe o bridge), manda POST /v1/messages com o mesmo contrato de produção, consome webhook no seu endpoint. Migração pra BSP oficial depois é troca de credencial no painel — seu código não muda.

• Produção com BSP — Gupshup ou Zenvia

  Go-live típico em 2–3 dias. Template HSM aprovado pelo Meta.

  Volume real, Business Verification aprovada, tier do Meta definido. Escolhe o BSP (a Interaflow integra com os dois sem preferência), o BSP faz o onboarding no Meta, você sobe templates HSM no painel e dispara via API. O Outbox garante retry e DLQ no callback de delivery. Bom encaixe com CRM e integrações nativas (HubSpot, Salesforce).

• Cloud API direto — sem BSP intermediário

  3–5 dias com Business Verification. needs-release-flag.

  Meta Cloud API conectada direto, sem Gupshup/Zenvia no meio. Você tem engenharia pra cuidar do onboarding (Business Manager, Business Verification, WABA, registro do número) e prefere remover o BSP como elo. A superfície de API da Interaflow é a mesma — o que muda é quem fatura as conversas (Meta direto). needs-release-flag — Cloud API direto é roadmap. Ver pillar /whatsapp.