Levando códigos de verificação argentinos (+54) para a sua integração

Quais são as quatro chamadas de API por trás de uma ativação +54?

Tudo fica sob https://otproute.com/api/v1 e se autentica com uma chave Bearer que começa com or_live_. As chaves são emitidas no console do desenvolvedor; uma conta pode ter até 10 delas e registrar 5 endpoints de webhook, com um teto de 300 requisições por minuto.

1. Cotar. Chame GET /api/v1/prices?country=ar&service=<id> para que o seu código saiba o custo ao vivo antes de comprometer saldo da carteira. O id de país da Argentina é ar.
2. Pedir. Envie POST /api/v1/activations com o corpo JSON {"service": "whatsapp", "country": "ar"}, trocando pelo id do serviço de que o seu teste precisar. A resposta traz um id de ativação e o número +54 para digitar no app em teste.
3. Esperar. Leia GET /api/v1/activations/{id} em um intervalo razoável ou deixe o webhook activation.sms_received avisar que o código chegou.
4. Liberar antes, se preciso. POST /api/v1/activations/{id}/cancel encerra uma ativação de que você não precisa mais e devolve o dinheiro à carteira.

Se quiser ver os ids antes de fixá-los no código, GET /api/v1/services e GET /api/v1/countries listam o que a plataforma oferece no momento. O material de referência completo está na documentação.

Como tornar confiável o receptor de webhook para códigos argentinos?

Cada entrega inclui um cabeçalho X-OTPRoute-Signature no formato t=<unix>,v1=<hex>. Reconstrua a string "<t>.<raw body>", calcule o HMAC-SHA256 sobre ela com o segredo daquele endpoint e compare o resultado com v1 usando uma função de tempo constante. Descarte qualquer requisição com timestamp antigo, porque uma assinatura velha, mas válida, é exatamente o que um replay parece.

Além de activation.sms_received, assine também activation.expired e activation.cancelled, para que um executor de testes nunca fique esperando por um número que já foi encerrado. Trate cada evento como identificado pelo id da ativação e escreva o handler de modo que uma segunda entrega do mesmo evento não altere nada. O artigo sobre assinar e verificar webhooks de OTP detalha a lógica de comparação.

Quais apps posso verificar com um número argentino?

O retrato ao vivo da Argentina lista mais de 2.000 serviços. Entre os que as equipes de produto e QA argentinas mais costumam procurar estão:

• Mensagens: WhatsApp, Telegram, Signal, Discord
• Contas e produtividade: Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI)
• Redes sociais e vídeo: Instagram, TikTok
• Comércio e mobilidade: Amazon, Uber, Airbnb, Netflix

Essa lista muda ao longo do dia, e por isso a API informa a disponibilidade ao vivo em vez de uma tabela estática. Consulte GET /api/v1/services pensando no país ar antes de iniciar um job de CI agendado e falhe rápido, com uma mensagem clara, se o serviço que você quer estiver temporariamente ausente.

Por que os celulares argentinos confundem os validadores de telefone?

A Argentina tem um dos planos de numeração mais incomuns da região. No uso doméstico, as pessoas escrevem um 0 de tronco antes do código de área e, nos celulares, um 15 antes dos dígitos do assinante, de modo que um celular de Buenos Aires pode aparecer como 011 15 seguido de oito dígitos. Na forma internacional E.164, ambos desaparecem e um 9 é inserido logo após o código do país: +54 9 11 e depois o número de assinante de oito dígitos.

Essa diferença importa para quem armazena números de telefone. Normalize tudo para E.164 antes de salvar, remova o 0 e o 15 na entrada e acrescente o 9 nos números de celular. Um validador que só confere o tamanho aceitará feliz um valor +54 11 de estilo fixo que não consegue receber SMS. Use o número exatamente como a API o devolve, em vez de reformatá-lo por conta própria.

Os códigos enviados a números argentinos costumam chegar em espanhol, muitas vezes com uma frase como "Tu código es" em volta dos dígitos. Extraia o código numérico com um padrão em vez de comparar palavras, já que os modelos mudam. As equipes testam aqui ao lançar na América Latina, ao revisar textos em espanhol rio-platense (as formas locais com vos diferem do espanhol de manual), ao tocar operações regionais ou ao atender argentinos que vivem no exterior e ainda se cadastram com um chip +54.

