Verify log

O Verify log, exibido na página Verifications em Verify > Verifications, é o registro de todas as sessões de verificação do seu espaço de trabalho. As verificações mais recentes aparecem primeiro. Use-o para confirmar que uma verificação foi criada, acompanhar cada tentativa por canal e cada checagem, e inspecionar o tempo até a conversão e o custo de cada tentativa. O código de verificação gerado nunca é armazenado em texto simples nem exibido no painel.

A lista de verificações

Cada linha corresponde a uma sessão de verificação. As colunas são:

A lista é paginada com 25 verificações por página.

Pesquisa e filtros

A página oferece uma pesquisa por destinatário e três filtros acima de uma linha do tempo de volume. Os filtros se combinam para restringir a lista:

• Search by phone number: encontre um número de telefone exato do destinatário no formato E.164, como +14155550100.
• Status: filtre por Pending, Converted (verified), Failed ou Expired.
• Channel: filtre por canal de entrega (Email, SMS, WhatsApp, Telegram ou Voice).
• Date range: escolha um período predefinido ou selecione um intervalo personalizado no calendário ou na faixa da linha do tempo.

Quando nenhuma verificação corresponder aos filtros ativos, use Clear filters para redefinir a visualização.

Status

Uma verificação começa como Pending (pending) e passa uma única vez para um estado final:

Para entender como as transições de status e os motivos de encerramento interagem com os reenvios e o fallback de canal, consulte Envio de verificações.

Inspecionar uma verificação

Selecione qualquer linha para abrir o painel de detalhes da verificação. Ele organiza a sessão em três seções:

Resumo

O cabeçalho do resumo registra o resultado e a configuração da sessão:

• Outcome: em uma sessão convertida, a duração até a conversão (Converted in) e qual tentativa de checagem teve correspondência (por exemplo, Code matched on 1st check). Em uma sessão com falha, o número de checagens que falharam.
• Code: a quantidade de dígitos e o prazo de expiração configurados para a sessão.
• Channels used: todos os canais que tentaram fazer a entrega durante a sessão.
• Metadata: todos os pares de chave-valor enviados em metadata ao criar a verificação.

Linha do tempo do ciclo de vida

A linha do tempo ordena cada etapa da sessão, da criação à resolução:

• Channel attempts: cada envio do código de verificação (SMS, WhatsApp, Telegram, Voice ou Email), o remetente, o resultado da entrega (sent, delivered ou undelivered com o motivo do erro), o tempo decorrido até a entrega e o custo de cada tentativa. Enquanto a sessão está pendente, os canais de fallback planejados que ainda não foram acionados aparecem como próximas etapas.
• Code checks: cada chamada de POST /v1/verify/verifications/check e se o código correspondeu.
• Terminal state: o momento em que a sessão atingiu o status final.

Detalhamento de custos

Quando uma sessão tem tentativas cobradas, Cost breakdown agrupa as cobranças por canal e classe de remetente (Shared sender, Custom domain, Dedicated sender ou Managed sender), junto com o Total da sessão na moeda do seu espaço de trabalho.

A lista de verificações e as visualizações de detalhes estão disponíveis apenas no painel e não têm um endpoint API público de listagem ou leitura. Para acompanhar de forma programática a criação de verificações, a entrega de cada tentativa e a conversão, use a resposta da verificação do código síncrona e assine os eventos do Verify.

Próximos passos

• Eventos do Verify: receba entregas de webhook para os eventos verify.verification.* e verify.attempt.*.
• Envio de verificações: configure a validade do código, os limites de tentativas, os reenvios e o fallback entre vários canais.
• Destinos do Verify: ative os países de destino e personalize a ordem de fallback dos canais.