Integração confiável

Uma integração de produção deve assumir que redes falham, respostas podem se perder e provedores têm latência variável.

Estratégia recomendada

1. Gere uma Idempotency-Key estável para cada mensagem lógica.
2. Use Prefer: respond-async em cargas de maior volume.
3. Persista providerMessageId, outreachId e o status retornado.
4. Consulte o status com backoff quando o resultado de negócio depender da entrega.
5. Repita apenas erros transitórios e respeite Retry-After em respostas 429.