Códigos de verificação de Anguilla (+1 264): checklist, passos da API e soluções

Checklist de pré-voo: o que deve estar pronto antes do primeiro pedido para Anguilla?

Percorra esta lista uma vez e o primeiro teste ao vivo costuma sair limpo:

• Uma chave de API. Crie-a no console do desenvolvedor; as chaves têm o prefixo or_live_ e uma conta pode ter até 10, então dê uma chave própria ao staging e outra ao CI.
• Saldo na carteira. Um rápido GET /api/v1/balance no início de uma suíte faz a execução falhar cedo, em vez de no meio do caminho.
• O id de país correto. Anguilla é ai na API. Esse código de duas letras é fácil de confundir com um rótulo "AI" em outro ponto de um arquivo de configuração, então guarde-o em uma constante com nome.
• O id do serviço. Pegue-o em GET /api/v1/services em vez de adivinhar um slug.
• Um endpoint de webhook (opcional). Registre-o no console, guarde o segredo e decida como o handler encontra o teste que está esperando.
• Um campo de telefone que aceite +1 fora dos EUA. É o item que as equipes mais descobrem tarde demais; a próxima seção explica o motivo.

Se quiser montar tudo antes de gastar qualquer valor, peça ao suporte para mudar uma conta de desenvolvimento para sandbox, que devolve números e códigos simulados.

Por que um número +1 264 atrapalha a validação de telefone?

Anguilla faz parte do Plano de Numeração Norte-Americano (NANP), portanto seus números compartilham o código de país +1 com os Estados Unidos, o Canadá e uma longa lista de territórios caribenhos. O que identifica a ilha é o código de área 264: um número de Anguilla é +1, depois 264, depois sete dígitos, ou seja, dez dígitos após o +1 no total. Dentro do NANP, o prefixo de tronco nacional é 1, e é por isso que a mesma linha pode aparecer como 1-264-xxx-xxxx em materiais locais.

Esse código compartilhado gera um conjunto conhecido de bugs:

• formulários que tratam todo número +1 como americano e tentam associá-lo a um estado dos EUA;
• seletores de país que gravam "US" para qualquer coisa que comece com +1, o que distorce as análises e as consultas de política de SMS;
• validadores que rejeitam códigos de área que não reconhecem.

Armazene o número em E.164 como +1264 seguido do número de assinante de sete dígitos e deduza a região pelo prefixo completo com uma biblioteca de numeração mantida, e não apenas pelo código de país. O inglês é a língua oficial, então os textos de verificação nesta rota normalmente chegam no modelo em inglês do serviço, o que mantém simples a extração do código. As equipes testam aqui quando lançam produtos no Caribe Oriental, atendem clientes de turismo e hotelaria, ou simplesmente querem comprovar que o tratamento de NANP funciona além dos cinquenta estados.

Passo a passo: pedindo um número de Anguilla pela API

Toda chamada vai para https://otproute.com/api/v1 com a chave em um cabeçalho Bearer.

1. Confirme a rota com GET /api/v1/countries e guarde a resposta em cache por um dia.
2. Peça o preço ao vivo: GET /api/v1/prices?country=ai&service=<id>. Preços e disponibilidade mudam ao longo do dia, então consulte a cada execução em vez de fixar valores no código.
3. Crie a ativação com POST /api/v1/activations e o corpo {"service": "<id>", "country": "ai"}. A resposta traz um id de ativação e o número +1 264.
4. Digite o número na tela de cadastro ou de login do produto que você está testando.
5. Aguarde activation.sms_received no seu webhook ou faça polling em GET /api/v1/activations/{id} a cada poucos segundos; o limite de 300 requisições por minuto deixa bastante folga.
6. Se o teste for abortado, libere o pedido com POST /api/v1/activations/{id}/cancel para que o valor retido volte para a carteira.

A referência completa de requisições e respostas está na documentação da API.

Quais serviços podem receber códigos em uma rota de Anguilla?

A rota de Anguilla lista atualmente mais de 600 serviços. Entre os populares no retrato de hoje estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Microsoft & Outlook, Amazon, Discord, LinkedIn, Uber e Airbnb. Aplicativos de viagem e de transporte costumam ser importantes para equipes que atendem visitantes da ilha.

