Migre por evento de negócio, sem duplicar envios

1. Mapeie o contrato atual

• Identifique o evento que origina cada SMS e preserve sua chave de negócio.
• Mapeie autenticação, destinatário E.164, conteúdo, encoding e segmentos.
• Associe os IDs de mensagem e eventos de webhook à sua linha do tempo existente.

2. Valide sem duplicar tráfego real

• Use somente chave e destinos determinísticos da Sandbox nos testes.
• Teste repetição da mesma Idempotency-Key com o mesmo comando e conflito com corpo diferente.
• Valide assinatura, replay e tratamento de eventos repetidos ou fora de ordem.

3. Faça um corte explícito e preserve evidência

Antes do corte, contrate a capacidade em Uso e cobrança e confirme pagamento, quota e cobertura. Configure a chave de Produção fora do código e dos prompts.

Defina qual integração é responsável por cada evento novo. Reconcilie as tentativas em andamento no provedor original; não as reenvie automaticamente pelo Mandaí.

A idempotência do Mandaí não deduplica efeitos já emitidos por outro provedor. Um resultado unknown exige investigação, não troca de provedor como retry.

Em rollback, preserve o responsável e os IDs das tentativas já iniciadas. Troque somente os eventos novos que ainda não tiveram efeito.