Visão geral do Verify

O Bird Verify confirma que um usuário controla um endereço de e-mail ou número de telefone. Peça ao Bird para enviar um código de verificação de uso único, colete-o no seu app e pergunte ao 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 do 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; o Telegram usa sua própria conta de notificação verificada, e uma chamada de voz vem de um número Bird escolhido para o destino. Remetentes e identidade visual detalha a escolha.

Como uma verificação funciona

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 o recebe por SMS, WhatsApp, Telegram ou chamada de voz, 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.

O app Verify no dashboard

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

Visibilidade

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.

Canais

O Verify entrega códigos por cinco 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. A voz não faz parte da ordem de fallback da plataforma, então um país só a usa depois que você a ativa ali, por exemplo para alcançar usuários que não conseguem receber mensagens de texto. 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.

Padrões e limites

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.

Próximos passos