Integração oficial com WhatsApp Business API.

• BSP oficial (Meta)

  Gupshup + Zenvia

• Webhook normalizado

  payload canonical

• Portabilidade suportada

  troca BSP sem re-onboarding

POST https://<tenant>.interaflow.com.br/webhooks/whatsapp
Content-Type: application/json
X-Interaflow-Signature: sha256=...
X-Interaflow-Channel-Source: gupshup   # ou baileys, zenvia, cloud-api

{
  "event": "message.inbound",
  "channel": "whatsapp",
  "tenant_id": "tn_x9k",
  "conversation_id": "conv_5f3b2a",
  "from": { "phone": "+5511998877665", "name": "Ana" },
  "to":   { "phone": "+5511999990001", "waba_id": "1098..." },
  "message": {
    "type": "text",
    "text": "preciso trocar o horário",
    "timestamp": 1745070600
  },
  "session": { "window_expires_at": 1745157000 }
}

• 6

  RETRIES ANTES DE DLQ

• 100k

  TIER MÁX (META) / DIA

• 24h

  JANELA DE SESSÃO (META)

• 30d

  RETENÇÃO DE LOG

Fonte dos prazos 2–72h HSM e tiers de volume: documentação oficial do Meta. Arquitetura de retry e DLQ descrita também em /integracoes (outbox pattern compartilhado).

• Atendimento reativo (SAC) — janela de 24h é o seu amigo

  Quem usa:Operação de suporte / SAC que recebe cliente no WhatsApp, atende em fila humana com apoio de IA, e fecha na janela de sessão (sem HSM) sempre que possível.

  −18%vs. chat humano-só

  TMA PÓS-COPILOTO

  1. Cliente manda mensagem no número oficial (WhatsApp Business API via BSP).
  2. Interaflow recebe via webhook, normaliza pro payload canonical, aloca na fila Suporte.
  3. Agente atende no painel unificado — histórico, últimas interações, deal/ticket do CRM.
  4. Conversa fecha dentro das 24h → zero custo de HSM, só tarifa de sessão do BSP.
  5. Reabertura D+2 pelo flow builder usa HSM Utility aprovado, quando precisa.

  Mix de mensagens numa conversa típica

  • Sessão (24h) 85%
  • HSM Utility (reabertura) 12%
  • Transferência p/ outro canal 3%

• Outbound transacional — HSM Utility dentro do flow builder

  Quem usa:Operação que precisa avisar cliente (pedido enviado, boleto vencendo, consulta confirmada) — caso de uso Utility do Meta, não Marketing.

  72%+48pp vs. SMS

  TAXA DE LEITURA HSM UTILITY

  1. Evento externo (ERP, agendamento, cobrança) chega via webhook ou API no Interaflow.
  2. Flow builder dispara template HSM Utility aprovado (ex: pedido_enviado + variáveis).
  3. Cliente responde em até 24h → abre janela de sessão, bot ou humano resolve sem novo HSM.
  4. Se não responder, régua de D+2 e D+5 com HSM Utility diferentes (reforço, lembrete).
  5. Dashboard de canal mostra taxa de entrega, leitura e resposta por template.

  Distribuição por categoria HSM

  • Utility 78%
  • Authentication (2FA, OTP) 18%
  • Marketing 4%

• Outbound marketing — campanha HSM com opt-in explícito

  Quem usa:Marketing / growth que roda campanha promocional (lançamento, reativação) em lista opt-in.

  12%vs. 2–3% e-mail

  CTR MÉDIO HSM MARKETING

  1. Lista opt-in (vinda do CRM via integração) importada como mailing de campanha.
  2. Template HSM Marketing aprovado pelo Meta com botões CTA (Quero / Mais tarde / Não quero).
  3. Campanha respeita rate limit do tier; "Não quero" entra em supressão automática.
  4. Respostas orgânicas (dentro da janela de 24h) caem em fila específica — atendente vende.
  5. Relatório cruza template × tier × horário × CTR × conversão.

  Mix de resposta da campanha

  • Clicou CTA positivo 55%
  • Respondeu orgânico 18%
  • Não interagiu 25%
  • Opt-out 2%

Números ilustrativos baseados em benchmark de mercado (Meta Business + relatórios públicos de BSP). Serão substituídos por case Interaflow real com cliente autorizado.