Uso único ou longo prazo? Como escolher uma rota +1 787 para testes de verificação

Um projeto em Porto Rico deve usar o OTP Gateway ou um Número Dedicado?

Comece por quanto tempo o número precisa durar. O OTP Gateway emite um número +1 787 para exatamente um código, o que serve para um teste de cadastro, uma checagem de localização ou um job de CI que verifica uma vez e segue em frente. Um Número Dedicado é uma linha que você mantém, indicada para uma conta de staging que precisa fazer login de novo na semana seguinte ou para uma caixa de entrada de suporte compartilhada.

Para Porto Rico, a escolha é praticamente feita por você. Embora a ilha seja um território dos EUA, os números dela não fazem parte do estoque de Números Dedicados em autoatendimento; esse produto cobre os Estados Unidos e o Canadá, a partir de $1.95/mês. Se uma linha americana continental for aceitável para uma conta recorrente, a página de números virtuais explica as opções. Se você precisa especificamente de uma linha porto-riquenha de longo prazo, escreva para [email protected]; se isso pode ser providenciado depende das regras locais e não é garantido.

Quais chamadas da API de OTP de Porto Rico criam e leem uma ativação?

A API fica em https://otproute.com/api/v1 e espera chaves Bearer com o prefixo or_live_. O id do país Porto Rico é pr.

1. Busque os ids com GET /api/v1/services e GET /api/v1/countries, e guarde-os em cache a cada deploy.
2. Consulte o preço: GET /api/v1/prices?country=pr&service=<id> retorna o valor atual e mostra se há rota aberta.
3. Faça o pedido com POST /api/v1/activations, corpo {"service": "<id>", "country": "pr"}.
4. Coloque o número retornado no fluxo em teste.
5. Receba o código por activation.sms_received no seu webhook, ou faça polling em GET /api/v1/activations/{id}.
6. Cancele com POST /api/v1/activations/{id}/cancel se o job parar antes.

As chamadas de webhook trazem X-OTPRoute-Signature: t=<unix>,v1=<hex>. Recalcule o HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint, compare em tempo constante, recuse timestamps antigos e ignore eventos repetidos para um id de ativação que você já tratou. Cada conta tem 10 chaves, 5 endpoints de webhook e 300 requisições por minuto. O guia de integração da API de OTP aprofunda o assunto.

O que torna os números +1 787 e +1 939 complicados em formulários?

Porto Rico pertence ao Plano de Numeração Norte-Americano, então seus números parecem os de qualquer número americano: código de país 1, um código de área de três dígitos (787 ou o overlay 939) e sete dígitos, escritos em E.164 como +1787 ou +1939 mais sete dígitos.

Essa semelhança causa bugs reais. Alguns apps listam Porto Rico como um país próprio com código ISO PR, outros o incorporam aos Estados Unidos, e formulários de endereço podem esperar PR como valor de estado. Confirme que o seletor de país, o validador de telefone e os campos de endereço concordam entre si, e que um usuário que selecionar Porto Rico nunca seja informado de que o número +1 dele é inválido. Armazene os números em E.164 e derive a região pelo código de área, e não pelo +1 inicial.

Quais serviços podem receber códigos SMS OTP de Porto Rico?

A rota de Porto Rico atualmente oferece mais de 900 serviços. Entre os remetentes populares estão WhatsApp, Uber, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), Amazon, ChatGPT (OpenAI), Microsoft & Outlook, LinkedIn, Discord, Airbnb, Netflix e Telegram. A disponibilidade muda ao longo do dia, então confie na resposta da API no momento do pedido, e não em qualquer lista.

Sem código, abra o OTP Gateway no painel, escolha Porto Rico e um serviço, confirme o preço exibido e faça o pedido. O número de verificação de Porto Rico aparece com a contagem regressiva, e o código é exibido ao lado quando o SMS chega.

E se o código não aparecer em 20 minutos?

Cada ativação dura 20 minutos, e você só paga quando um código chega. Se a janela expirar vazia, ou se você cancelar, o valor integral volta para a carteira automaticamente.

Se os códigos porto-riquenhos não estiverem chegando:

• Dê à ativação a janela inteira antes de marcar o teste como vermelho.
• Tente de novo um pouco mais tarde, ou escolha outra rota de serviço.
• Confirme que o serviço aceita números virtuais; alguns os rejeitam, e o reembolso existe para absorver isso.
• Não dispare novos pedidos em um laço rápido; adicione um backoff exponencial entre as tentativas.

Para padrões mais amplos, leia como reduzir falhas na entrega de OTP.

Por que as equipes verificam fluxos em espanhol e em inglês para Porto Rico?

Espanhol e inglês são ambos oficiais, e o espanhol é o idioma que a maioria dos moradores usa no dia a dia. Isso faz de Porto Rico um lugar prático para checar um onboarding bilíngue: o SMS de verificação chega em espanhol quando o app está configurado em espanhol, a tela de digitação do código lida com texto acentuado e o template certo é enviado quando o usuário troca de idioma no meio do fluxo? A ilha usa o dólar americano e muitas empresas dos EUA já a atendem, então apps de pagamento, plataformas de entrega, marketplaces e bancos que ampliam um lançamento nos EUA costumam precisar de um número +1 787 para testes. Faça essas checagens em contas que você controla, siga os termos de cada serviço e respeite a Política de Uso Aceitável da OTP Route. Para automatizá-las, veja testes em CI/CD.

Como funcionam a carteira e o sandbox nos testes de Porto Rico?

Não há assinatura. Uma única carteira pré-paga em USD financia todos os pedidos, 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 e a cada compra de número. Antes de entrar em produção, peça para a sua conta de desenvolvimento ser mudada para sandbox, que retorna números e códigos simulados para que o fluxo completo de roteamento de OTP possa ser ensaiado sem gastar saldo. Quando estiver pronto, crie uma conta com e-mail e um código de 6 dígitos ou login com o Google, e ative a autenticação em dois fatores TOTP para a equipe.

Perguntas frequentes

Posso testar um fluxo de cadastro de Porto Rico sem um chip local?

Sim. Peça um número +1 787 no OTP Gateway, informe-o no seu app e pegue o código no painel ou pela API de verificação por SMS e pelos webhooks.

Porto Rico é tratado como Estados Unidos na API?

Não. Ele tem o próprio id de país, pr, que você usa nas consultas de preço e nas requisições de ativação no lugar do id dos EUA.

Posso comprar um Número Dedicado +1 787?

Não pelo painel. Os Números Dedicados em autoatendimento cobrem apenas os Estados Unidos e o Canadá; para uma linha porto-riquenha, escreva para [email protected] e pergunte.

O SMS de verificação virá em espanhol?

Isso depende do remetente e, muitas vezes, da configuração de idioma do app. Se o seu produto oferece os dois, teste o locale em espanhol e o em inglês.

Quais códigos de área posso ver em um número de Porto Rico?

Porto Rico usa 787 e 939. Qualquer que seja o que você receber, armazene em E.164 para manter os registros consistentes.

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

A partir de $0.20 por código. O preço exato de cada serviço vem de GET /api/v1/prices e do painel, e nada é cobrado se o código não chegar.

Quantos testes em paralelo posso executar?

A conta permite 300 requisições por minuto e 10 chaves. A maior parte desse orçamento vai para o polling, então os webhooks deixam mais folga para jobs em paralelo.

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.