Levando códigos de verificação do Equador (+593) para as suas execuções de teste

Por que o nosso fluxo de cadastro no Equador fica parado esperando um telefone?

O padrão é conhecido. Uma equipe de produto inclui o Equador na lista de lançamentos, a tela de registro pede um celular +593, e ninguém no QA tem um. Alguém pede um chip pré-pago, ele fica numa gaveta em outra cidade, e cada execução de regressão passa a depender de um colega lendo códigos em voz alta numa conversa.

Essa configuração quebra assim que os testes rodam à noite ou em paralelo. Além disso, ela espalha códigos por lugares onde nunca deveriam estar. A OTP Route troca o chip da gaveta por roteamento de OTP via API: o seu teste pede um número equatoriano, o SMS de verificação chega do nosso lado, e o código é devolvido ao job que o solicitou. Ninguém precisa estar acordado, e o telefone pessoal de ninguém entra na história.

Quais apps podem enviar códigos para um número de verificação do Equador?

A rota do Equador atualmente conta com mais de 1.700 serviços. Entre os populares no snapshot ao vivo estão WhatsApp, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), LinkedIn, Microsoft & Outlook, Uber, Airbnb, Netflix, Discord e ChatGPT (OpenAI).

Essa lista se move ao longo do dia porque a disponibilidade vem dos nossos parceiros de operadora em tempo real. Trate-a como um guia, não como uma promessa: a resposta definitiva para qualquer minuto é o que GET /api/v1/prices retorna para o seu serviço e o id de país ec. O catálogo completo pode ser consultado na página de serviços.

Como é a sequência da API OTP do Equador em código?

Tudo fica sob https://otproute.com/api/v1 e se autentica com uma chave Bearer de prefixo or_live_, gerada no console do desenvolvedor. Uma etapa de teste típica funciona assim:

1. Consulte o preço e a disponibilidade ao vivo com GET /api/v1/prices?country=ec&service=<id>.
2. Crie o pedido com POST /api/v1/activations e um corpo como {"service": "uber", "country": "ec"}. Você recebe um id de ativação e o número +593.
3. Digite esse número no formulário de registro do seu próprio app e dispare o SMS.
4. Deixe o seu job do Equador aguardar o evento activation.sms_received, recorrendo a GET /api/v1/activations/{id} a cada poucos segundos.
5. Quando um teste travar no meio, libere o pedido +593 por POST /api/v1/activations/{id}/cancel.

As entregas de webhook trazem um cabeçalho X-OTPRoute-Signature. Recalcule o HMAC-SHA256 do timestamp, um ponto e o corpo bruto usando o segredo do endpoint, compare em tempo constante e rejeite timestamps antigos. O guia de integração percorre um cliente completo de API de verificação por SMS, e a documentação lista todos os campos.

Como o nosso banco de dados deve armazenar celulares +593?

Os equatorianos costumam escrever um celular com um 0 à frente, por exemplo 09 seguido de mais oito dígitos. Esse zero é um prefixo de tronco usado só na discagem doméstica. Em E.164 ele desaparece, deixando +593 e um número nacional de nove dígitos que começa com 9.

• Armazene uma única forma canônica: +5939XXXXXXXX. Remova espaços, hifens e o zero de tronco na entrada.
• Aceite 09… e +593 9… no campo do formulário, já que os moradores digitam de um jeito ou de outro.
• Não presuma o inglês nos templates de mensagem. O idioma oficial do Equador é o espanhol, então a maioria dos códigos chega em texto espanhol; extraia os dígitos em vez de procurar palavras como "código".

Uma pequena conveniência para testes de cobrança: o Equador usa o dólar americano como moeda, o que combina com a carteira em USD que você recarrega na OTP Route.

O código não chegou no Equador. E agora?

Um número silencioso costuma ser um problema de rota ou de aceitação, e não um bug do seu ambiente de testes. Siga esta ordem:

• Deixe a janela de 20 minutos terminar. Se nada chegou, o valor integral volta para a sua carteira automaticamente, então não há motivo para cancelar cedo.
• Descubra se o serviço voltado ao Equador tolera números virtuais. Alguns os rejeitam por política, e é exatamente por isso que a regra de reembolso existe.
• Tente de novo mais tarde, ou peça uma nova ativação para o mesmo serviço, para que seja usado um número diferente.
• Evite refazer o pedido em um laço rápido; uma espera curta protege tanto a sua carteira quanto a rota.

Se você precisa receber códigos OTP por SMS do Equador de forma confiável no CI, inclua a espera progressiva no próprio ambiente de testes. Nosso artigo sobre como reduzir falhas na entrega de OTP traz mais padrões para a lógica de novas tentativas.

Podemos manter um número equatoriano para contas que fazem login de novo?

Não como produto self-service. Os Dedicated Numbers de longo prazo são vendidos apenas para os Estados Unidos e o Canadá, a partir de $1.95/month, com SMS de entrada, encaminhamento por webhook, textos de saída e chamadas pelo navegador. Para o Equador, hoje não existe linha de longo prazo com contratação self-service. Se o seu caso realmente exige uma, escreva para [email protected] e descreva-o; a disponibilidade depende das regras locais e não pode ser prometida.

Como os códigos do Equador são cobrados, e podemos testar de graça antes?

A OTP Route funciona com uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Você recarrega por cartão ou com USDT/USDC, e cada recarga gera uma fatura em PDF por e-mail. Cada ativação só debita desse saldo quando um código é entregue.

Antes de gastar qualquer coisa, peça o modo sandbox em uma conta de desenvolvimento. Ele devolve números e códigos simulados, de modo que o seu job de CI, o verificador de webhook e o parser possam ser exercitados de ponta a ponta. As equipes que integram isso a pipelines costumam partir da nossa visão geral de testes de QA. Como sempre, siga os termos de cada serviço e a nossa Política de Uso Aceitável.

Perguntas frequentes

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

Sim. Peça uma ativação para o id de país ec, digite o número +593 no seu app e leia o código no painel, em um webhook ou por uma chamada de polling.

Quanto custa um código de verificação do Equador?

Os códigos começam em $0.20 por código; o valor exato depende do serviço e é mostrado no painel ou retornado pelo endpoint de preços antes de você pedir.

Pago se o número +593 nunca receber um SMS?

Não. Quando a janela de 20 minutos fecha sem mensagem, ou você cancela antes, o valor integral volta para a sua carteira.

Devo enviar o zero inicial ao digitar um número equatoriano?

Só se o seu formulário esperar o formato doméstico. Na forma internacional o zero de tronco é descartado, então o número fica +593 seguido de nove dígitos começando com 9.

Em que idioma estarão as mensagens OTP do Equador?

Principalmente em espanhol, embora alguns apps globais enviem em inglês. Interprete o código numérico em vez de depender das palavras ao redor.

Existe um número +593 para testes que eu possa manter por meses?

Não existe opção self-service para o Equador; as linhas de longo prazo são um produto dos EUA e do Canadá. Você pode escrever para [email protected] para perguntar sobre casos especiais.

Posso pedir números do Equador por um navegador em vez da API?

Sim. Entre na conta, escolha o serviço e o Equador no OTP Gateway, confirme o preço mostrado, e o código aparece na mesma tela quando chegar.

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.