Códigos de verificação chilenos para QA e lançamentos, roteados por API

Número do Gateway ou Dedicated Number: qual deles um teste no Chile exige?

A escolha se resume a uma pergunta: alguém vai precisar de um código neste mesmo número +56 de novo? Para a maior parte do trabalho no Chile, como um teste de cadastro, uma checagem pontual de onboarding ou a confirmação de um perfil empresarial, a resposta é não, e o OTP Gateway atende. Você recebe um número, ele recebe um código e o trabalho termina.

Uma linha chilena que fica com você é outro produto, e não o vendemos em autoatendimento. Os Dedicated Numbers da OTP Route existem apenas para os Estados Unidos e o Canadá, a partir de $1.95/mês. Se a sua equipe realmente precisa de uma linha +56 duradoura, escreva para [email protected] e descreva o caso de uso; o que pode ser providenciado depende das regras locais, então planeje como se a resposta pudesse ser não.

• Use o OTP Gateway quando o código é necessário uma vez: regressão de cadastro, um smoke test antes de um release no Chile, a confirmação de uma única conta.
• Use um Dedicated Number dos EUA ou do Canadá quando um login compartilhado de staging precisa continuar recebendo códigos e a conta não exige identidade chilena.

O artigo sobre números temporários e dedicados detalha melhor as vantagens e desvantagens.

Como a API de OTP do Chile funciona, do pedido ao código?

A API de verificação por SMS é REST simples sob https://otproute.com/api/v1, autenticada com uma chave Bearer que começa com or_live_, criada no console de desenvolvedor. O id do Chile é cl.

1. Chame GET /api/v1/services e guarde em cache os ids de serviço que os seus testes usam, por exemplo whatsapp ou uber.
2. Leia o valor atual em GET /api/v1/prices?country=cl&service=<id> em vez de fixar um custo no código.
3. Faça o pedido com POST /api/v1/activations e um corpo como {"service": "whatsapp", "country": "cl"}. A resposta traz o número +56 e um id de ativação.
4. Digite esse número no fluxo em teste e dispare o SMS.
5. Consulte GET /api/v1/activations/{id} ou deixe o webhook activation.sms_received avisar você.
6. Se uma execução for abandonada, envie POST /api/v1/activations/{id}/cancel para que a carteira seja creditada na hora.

As entregas de webhook são assinadas. O cabeçalho X-OTPRoute-Signature contém t=<unix>,v1=<hex>, um HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint. Recalcule-o sobre os bytes intactos da requisição, compare em tempo constante, descarte timestamps antigos e trate o id da ativação como chave de idempotência, para que um evento repetido não mude nada. Cada conta recebe até 10 chaves de API, 5 endpoints de webhook e 300 requisições por minuto; o guia de integração da API de OTP acrescenta tratamento de novas tentativas e de erros a esse ciclo.

Quais apps podem enviar códigos a um número +56 para testes?

A rota chilena alcança hoje mais de 1.800 serviços. Os que as equipes de QA mais procuram incluem WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Microsoft & Outlook, Amazon, LinkedIn, ChatGPT (OpenAI), Discord e Netflix.

O estoque muda ao longo do dia, então trate qualquer lista, esta inclusive, como um retrato do momento. Antes de um job agendado, consulte GET /api/v1/countries e o endpoint de preços para saber o que está ativo em cl e pule com elegância quando um par estiver ausente, em vez de descobrir a falha no meio de uma suíte de testes.

Como armazenar e validar números +56?

Os celulares chilenos têm nove dígitos depois do código de país +56 e começam com 9, então um celular completo em E.164 fica +569 seguido de mais oito dígitos. Os números chilenos atuais são escritos no país com os mesmos nove dígitos que vêm depois do +56, o que deixa a normalização curta.

Mesmo assim, os usuários digitarão o número de três formas diferentes: com espaços e um sinal de mais, como 56 mais os dígitos nacionais sem o sinal de mais, ou apenas com os nove dígitos locais. Armazene uma única string E.164 canônica, guarde a entrada bruta ao lado dela para chamados de suporte e inclua casos de teste para as três formas. Rejeitar uma entrada de oito dígitos na etapa do formulário poupa um SMS que nunca iria chegar.

