ADR-0020 — Relatório WhatsApp usa remetente central configurável¶

Data: 2026-08-24 Status: Aceito

Decisão¶

O destinatário é o telefone do owner registrado no onboarding. O remetente é a instância Lara/Evolution de um tenant central escolhido por configuração; nenhum número fica hardcoded. O rollout inicial pode usar o número comercial do Felipe, e o número oficial da Cadência o substitui futuramente sem alteração de código.

As entregas usam ledger próprio por relatório e canal. Mensagem confirmada é terminal; timeout ou resultado externo ambíguo vira unknown e bloqueia retry automático.

Por quê¶

Usar a instância do destinatário impediria o relatório para contas sem Lara pareada e misturaria identidade de marca com isolamento do cliente. Hardcode tornaria a troca de número um deploy. Retry automático poderia duplicar mensagens aceitas pelo provider.

Consequências¶

• A plataforma mantém uma instância remetente central pareada.
• Trocar o número exige somente pairing e configuração.
• WhatsApp e e-mail compartilham auditoria, mas mantêm transportes separados.
• O WhatsApp guarda hint de quatro dígitos; canais não telefônicos usam recipient_hint = NULL.
• Outcome unknown exige reconciliação manual.