Visão geral do Verify

Bird Verify confirma que um usuário controla um endereço de e-mail ou número de telefone. Peça a Bird para enviar um código de verificação de uso único, colete-o no seu app e pergunte a Bird se ele confere. O fluxo usa duas chamadas API: POST /v1/verify/verifications envia o código e POST /v1/verify/verifications/check o verifica. Os remetentes compartilhados de Bird não exigem registro de remetente nem configuração de template. E-mail, SMS e WhatsApp podem usar Bird Verify por padrão, Authifly ou um remetente do seu espaço de trabalho; Telegram usa sua própria conta de notificação verificada. Remetentes e identidade visual detalha a escolha.

Você cria uma verificação com um destinatário: um endereço de e-mail, um número de telefone ou ambos. O Bird gera um código de verificação numérico e o entrega pelos canais do destinatário. Um endereço de e-mail recebe o código por e-mail; um número de telefone recebe por SMS ou WhatsApp, na ordem e disponibilidade que a sua configuração de país define para o país de destino. O usuário digita o código no seu app, e você o envia ao endpoint de verificação, que responde success: true ou false com um motivo.

Uma verificação percorre um ciclo de vida curto: começa pending e termina verified (um código correto chegou a tempo), failed (tentativas erradas demais) ou expired (a janela expirou). A página Verifications mostra cada verificação e seu estado; cada estado e motivo é coberto em Enviando verificações.

No dashboard, o Verify é um dos apps do espaço de trabalho. Suas páginas e onde o guia de cada uma se encontra:

A página Verifications lista cada verificação no espaço de trabalho e abre o destinatário, o plano de canais e os detalhes de tempo de cada uma. Programaticamente, a resposta de verificação traz o estado atual da verificação. Assine os eventos do Verify para atualizações de criação, entrega e verificação bem-sucedida. Os endpoints de listagem e leitura estão disponíveis para o dashboard, mas não para a API pública.

O Verify entrega códigos por quatro canais. Qual deles o destinatário recebe depende do tipo de destinatário e, para números de telefone, da sua configuração de país.

Para um destinatário de telefone, WhatsApp é tentado primeiro e SMS atua como fallback na maioria dos países, embora alguns usem SMS primeiro por padrão. O Telegram fica depois de SMS e antes do e-mail na ordem de fallback da plataforma. Você pode alterar a ordem ou desativar um canal por país. Se um envio falhar, a entrega avança para o próximo canal do plano. Você também pode avançá-la quando um usuário relatar que o código não chegou; veja Enviar o código por outro canal. Remetentes e identidade visual mostra cada mensagem e os controles de remetente disponíveis.

Seu espaço de trabalho começa com os padrões de plataforma do Bird para o código em si (comprimento, validade), o limite de tentativas de verificação e o intervalo de reenvio. Cada um é ajustável no dashboard em Configure, e o comprimento do código também por solicitação; os valores e intervalos estão em Configurações de verificação. Acima desses ficam proteções contra abuso que você não configura: limites de envio e verificação por destinatário, listados em Proteções contra abuso. A mensagem do código usa por padrão o idioma do número de telefone do destinatário, uma de 40 traduções integradas, e options.language substitui isso por solicitação. Veja Idioma da mensagem.