Diretrizes Atuais

Trava de Chamadas

Envio só é permitido se existir interação recente (inbound) do contato.
Janela padrão: 12h (REQUIRE_INBOUND_MS).
Ativação: ENFORCE_INBOUND_FOR_SEND=true (ligada por padrão).
Bloqueios retornam HTTP 409 com BLOQUEADO_*.
Exceção controlada: categoria status/gerencial permite até 10 mensagens por contato a cada 5h sem inbound. Ajuste com STATUS_BYPASS_MAX e STATUS_BYPASS_WINDOW_MS.

Dica: para homologação, peça para o cliente enviar “oi” e teste o envio em seguida.

Mensagens & Filtros

Ignora status@broadcast, *@broadcast e mensagens de sistema (protocol/reaction/poll/stubs).
Auto-respostas limitadas por mensagem do usuário: MAX_AUTO_REPLIES_PER_MESSAGE (padrão 1).
Delay/cooldown configuráveis: KEYWORD_REPLY_DELAY_MS, KEYWORD_COOLDOWN_MS.
Keywords em ./config/keywords.json com hot-reload.

Logs JSON Lines com rotação por tamanho e endpoints REST.

Sessão

Status: Pronto

Envio

+55

Msg

Obs.: Envio é liberado com inbound recente (12h). Usando categoria status/gerencial, é permitido até 10 mensagens por contato a cada 5h sem inbound.

Logs

Arquivo

Linhas

Nível

Filtrar por Sessão

(sem dados)

Endpoints

Rota	Método	Descrição
/session/:id	POST	Inicia sessão
/session/:id/qr	GET	QR Code
/session/:id/status	GET	Status
/session/:id/send	POST	Envia mensagem (sujeito à trava de chamadas). Body: `{ to, text, category? }`. Para bypass controlado use `category: "status"` ou `"gerencial"`.
/session/:id	DELETE	Desconecta sessão
/sessions-remove	DELETE	Remove todos os tokens/credenciais
Logs
/logs/files	GET	Lista arquivos de log
/logs/tail?lines=200&file=bot-YYYY-MM-DD.log&level=info&session=SUA_SESSAO	GET	Últimas linhas (com filtros)
/logs/download?file=bot-YYYY-MM-DD.log	GET	Download do arquivo

Base URL atual: