Testando cadastros em Moçambique quando ninguém da equipe tem um chip +258

O nosso lançamento em Moçambique parou na verificação por telefone. Por onde começar?

A história de sempre: o app está traduzido, as telas de pagamento estão prontas, e o último ticket em aberto diz que alguém precisa confirmar que um cliente moçambicano consegue mesmo concluir o cadastro. Ninguém tem um chip +258, o roaming demora a ser providenciado, e o celular pessoal de um colega não é um recurso de teste.

O OTP Gateway elimina essa dependência. Você pede um número +258 para um serviço específico, usa-o uma vez na tela em teste, e o código recebido volta para você. Ele serve para QA e automação de testes, listas de verificação de lançamento e equipes de suporte que reproduzem o relato de um cliente sem pegar o aparelho emprestado de ninguém.

Como é um número +258 e como devemos armazená-lo?

O código de país de Moçambique é +258, e os números nacionais têm nove dígitos, sem zero de tronco para remover; assim, as formas local e internacional diferem apenas pelo código do país. Os números móveis começam com 8. Na prática, isso significa:

• Persista a forma E.164, +258 seguido dos nove dígitos, e formate para exibição separadamente.
• Rejeite entradas que acrescentam um zero inicial por hábito de outros mercados, ou remova-o discretamente antes da validação.
• Mantenha o código do país mesmo para usuários que só discam localmente; o seu remetente de SMS e qualquer consumidor de webhook precisam dele.

O português é o idioma oficial, então as mensagens podem chegar em português ou em inglês, conforme o serviço e a localidade da conta. Se os seus próprios modelos estão em português, veja como caracteres acentuados como ç e ã são exibidos, já que texto fora do ASCII muda a codificação do SMS e pode dividir uma mensagem em mais partes.

Quais serviços podem enviar um código para um número de verificação de Moçambique?

Somando todos os serviços, o panorama de Moçambique conta mais de 1.600. Os mais solicitados incluem WhatsApp, Telegram, Facebook, Instagram, Google (Gmail & YouTube), Microsoft & Outlook, LinkedIn, Uber, Signal, Viber, Netflix, Airbnb, Discord e Claude.

A disponibilidade é ao vivo, e não fixa: o mesmo serviço pode estar bem abastecido numa hora e escasso mais tarde. Leia-a pela API ou pelo painel antes de cada pedido, em vez de gravar uma lista no código do seu plano de testes.

Como funciona o fluxo da API de OTP de Moçambique de ponta a ponta?

Para desenvolvedores, a integração é uma sequência curta contra https://otproute.com/api/v1, assinada com uma chave Bearer que começa com or_live_:

1. Obtenha o id de Moçambique (mz) e o id do serviço em GET /api/v1/countries e GET /api/v1/services.
2. Consulte GET /api/v1/prices?country=mz&service=<id> para ver o preço atual e se há números disponíveis.
3. Envie POST /api/v1/activations com {"service": "telegram", "country": "mz"} e guarde o id da ativação e o número devolvidos.
4. Colete o código quando activation.sms_received chegar ao seu endpoint, ou consulte GET /api/v1/activations/{id} a cada poucos segundos.
5. Chame POST /api/v1/activations/{id}/cancel se o teste for abandonado.

As requisições de webhook trazem um cabeçalho X-OTPRoute-Signature (t=<unix>,v1=<hex>), um HMAC-SHA256 de <t>.<raw body> com o segredo do seu endpoint como chave. Verifique-o, recuse timestamps antigos e torne o handler idempotente pelo id da ativação. As chaves ficam no console do desenvolvedor (até 10, além de 5 endpoints de webhook), e o limite de taxa é de 300 requisições por minuto. O guia de integração da API de OTP mostra o mesmo fluxo da API de verificação por SMS com tratamento de erros.

Quem não é desenvolvedor pode pedir um número +258 pelo painel?

Pode, e usa exatamente o mesmo roteamento de OTP da API. Depois de criar uma conta com e-mail e um código de 6 dígitos (ou Google), adicione saldo, abra o OTP Gateway, escolha Moçambique e o serviço e confirme o preço exibido. O número aparece na hora; cole-o no app, e o código é exibido na mesma página quando chegar. A autenticação em dois fatores com um app autenticador está disponível para a própria conta.

Por que o código não chegou e o que devemos tentar em seguida?

Toda ativação tem uma janela de 20 minutos. Se ela se fechar sem SMS, ou se você cancelar, o valor integral é creditado de volta à carteira automaticamente; você só paga quando um código chega.

Se uma execução continuar vazia:

• Dê tempo à janela. A rapidez com que um código aparece depende do serviço e da rota.
• Veja se esse serviço aceita números virtuais; alguns os rejeitam de imediato.
• Tente de novo após uma pausa, ou escolha outra rota quando o teste não exigir especificamente um número moçambicano.
• Espace as tentativas em vez de bombardear o endpoint de pedidos, e registre cada id de ativação para poder comparar as falhas.

Existe uma linha moçambicana permanente e como ela é cobrada?

Não existe número de longo prazo em autoatendimento para Moçambique. As linhas dedicadas são vendidas apenas para os Estados Unidos e o Canadá, a partir de $1.95/mês. Equipes que precisam de uma linha moçambicana contínua podem escrever para [email protected] para perguntar; se é possível ou não depende das regras locais, e pode não ser.

O pagamento passa por uma única carteira pré-paga em USD, pay as you go, sem assinatura. Recargas por cartão e por stablecoins USDT/USDC são aceitas, cada uma seguida de uma fatura em PDF por e-mail. Para construir e depurar, uma conta de desenvolvimento pode ser passada para sandbox sob solicitação, de modo que números e códigos simulados circulem pelo seu código sem gastar nada. Veja os preços para saber como as tarifas são exibidas.

Perguntas frequentes

Posso testar um cadastro de Moçambique de fora do país?

Sim. O número +258 vem do OTP Gateway, então sua equipe pode rodar o teste de qualquer lugar e ler o código no painel ou pela API.

Qual é o id de país de Moçambique na API?

Use mz em GET /api/v1/prices e no corpo de POST /api/v1/activations.

Os números moçambicanos precisam de um zero inicial?

Não. Moçambique não tem prefixo de tronco nacional, então a forma armazenada é simplesmente +258 seguido de nove dígitos.

Quanto custa receber um SMS OTP de Moçambique?

Os códigos começam em $0.20 por código, e o preço exato de cada serviço é devolvido ao vivo pela API e exibido no painel antes de você fazer o pedido.

Um número de teste +258 ainda funcionará para fazer login na semana que vem?

Conte com que não. Um número do OTP Gateway serve para um código, e os números dedicados de longo prazo são oferecidos apenas nos EUA e no Canadá.

Há regras sobre o que podemos verificar com esses números?

Sim. Use-os apenas para testar e operar seus próprios produtos e contas legítimos, siga os termos de cada serviço e respeite a Política de Uso Aceitável da OTP Route.

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.