Testando fluxos de verificação +1 268 quando o seu formulário supõe que todo +1 é americano

Por que os números de telefone de Antígua e Barbuda atrapalham tantos formulários de cadastro?

A nação de duas ilhas está dentro do Plano de Numeração Norte-Americano, então os seus números começam com o mesmo +1 dos telefones de Nova York ou Toronto. Muitas páginas de checkout e telas de onboarding veem esse 1 inicial, classificam em silêncio o visitante como um cliente americano, mostram a bandeira errada e aplicam regras escritas para operadoras dos EUA. Ninguém percebe até que um hóspede que reserva uma villa em St. John's, ou um cliente local de uma fintech regional, relata que o código nunca chegou.

Reproduzir o bug é a parte difícil. É improvável que a sua equipe de QA tenha um chip de Antígua, e pegar emprestado o celular de um colega em roaming é lento e deixa tráfego de teste em um aparelho pessoal. Um número +1 268 para testes do OTP Gateway dá uma rota real para essa área de numeração, por exatamente um código de verificação, o que basta para confirmar que o formulário, o modelo de SMS e a detecção de país se comportam bem.

Como devemos armazenar e normalizar um número +1 268?

Trate o código de área 268 como o sinal do país, e não o +1. Algumas regras mantêm os seus dados limpos:

• Forma canônica: salve em E.164 sem espaços, por exemplo +1268 seguido do número de assinante de sete dígitos, onze dígitos depois do sinal de mais.
• Dígito de tronco: quem liga de outras áreas do NANP disca um 1 antes do código de área. Quando você guarda o número em E.164, esse 1 já é o código do país, então nunca adicione um segundo.
• Entrada local curta: os moradores costumam digitar apenas os sete dígitos locais. Se o usuário escolheu Antígua e Barbuda em um seletor de países, acrescente +1268 no servidor em vez de rejeitar a entrada.
• Consulta de região: mapeie o prefixo 268 para o código ISO AG na sua biblioteca de telefones, para que a análise de dados e as regras antifraude não coloquem esses usuários no mesmo grupo dos Estados Unidos.

O inglês é o idioma oficial, então as mensagens de verificação costumam chegar em inglês, embora alguns apps sigam o idioma definido na conta ou no aparelho.

Quais apps podemos verificar hoje em uma rota de Antígua e Barbuda?

A disponibilidade é informada ao vivo e muda ao longo do dia, mas o snapshot atual deste país inclui WhatsApp, Telegram, Google (Gmail e YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, Amazon, Uber, Airbnb e Netflix. No total, a rota lista mais de 700 serviços.

Como a economia da ilha depende muito do turismo, os fluxos de viagem, de transporte por aplicativo e de reserva de estadias curtas são os que as equipes mais querem exercitar aqui. Lembre-se de que cada serviço decide por conta própria se aceita números virtuais, e os seus termos continuam valendo para toda conta que você verificar.

Como é a sequência da API para o país `ag`?

Os desenvolvedores podem automatizar todo o fluxo em https://otproute.com/api/v1 com uma chave Bearer (prefixo or_live_) criada no console do desenvolvedor:

1. Leia a tarifa atual com GET /api/v1/prices?country=ag&service=whatsapp, trocando pelo id do serviço de que você precisa.
2. Crie o pedido com POST /api/v1/activations e o corpo JSON {"service": "whatsapp", "country": "ag"}. A resposta traz o número e um id de ativação.
3. Envie esse número no app em teste.
4. Espere o evento activation.sms_received no seu webhook ou, se preferir buscar, faça polling em GET /api/v1/activations/{id}.
5. Vai abandonar uma execução? Envie POST /api/v1/activations/{id}/cancel e o valor reservado é liberado para a carteira na hora.

No lado do webhook, confira o cabeçalho X-OTPRoute-Signature calculando o HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint e recuse timestamps antigos. Uma conta pode ter até 10 chaves e 5 endpoints de webhook a 300 requisições por minuto. A documentação da API e o nosso guia sobre assinatura de webhooks de OTP cobrem os detalhes desta API de verificação por SMS.

Um colega de suporte ou de operações pode fazer isso sem escrever código?

Sim. Depois de criar uma conta com um código por e-mail ou o login do Google, ele recarrega a carteira, abre o OTP Gateway, escolhe o serviço e Antígua e Barbuda e vê o preço antes de confirmar. O número aparece na tela; ele o cola no app, e o código recebido aparece ao lado do pedido.

A ativação fica aberta por 20 minutos. Você só é cobrado quando um código chega; se a janela terminar vazia, ou se o pedido for cancelado antes, o valor total volta para a carteira automaticamente.

O código não chegou. O que devemos tentar a seguir?

Um número silencioso geralmente significa que o serviço filtrou a rota ou está limitando as tentativas, e não que a sua integração esteja quebrada. Siga com calma:

• Deixe a janela de 20 minutos terminar; o reembolso acontece sem nenhuma ação da sua parte.
• Não dispare novos pedidos em um loop apertado. Espace as novas tentativas e tente de novo mais tarde ou por outra rota de serviço.
• Confirme que o app aceita números virtuais; alguns os recusam por política.
• Verifique se o número chegou ao app completo, em formato E.164, e não em uma versão local truncada.

A nossa nota sobre como reduzir falhas na entrega de OTP aprofunda as escolhas de roteamento de OTP.

Existe um número de longo prazo de Antígua e Barbuda, e como funciona a cobrança?

Não existe linha de longo prazo em autoatendimento para este país. Os Números Dedicados são um produto dos Estados Unidos e do Canadá a partir de $1.95/mês, com SMS de entrada e de saída e chamadas pelo navegador. Se você realmente precisa de uma linha antiguana duradoura, escreva para [email protected]; se é possível providenciar depende das regras locais e não é prometido.

O pagamento funciona por uma única carteira pré-paga em USD, sem assinatura nem nível a escolher. Recarregue-a por cartão ou com USDT/USDC, e cada recarga gera uma fatura em PDF por e-mail. As tarifas estão na página de preços, e uma conta de desenvolvimento pode ser mudada para sandbox sob solicitação, de modo que números e códigos simulados permitam ensaiar a integração sem gastar o saldo da carteira.

Perguntas frequentes

Posso testar o cadastro de Antígua e Barbuda do meu app sem um chip local?

Sim. Peça um número +1 268 para o serviço desejado pelo OTP Gateway e leia o código no painel ou pela API, sem nenhum aparelho na ilha.

+1 268 é o mesmo que um número de telefone dos EUA?

Ele compartilha o código de país 1 com os Estados Unidos, mas o código de área 268 pertence a Antígua e Barbuda, então a sua biblioteca de telefones deve mapeá-lo para o código ISO AG.

Qual é o id de Antígua e Barbuda na API da OTP Route?

Use ag no campo country ao chamar POST /api/v1/activations ou consultar GET /api/v1/prices.

Quanto custa um número de verificação de Antígua e Barbuda?

Os códigos do OTP Gateway começam em $0.20 por código; o valor exato depende do serviço e é mostrado ao vivo antes de você pedir.

Pago se o WhatsApp nunca enviar o código?

Não. Se nenhum SMS chegar ao número em 20 minutos, ou se você cancelar antes, a cobrança total é reembolsada à sua carteira.

Posso manter um número de Antígua por meses?

Não como produto em autoatendimento; os Números Dedicados de longo prazo são oferecidos apenas nos Estados Unidos e no Canadá. Você pode escrever para [email protected] para perguntar sobre outras opções.

Há regras sobre o que posso verificar?

Sim. Use os números apenas para as suas próprias contas legítimas e testes, siga os termos de cada serviço e respeite a Política de Uso Aceitável da OTP Route.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.