Destinos do Verify

Quando você verifica um número de telefone, o país de destino decide como o código viaja: quais canais estão disponíveis ali, qual é tentado primeiro, se a verificação é permitida e qual idioma a mensagem usa por padrão. A página Destinations é onde você gerencia isso, uma linha por país. Destinatários apenas com e-mail não são afetados: um endereço de e-mail não tem país, então a configuração por país se aplica a verificações cujo destinatário inclui um número de telefone.

Todo país vem ativado com o roteamento de plataforma do Bird por padrão. Use esta página para desativar países que você não atende, reordenar canais ou fixar um remetente por país. Desativar destinos não utilizados também reduz a exposição ao bombeamento de SMS.

A página Destinations

Os países são agrupados por região, com um resumo de quantos estão ativados em cada região e um mapa. Cada linha mostra o país, sua ordem de canais efetiva, sob qual remetente cada canal envia e um botão de ativar/desativar. Filtre por status, região ou canal, ou pesquise pelo nome do país. Um país desativado mostra seus canais selecionados esmaecidos, para que você veja o que será usado ao ativá-lo.

O botão ativa ou desativa o país inteiro. Se um destinatário inclui um número de telefone em um país desativado, a verificação não resolve nenhum canal e a criação falha com 422. Um endereço de e-mail no mesmo destinatário não contorna o bloqueio. Ativar um país mantém suas escolhas de canais, ordem e remetentes. Um país ativado sem nenhum canal selecionado mostra No channels selected, e as verificações nele falham com 422 até que você escolha canais no painel de roteamento do país.

As alterações nesta página não são salvas imediatamente. O botão de ativar/desativar, Enable all e Disable all em uma região e as ações em massa descritas abaixo se acumulam em uma barra na parte inferior da página, que conta as alterações não salvas. Escolha Save changes para aplicá-las juntas ou Discard para descartá-las. Ao salvar, todas as alterações são aplicadas ou nenhuma é. Um salvamento que desativa um país ou ativa um destino de alto risco pede confirmação antes.

Com acesso de escrita a Verify settings, você pode alterar vários países de uma vez. Marque as caixas de seleção deles, ou a caixa de uma região para selecionar todos os países dela. A seleção é mantida quando você altera a pesquisa ou os filtros. Confira a contagem de selecionados antes de escolher uma ação:

• Status: escolha Turn on ou Turn off para os países selecionados.
• Channels: cada canal mostra quantos dos países selecionados o usam e um interruptor que fica parcialmente ativado quando eles diferem. Ative ou desative um canal e escolha Apply. Um canal que você não alterar mantém a configuração atual de cada país, e o botão de desfazer ao lado de um interruptor o restaura. As alterações se aplicam aos países selecionados que oferecem o canal.
• Channel order: arraste os canais para a ordem em que Bird deve tentá-los e escolha Apply. Um país que não oferece um canal o ignora.

Ativar um canal também ativa os países selecionados que o oferecem. Os remetentes continuam sendo configurações por país no painel de roteamento.

Roteamento por país

Clique no nome de um país para abrir o painel de roteamento dele:

• Channel order: arraste os canais para definir a ordem em que Bird os tenta para este país, por exemplo SMS antes de WhatsApp. A verificação percorre a lista até que um envio tenha sucesso.
• Per-channel enable: desative um canal individual sem desativar o país. Canais que Bird não disponibilizou em um país não podem ser ativados; a plataforma define esse limite por país. O canal de voz começa desativado; ative-o aqui em cada país onde você quer que os códigos sejam lidos em uma ligação telefônica.
• Per-channel sender: escolha o remetente para e-mail, SMS ou WhatsApp neste país. Herde o padrão da sua configuração, escolha uma identidade gerenciada pela Bird ou use seu domínio de e-mail verificado, um Sender ID SMS ou um número WhatsApp conectado com um template de autenticação aprovado. A escolha por país prevalece sobre o padrão da configuração. Um Sender ID SMS específico de um país não usa o fallback de remetente padrão.

Onde WhatsApp não consegue entregar um código de verificação

O remetente compartilhado de WhatsApp do Bird não entrega códigos de verificação para Bangladesh, Egito, Índia, Indonésia, Iraque, Cazaquistão, Kuwait, Malásia, Marrocos, Nepal, Nigéria, Omã, Paquistão, Arábia Saudita, África do Sul, Sri Lanka, Ucrânia ou Emirados Árabes Unidos. WhatsApp ainda aparece na ordem de canais desses países e você ainda pode movê-lo para o topo, mas o envio é recusado quando o Verify chega a esse canal, e a verificação continua pela lista.

A tentativa recusada é registrada como qualquer outra falha, com o motivo channel_restricted, e assim um evento verify.attempt.undelivered informa por que WhatsApp não entregou. Veja Eventos e webhooks.

Mantenha pelo menos um outro canal ativado nesses países. Uma verificação cujo único canal é WhatsApp não tem para onde continuar, então a criação falha com 422.

Por que desativar um país

Esquemas de bombeamento de SMS disparam envios de código de verificação para números em países que sua empresa não atende, consumindo saldo da carteira. Se o seu produto atende um conjunto conhecido de mercados, desative o restante. Os limites de plataforma do Verify oferecem outra barreira, mas um país desativado não gera cobranças de entrega.

Próximos passos