Como receber códigos SMS do imo em testes e na operação de contas

A situação: seu produto usa o imo e todo teste precisa de um telefone

O imo é um aplicativo de mensagens e de chamadas de voz e vídeo que identifica cada conta pelo número de telefone. Cadastrar-se, ou migrar uma conta para outro aparelho, dispara um código único por SMS. Esse desenho é simples para o usuário e incômodo para as equipes: quem desenvolve uma integração, um fluxo de suporte ou um teste de mercado que envolva o imo precisa de um número acessível a cada tentativa.

Usar o celular dos funcionários mistura números pessoais com contas de trabalho e não escala para uma matriz de testes entre países. Um número descartável do OTP Gateway cuida de um único código, mantém os números privados de fora e pode ser pedido por código ou manualmente. A página de verificação de aplicativos móveis descreve o padrão em mais detalhes.

Quais países podem receber códigos OTP do imo?

O serviço imo está disponível hoje em 197 países. Entre os exemplos estão Índia, Paquistão, Bangladesh, Nepal, Arábia Saudita, Emirados Árabes Unidos, Egito, Nigéria, Quênia, Indonésia, Filipinas, Alemanha, Bélgica, Reino Unido, Estados Unidos e Canadá.

Escolha o país que corresponde ao caso que você está testando. Se a sua equipe de suporte atende clientes no Sul da Ásia, um número dessa região reproduz o fluxo que eles veem, incluindo o idioma do SMS e as verificações regionais que o serviço aplica. A lista de países mostra todas as rotas.

Como funciona o fluxo da API de código de verificação do imo?

Crie uma chave Bearer no console do desenvolvedor (prefixo or_live_, até 10 por conta) e chame https://otproute.com/api/v1; o limite é de 300 requisições por minuto.

1. Consulte os ids com GET /api/v1/services e GET /api/v1/countries; o id do serviço é imo.
2. Consulte o preço do par com GET /api/v1/prices?country=pk&service=imo.
3. Faça o pedido com POST /api/v1/activations e {"service": "imo", "country": "pk"}, e guarde o id da ativação.
4. Digite o número retornado na tela de cadastro do imo.
5. Receba o código pelo webhook activation.sms_received ou, se você não puder expor um endpoint, consulte GET /api/v1/activations/{id} por polling.

Nos webhooks, verifique X-OTPRoute-Signature: t=<unix>,v1=<hex> calculando o HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint e rejeite timestamps antigos. Torne o handler idempotente, usando o id da ativação como chave, para que uma entrega repetida seja processada uma só vez. O esquema completo está na documentação.

Dá para pedir um número do imo pelo painel em vez da API?

Sim. Cadastre-se com e-mail e um código de 6 dígitos enviado por e-mail, ou com o login do Google, e ative a autenticação em dois fatores por TOTP. Recarregue a carteira, escolha o imo e um país, confira o preço exibido e confirme. Digite o número no imo, e o código aparece no painel assim que for entregue. Isso atende a equipe de suporte ou o gestor de contas de uma agência que precisa de uma única verificação sem escrever código.

Por que um código do imo pode não chegar e o que fazer?

Cada ativação fica aberta por 20 minutos, e você só paga se o código chegar. Um pedido expirado ou cancelado é reembolsado integralmente na carteira, de forma automática.

Códigos somem por motivos comuns: o imo pode recusar números virtuais em alguns casos, uma rota pode estar ocupada, ou o serviço pode aplicar verificações extras a números que já viu antes. Quando isso acontecer:

• Deixe a janela correr em vez de cancelar cedo.
• Tente de novo mais tarde, ou use outra rota de país que ainda sirva para o teste.
• Coloque pausa e limite nas tentativas; disparar pedidos seguidos do imo só queima tentativas.

Quando um Número Dedicado serve melhor para o imo?

Como o imo vincula a conta ao número de telefone, um número descartável não consegue receber um código posterior quando a mesma conta entra em outro aparelho. Para uma linha de suporte, uma conta operacional compartilhada ou um login de staging que precisa continuar funcionando, o Número Dedicado é a melhor escolha. Eles só estão disponíveis nos Estados Unidos e no Canadá, a partir de $1.95/mês, com SMS recebidos no painel e enviados ao seu webhook por number.sms_received. A página de números dedicados explica renovações e liberação.

Uso responsável e cobrança

Siga os termos de serviço do imo: uma conta por pessoa ou empresa reais, sem cadastros em massa ou falsos. A OTP Route serve para testar o fluxo do seu próprio produto e operar suas próprias contas legítimas, e a Política de Uso Aceitável se aplica. O imo é uma marca registrada de seu proprietário, e a OTP Route não tem nenhuma afiliação com ele.

A cobrança usa uma única carteira pré-paga em USD, pague conforme o uso, sem mensalidade. Os fundos entram por cartão ou como USDT/USDC, e uma fatura em PDF chega por e-mail após cada recarga, o que facilita a conciliação dos custos de teste do imo. Contas de desenvolvimento podem ser mudadas para o sandbox, sob pedido, para testes de ponta a ponta com números e códigos simulados.

Perguntas frequentes

Como recebo um OTP do imo pela API?

Crie uma ativação com {"service": "imo", "country": "<id>"}, digite o número no imo e leia o código pelo webhook ou em GET /api/v1/activations/{id}.

A verificação por SMS do imo para testes está disponível no meu país?

O imo está listado em 197 países neste momento. Consulte GET /api/v1/countries ou o painel para ver a disponibilidade ao vivo.

O imo aceita um número virtual todas as vezes?

Não. O imo pode recusar alguns números virtuais, e por isso um pedido sem código é reembolsado integralmente após 20 minutos.

Quanto custa um número de telefone do imo na OTP Route?

A partir de $0.20 por código, conforme o país. O preço ao vivo vem de GET /api/v1/prices.

Posso entrar de novo na mesma conta do imo mais tarde com um número descartável?

Não de forma confiável, porque cada número descartável trata um único código. Use um Número Dedicado dos EUA ou do Canadá para contas que precisam entrar outra vez.

Como meu webhook deve tratar entregas duplicadas do imo?

Verifique a assinatura e depois processe cada id de ativação uma única vez, para que as novas tentativas não repitam o trabalho.

Posso criar várias contas do imo assim?

Somente para pessoas ou empresas reais que você representa, dentro dos termos do imo. Cadastros em massa ou falsos não são permitidos.

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.