Recupere falhas sem duplicar SMS
A mesma chave e o mesmo conteúdo retornam o resultado original. A mesma chave com conteúdo diferente gera conflito.
Timeout não autoriza uma nova intenção
Repita exatamente o mesmo corpo e a mesma Idempotency-Key. Gerar uma chave nova pode criar um segundo SMS.
Repetição de públicos e modelos
Criar/arquivar público, importar membros e criar/publicar modelo aceitam Idempotency-Key opcional com 8 a 128 caracteres: letras, números, dois-pontos, sublinhado ou hífen. Sem header, não há deduplicação.
No SDK, passe { idempotencyKey } nas opções do comando e reutilize a chave e os dados da intenção original. O SDK não tenta novamente automaticamente. Replay devolve o resultado original, inclusive contagens e revisão, não o estado atual do recurso.
Payload ou ator diferente com a mesma chave retorna 409 idempotency_conflict; chave inválida retorna 422. Esses recibos não estendem a garantia a cancelar agenda, revogar chave ou editar webhook.
Erros seguros
- Preserve x-request-id para investigação.
- Não registre chaves, corpo de OTP ou telefone completo.
- Trate conflitos de idempotência como erro de programação, não como falha transitória.
- No console, environment_unavailable (503) pode indicar preparação pendente. Preserve a sessão e a intenção; não gere outra cobrança, credencial ou SMS para contornar o erro.
- tenant_policy_pending (503) indica ausência de política no ambiente. Pagamento conciliado e entrega da política são etapas distintas; não é pedido de aprovação comercial manual.