Alguém sem programar consegue pedir um número +54?

Sim. A equipe de suporte, de growth e de agências pode fazer tudo pelo navegador:

1. Crie uma conta em cadastro com um e-mail e um código de 6 dígitos, ou com o login do Google.
2. Adicione saldo à carteira.
3. Abra o OTP Gateway, escolha Argentina e depois o serviço que você está testando.
4. Confira o preço exibido, confirme e copie o número +54 para a tela de verificação do app.
5. Acompanhe a ativação; o código aparece ali assim que for recebido.

O painel e a API usam a mesma carteira e as mesmas ativações, então um desenvolvedor pode assumir um número que um colega pediu, pelo id da ativação.

O código argentino não apareceu. E agora?

Cada ativação fica aberta por 20 minutos. Se nada chegar, ou se você cancelar antes, o valor total volta automaticamente para a carteira, então uma rota silenciosa custa tempo, não dinheiro. A velocidade de entrega depende do serviço e da rota, por isso dê à janela uma chance justa antes de concluir que falhou.

Depois, passe por esta lista curta:

• Peça o código de novo uma vez dentro do app e então deixe a janela correr.
• Tente mais tarde no dia ou peça por outra rota para o mesmo serviço.
• Confirme que o serviço aceita números virtuais; alguns os recusam, e é por isso que o reembolso automático existe.
• Evite refazer pedidos em loop apertado a partir do CI. Acrescente um back-off e um limite de tentativas.

Nosso texto sobre como reduzir falhas na entrega de OTP cobre outros padrões para rotas argentinas. Mantenha todos os testes dentro dos termos de cada serviço; a Política de Uso Aceitável da OTP Route também se aplica.

Podemos manter uma linha argentina e como pagamos?

Hoje não existe um número de longo prazo em autoatendimento para a Argentina. Se a sua equipe precisa de uma linha +54 persistente, escreva para [email protected] e descreva o caso de uso; a viabilidade depende das regras locais e não é garantida. Os Números Virtuais Dedicados, que você mantém enquanto renovam e que encaminham os SMS de entrada ao seu webhook, são um produto dos Estados Unidos e do Canadá, a partir de $1.95/month.

A cobrança passa por uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Recarregue por cartão ou com USDT/USDC, e cada recarga gera uma fatura em PDF por e-mail. Os detalhes estão na página de preços. Antes de gastar saldo real, peça para a sua conta de desenvolvimento ser mudada para sandbox, que devolve números e códigos simulados para você ensaiar todo o fluxo da Argentina de ponta a ponta.

Perguntas frequentes

Qual é o id de país da Argentina na API da OTP Route?

É ar. Passe-o no campo country de POST /api/v1/activations e na query string de GET /api/v1/prices.

Preciso acrescentar o 9 ao digitar o número +54 em um app?

Use o número exatamente como a OTP Route o devolve. No seu próprio banco de dados, armazene os celulares argentinos em E.164, que inclui o 9 depois de +54 e omite o 0 e o 15 domésticos.

Quanto custa receber um SMS OTP da Argentina?

A partir de $0.20 por código, variando por serviço. O valor exato é devolvido por GET /api/v1/prices e exibido antes de você confirmar um pedido.

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

Sim. Peça uma ativação da Argentina para o seu próprio app ou para o serviço de terceiros do seu teste, digite o número +54 e leia o código no painel ou pelo seu webhook.

O mesmo número +54 funcionará de novo para um login no mês que vem?

Não. Um número do gateway cobre um único código em 20 minutos. Para contas que precisam continuar recebendo códigos, a opção adequada é um Número Dedicado nos EUA ou no Canadá.

Em que idioma será o texto de verificação argentino?

Em geral, em espanhol, embora dependa do remetente e das configurações de idioma da conta. Extraia os dígitos em vez de depender das palavras ao redor.

O polling é aceitável no lugar dos webhooks?

Sim. Faça polling em GET /api/v1/activations/{id} com um intervalo moderado e fique bem abaixo do limite de 300 requisições por minuto por conta.

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.