Números de verificação colombianos para QA, lançamentos e roteamento de OTP

Quatro chamadas de API para receber códigos OTP por SMS da Colômbia

Uma integração com a API de OTP da Colômbia precisa de poucas requisições. Comece confirmando que a rota está aberta com GET /api/v1/prices?country=co&service=whatsapp, trocando pelo ID do serviço que você está testando; a resposta traz o preço ao vivo desse par. Em seguida, crie o pedido com POST /api/v1/activations e um corpo JSON com o serviço e co como país. Você recebe de volta um ID de ativação e o número +57 para digitar no app em teste.

Depois, aguarde a mensagem. A maioria das equipes registra um endpoint de webhook e escuta activation.sms_received, enquanto outras chamam GET /api/v1/activations/{id} em intervalos tranquilos. Por fim, faça a limpeza: se o teste mudou de rumo, POST /api/v1/activations/{id}/cancel libera o valor reservado. A documentação para desenvolvedores descreve cada requisição por completo.

Quais apps colombianos estão na rota hoje?

O roteamento de OTP para a Colômbia abrange mais de 1.900 serviços no último retrato. Entre os mais pedidos estão WhatsApp, Telegram, Google (Gmail & YouTube), Instagram, Facebook, TikTok, Uber, Microsoft & Outlook, Amazon, Discord, LinkedIn, Signal e Netflix. A capacidade muda ao longo do dia; por isso, uma execução de testes agendada deve perguntar a GET /api/v1/services e ao endpoint de preços o que está aberto agora, em vez de confiar em uma lista fixa no código.

Como formatar celulares +57 para armazenar em E.164

Os celulares colombianos têm dez dígitos depois do código do país e começam com 3, o que dá o formato E.164 +57 3XX XXX XXXX. No país, eles são discados sem zero inicial, então a normalização é simples: remova espaços, hífens e parênteses, mantenha o sinal de mais e o 57 e salve uma única string canônica. Uma verificação no cliente para o 3 inicial ajuda quem testa e cola um número fixo a ver uma mensagem clara, em vez de uma falha silenciosa na etapa do SMS.

O que leva equipes de QA ao mercado colombiano?

A Colômbia é um dos maiores mercados de língua espanhola, e muitos lançamentos na América Latina começam ali ou por perto. Os SMS de verificação costumam chegar em espanhol; portanto, uma revisão de localização deve confirmar que o seu próprio modelo de mensagem soa natural, que os caracteres acentuados sobrevivem à codificação e que os dígitos continuam fáceis de achar no meio de uma frase mais longa. Produtos de transporte por aplicativo, entregas, pagamentos e marketplaces dependem de checagens de telefone na região, e é por isso que um número +57 para testes aparece sempre nas listas de verificação de release. Nossa página de testes de QA reúne padrões que funcionam com qualquer API de verificação por SMS.

O código +57 está atrasado. E agora?

Cada ativação fica aberta por 20 minutos. Se a janela fechar sem SMS, ou se você cancelar antes, o valor integral volta automaticamente para a sua carteira e o seu endpoint recebe activation.expired ou activation.cancelled. Antes de tentar de novo:

• verifique se o app que você testa aceita números virtuais;
• deixe a janela atual terminar em vez de empilhar novos pedidos;
• espace as novas tentativas, em vez de pedir em um laço apertado;
• tente em outro horário ou por uma rota diferente para o mesmo serviço.

O artigo sobre como reduzir falhas na entrega de OTP explica a lógica de cada passo.

Posso manter uma linha colombiana por meses?

Não por self-service. Os Números Virtuais Dedicados, que incluem SMS de entrada e saída e chamadas pelo navegador, são vendidos apenas para os Estados Unidos e o Canadá, a partir de $1.95/mês. Nenhuma linha +57 de longo prazo pode ser comprada pelo painel. Se a sua operação precisar de uma, escreva para [email protected]; o que pode ser combinado depende das regras locais e não dá para prometer de antemão.

Como pagar pelas verificações na Colômbia

A OTP Route funciona com uma carteira pré-paga em USD, sem mensalidade e sem plano para escolher. A recarga é feita com cartão ou com as stablecoins USDT/USDC, e o financeiro recebe uma fatura em PDF por e-mail após cada recarga. As rotas da Colômbia começam em $0.20 por código e variam conforme o serviço, com o valor exato exibido antes de você confirmar. Durante a integração, você pode pedir ao suporte que mude uma conta de desenvolvimento para sandbox, onde números e códigos simulados permitem ensaiar o fluxo inteiro sem tocar nos fundos da carteira. Os valores atuais estão na página de preços.

Perguntas frequentes

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

Sim. Peça um número +57 para o serviço que você está verificando, digite-o no formulário de cadastro e leia o código no painel ou no seu webhook. Nada físico precisa ser enviado ou ativado.

Como peço um número de verificação da Colômbia pelo painel?

Entre na conta, abra o OTP Gateway, escolha o serviço e a Colômbia, confira o preço e confirme. O número aparece na tela e o código surge ao lado assim que o SMS chega.

Qual ID de país a API usa para a Colômbia?

Use co no campo country e nas consultas de preço. Os IDs de serviço vêm de GET /api/v1/services, por exemplo telegram ou uber.

Pago por um número +57 que nunca recebe código?

Não. Quando a janela de 20 minutos termina sem SMS, ou quando você cancela, a cobrança integral volta automaticamente para a sua carteira.

Em que idioma será o SMS de verificação colombiano?

Depende do remetente, embora os usuários colombianos vejam sobretudo modelos em espanhol. Extraia os dígitos em vez de procurar um texto fixo, porque os modelos mudam sem aviso.

Meu pipeline de CI pode receber sozinho códigos OTP por SMS da Colômbia?

Pode. Crie a ativação a partir do pipeline, espere o webhook ou consulte a ativação e passe o código ao teste. Nossa nota sobre testes de OTP em CI trata de timeouts e limpeza.

Como saber que um webhook realmente veio da OTP Route?

Cada requisição traz X-OTPRoute-Signature com um timestamp e um HMAC-SHA256 desse timestamp, um ponto e o corpo bruto, usando o segredo do seu endpoint como chave. Recalcule, compare em tempo constante e descarte timestamps antigos.

Há limites para o que posso verificar com um número +57?

Sim. Use os números apenas para os seus próprios produtos e contas empresariais legítimas, siga os termos de cada serviço e lembre que a Política de Uso Aceitável da OTP Route vale para todo pedido.

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.