Pular para o conteúdo principal

Módulo 2 — Canais WhatsApp

Requisitos: RF-FC-011 a RF-FC-025

Tipos de canal

TipoConexãoUso
unofficialQR code via Evolution APIMaioria dos casos, setup imediato
officialMeta Cloud API via Embedded SignupVolume alto, sem risco de ban

Status de canal

StatusDescrição
connectedFuncionando normalmente
disconnectedSem conexão, tentando reconectar
qr_pendingAguardando escaneamento do QR code
bannedNúmero banido pelo WhatsApp
initializingIniciando conexão

Rate limiting

Para proteger os números unofficial, o sistema aplica limite de 60 mensagens/minuto por canal. O delay entre mensagens em broadcasts pode ser configurado em modo inteligente (aleatório 3–30s) ou fixo.

Requisitos principais

  • RF-FC-012 — QR code exibido no painel web, atualizado a cada 60s
  • RF-FC-015 — Reconexão automática (3 tentativas) + notificação por email se falhar
  • RF-FC-019 — Estado de sessão da Evolution API persiste entre restarts do servidor
  • RF-FC-021 — Rate limiting: unofficial máx 60 msg/min por canal
  • RF-FC-025 — Fila de saída com retry automático (3 tentativas, backoff exponencial)