Sandbox não é um desconto em produção
A Sandbox do Mandaí é um ambiente isolado. Ela não chama operadoras, não alcança destinatários reais e não consome a capacidade mensal de Produção. As chaves, mensagens e evidências permanecem separadas para impedir que um teste seja confundido com tráfego real.
Essa propriedade torna a Sandbox útil para integração contínua. Um cenário pode pedir um resultado determinístico, observar a transição de estado e validar o webhook sem depender de cobertura móvel ou de um aparelho físico.
O que deve ser testado
Uma suíte mínima cobre mais do que o caminho feliz:
- aceitação de uma intenção válida;
- repetição com a mesma Idempotency-Key;
- rejeição de payload incompatível com a intenção original;
- resultado entregue, falha terminal, atraso e estado inconclusivo;
- verificação da assinatura do webhook sobre o corpo bruto;
- deduplicação do mesmo evento recebido mais de uma vez.
Também vale confirmar que uma chave de Sandbox é recusada na origem de Produção e vice-versa. Essa fronteira reduz o risco de um segredo copiado para a configuração errada liberar tráfego inesperado.
Idempotência precisa sobreviver ao timeout
O teste mais importante acontece quando o cliente perde a resposta. A aplicação envia uma intenção, simula timeout e repete exatamente o mesmo comando com a mesma chave. O resultado correto é recuperar a mensagem original.
Gerar outra chave a cada retry desfaz essa proteção. A chave deve nascer com a intenção de negócio e permanecer associada a ela até que a aplicação conheça o resultado da aceitação.
Da Sandbox para Produção
Promover uma integração significa trocar explicitamente origem e credencial, manter o mesmo contrato e habilitar o plano mensal. Produção exige política vigente, capacidade disponível e cobertura operacional saudável; não há admissão comercial manual. O console mostra a quantidade de SMS contratada, consumida e disponível, além da data de vencimento.
No Mandaí, a janela de dias úteis, das 7h às 19h no horário de Brasília, refere-se à reposição operacional. Ela não garante horário de despacho pela API ou entrega pela operadora. Aceitação da intenção, reconhecimento do provedor e entrega final continuam sendo evidências distintas.
Teste o mesmo caminho usado pelo produto
Dashboard, SDK, API e chat de IA convergem para o mesmo comando canônico. Isso permite validar na Sandbox o caminho que depois cobrará créditos em Produção. A melhor suíte não testa uma imitação do envio: testa a mesma máquina de estados com um adaptador determinístico no lugar da operadora.