Por que as equipes de produto verificam fluxos de cadastro no Chile?

O Chile é uma parada inicial frequente para produtos que se expandem pela América Latina, e seus usuários esperam textos em espanhol escritos para a região, e não localizados para a Espanha. Os códigos enviados a números +56 costumam chegar em espanhol, embora muitos apps sigam o idioma da conta, então confira se o seu parser extrai os dígitos independentemente do texto ao redor.

Outros motivos para fazer testes no Chile: confirmar que o campo de telefone usa +56 por padrão para visitantes locais, provar que a rota completa funciona para números chilenos especificamente e permitir que equipes de suporte ou operações confirmem contas empresariais sem emprestar um chip pessoal. Nossa página de testes de QA mostra como as equipes incorporam isso às listas de verificação de release.

E se um código chileno nunca aparecer?

Toda ativação fica aberta por 20 minutos. Você só paga se um código chegar; quando a janela fecha vazia, ou se você cancela antes, o valor integral volta automaticamente para a carteira. Se um número +56 continuar mudo:

• Deixe a janela correr até o fim antes de marcar o teste como falho, porque alguns remetentes são lentos.
• Descubra se aquele app específico aceita números virtuais. Alguns os recusam por política, e é exatamente por isso que a regra de reembolso existe.
• Tente de novo mais tarde, ou troque para outra rota de serviço no mesmo cenário.
• Espace as novas tentativas; disparar um novo pedido a cada poucos segundos só gasta números.

Mais ideias de solução de problemas estão no nosso post sobre como reduzir falhas na entrega de OTP.

Como funcionam a cobrança e os testes em sandbox?

A OTP Route usa uma única carteira pré-paga em USD: pague conforme o uso, sem mensalidade e sem plano para escolher. A recarga é feita por cartão ou por stablecoins USDT/USDC, e a contabilidade recebe uma fatura em PDF por e-mail a cada recarga.

Enquanto você desenvolve, peça que sua conta de desenvolvimento seja movida para o sandbox. Ele devolve números e códigos simulados, para que todo o fluxo do Chile possa ser exercitado sem tocar nos fundos da carteira. Colegas que nunca abrem um terminal podem usar o painel: selecione o Chile, selecione o serviço, confirme o preço exibido, copie o número e veja o código aparecer.

Use-o apenas para seus próprios produtos e contas, respeite os termos de cada serviço e lembre-se de que vale a Política de Uso Aceitável da OTP Route. Você pode criar uma conta em poucos minutos.

Perguntas frequentes

Posso testar o cadastro do meu app no Chile sem um chip local?

Sim. Peça um número +56 no OTP Gateway, digite-o no seu formulário de cadastro e leia o código no painel ou pela API. Cada número cobre um código.

Qual id de país a API espera para o Chile?

Use cl, por exemplo GET /api/v1/prices?country=cl&service=telegram.

Quanto custa um número +56 para testes?

A partir de $0.20 por código; o valor exato depende do serviço e é retornado em tempo real pela API. Você só é cobrado quando um código chega.

Posso manter um número chileno para que a conta entre de novo no próximo trimestre?

Não por autoatendimento. Os Dedicated Numbers são um produto dos EUA e do Canadá a partir de $1.95/mês; para uma linha +56, escreva para [email protected], e a disponibilidade depende das regras locais.

Em que idioma vêm os textos de verificação chilenos?

Normalmente em espanhol, embora muitos apps enviem no idioma escolhido na conta. Leia os dígitos em vez de comparar um texto fixo.

Polling ou webhook: o que é melhor para execuções de teste no Chile?

O polling serve para uma checagem manual isolada. Quando várias execuções acontecem em paralelo, um webhook assinado, indexado pelo id da ativação, é mais fácil de escalar.

O nosso financeiro pode pagar com stablecoins?

Sim. A carteira aceita cartões e USDT/USDC, e cada recarga vem com uma fatura em PDF.

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.