Comece aqui

Modo de teste

Uma aplicação test executa o mesmo contrato HTTP usado no modo live, com entrega simulada. O modo vem da chave da aplicação.

Nesta página

Código de teste

Corpo do envioCódigo para verificar
code omitido ou vazio000000
"code": "1234"1234

Código próprio também vale em test: informe de 4 a 10 dígitos como string. Não substitua um código próprio por 000000 ao verificar.

JSON
{"to":"+5531999999999","code":"1234","locale":"pt-BR"}

O código não aparece nas respostas de envio ou status, mesmo no modo de teste.

Entrega simulada

O envio começa como queued. Quando o processamento de teste termina, o status fica read, o canal fica sandbox e sent_at, delivered_at e read_at recebem timestamps.

Nenhuma mensagem chega ao telefone. A verificação continua independente: uma entrega simulada pode ter verification: pending.

Cenários para validar

  • Acerto na primeira tentativa: valid: true, verification: verified, attempts_left: 0.
  • Código incorreto: HTTP 200, valid: false, uma tentativa a menos.
  • Cinco erros: verification: locked.
  • Após expires_at: verification: expired.
  • Verificar novamente após o sucesso: valid: false e verification: verified.
  • Repetir o corpo e a chave de idempotência: o mesmo ID de envio.

Envios test não consomem a cota grátis nem créditos. Os limites de requisição continuam aplicáveis.

Abrir painel da aut2fa

Buscar na documentação

Digite uma palavra para procurar nos guias e na API.

Use as setas para percorrer os resultados. Enter abre a página. Esc fecha a busca.