Configuração por país

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 Countries é 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 Countries

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 ou canal, ou pesquise pelo nome do país. Um país desativado ainda mostra sua ordem de canais esmaecida, para que você veja o que a reativação restaura.

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. Reativar limpa a marcação de desativado em vez de fixar "on", de modo que o país segue o roteamento de plataforma do Bird. As fixações de ordem de canais e remetente sobrevivem ao botão.

Roteamento por país

Clique em uma linha para abrir o painel de roteamento do país:

• Ordem de canais: 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.
• Ativação por canal: 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.
• Remetente por canal: 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 por 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 Egito, Índia, Indonésia, Malásia, Nigéria, Paquistão, Arábia Saudita, África do Sul 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 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