Trate essa lista como ponto de partida, não como promessa: o estoque de qualquer rede de roteamento de OTP muda ao longo do dia, e é justamente por isso que o endpoint de preços informa a disponibilidade ao vivo para cada par de serviço e país.

Como quem não programa executa o mesmo teste pelo painel?

Gerentes de produto e equipes de suporte não precisam da API. Depois de entrar, abra o OTP Gateway, escolha Anguilla e o serviço, confira o preço exibido antes de pedir e confirme. O número aparece com uma contagem regressiva; cole-o no app e o código surge na mesma tela quando o SMS chegar. Um botão de cancelar fica ao lado do pedido, caso os planos mudem. Para trabalho de regressão repetível, nosso guia de testes de QA mostra como as equipes dividem as verificações manuais das automatizadas.

Solução de problemas: o código de Anguilla não chegou

Percorra estes pontos antes de abrir um chamado:

• Deixe a janela correr. Uma ativação permanece aberta por 20 minutos. Pedir um segundo número um minuto depois do primeiro só divide a sua atenção.
• Verifique a aceitação. Alguns serviços recusam números virtuais ou aplicam regras de risco próprias a números novos. Se o formulário de cadastro rejeitar o número de cara, cancele e escolha outra rota.
• Tente mais tarde ou troque de rota. A disponibilidade em uma rota de ilha pequena muda; tentar de novo mais tarde, ou testar o mesmo fluxo em outro país, costuma resolver.
• Evite loops apertados. Refazer pedidos em loop consome o limite de requisições e pode deixar o serviço de destino mais desconfiado, não menos.
• Confira o seu webhook. Confirme que o handler verifica X-OTPRoute-Signature e retorna sucesso; o guia de verificação HMAC cobre a comparação em tempo constante e a checagem de timestamp.

Seja qual for a causa, um código que nunca chega não custa nada: quando a janela fecha vazia, ou quando você cancela, o valor total volta automaticamente para a carteira.

Linhas de longo prazo, carteira e faturas

Embora Anguilla use o prefixo +1, ela não faz parte do produto de Números Dedicados. As linhas de longo prazo em autoatendimento são oferecidas apenas nos Estados Unidos e no Canadá, a partir de $1.95/month, com SMS de entrada, encaminhamento por webhook e chamadas pelo navegador; veja números virtuais. Se você precisa de uma linha duradoura em Anguilla, escreva para [email protected]; a viabilidade depende das regras locais.

A cobrança é uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Recarregue por cartão ou com USDT/USDC, e uma fatura em PDF chega por e-mail a cada recarga. Os preços atuais estão na página de preços. A OTP Route serve para testar e operar seus próprios produtos e contas, respeitando os termos de cada serviço e a nossa Política de Uso Aceitável.

Perguntas frequentes

Posso testar o fluxo de cadastro do meu app em Anguilla sem um chip local?

Sim. Peça um número +1 264 de uso único no OTP Gateway, digite-o no seu app e leia o código no painel ou pela API.

Qual id de país a API da OTP Route usa para Anguilla?

Anguilla é ai. Passe-o como valor de country nas requisições de preços e de ativações.

Um número +1 264 é tratado como um número dos EUA?

Não deveria. Ele compartilha o código +1, mas o código de área 264 pertence a Anguilla, então a detecção de região precisa olhar o prefixo completo.

Quanto custa um código de verificação de Anguilla?

Os códigos começam em $0.20 por código. O valor exato depende do serviço e é exibido no painel e devolvido pelo endpoint de preços antes de você pedir.

O que acontece se nenhum SMS chegar ao número?

Nada é cobrado. Se a janela de 20 minutos fechar sem um código, ou se você cancelar antes, o valor total volta para a sua carteira.

Posso manter um número de Anguilla para logins futuros?

Não em autoatendimento. Os números de longo prazo são um produto dos EUA e do Canadá; para qualquer outro caso, escreva para a equipe e pergunte.

Dá para montar os testes de Anguilla antes de recarregar a carteira?

Sim. Mediante pedido, uma conta de desenvolvimento pode ser movida para sandbox, que devolve números e códigos simulados para testes de ponta a ponta.

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.