Como receber senhas de uso único malgaxes (+261) para testes de produto

Quem testa ou opera com números malgaxes, e por quê?

Madagascar é um mercado francófono com o malgaxe como língua nacional, e ambos são oficiais. Esse arranjo bilíngue o torna um ponto de verificação útil para qualquer produto que entregue texto em francês a usuários africanos, porque uma tela de cadastro que fica ótima em Paris ainda pode quebrar com um formato de número +261 ou com um navegador pensado para celular.

As equipes que costumam precisar de um número de verificação de Madagascar incluem:

• Suporte francófono e operações de BPO em Antananarivo que administram contas empresariais em plataformas de mensagens e redes sociais e querem manter os telefones pessoais dos funcionários fora delas.
• Equipes de produto em expansão pelo Oceano Índico e pela África francófona que precisam confirmar que o onboarding funciona antes de uma ação de marketing.
• Apps voltados à diáspora, cujos clientes vivem no exterior mas se cadastram com um número malgaxe que já possuem.

Em todos os casos o objetivo é o mesmo: ver a mensagem real chegar a uma rota +261 real, em vez de confiar em um mock.

Como é um número +261 em um banco de dados?

No uso doméstico, os celulares malgaxes são escritos com um 0 de tronco e dez dígitos, geralmente começando com 03. Na forma internacional esse 0 desaparece e você obtém +261 seguido de nove dígitos.

Regras práticas para a sua tabela de usuários:

• Remova o 0 de tronco ao converter para E.164; +2610… está sempre errado.
• Aceite usuários digitando o estilo familiar agrupado com espaços e depois elimine tudo que não for dígito ou o sinal de mais inicial.
• Verifique se restam exatamente nove dígitos nacionais para um celular.

As mensagens de apps globais costumam vir em francês ou inglês, dependendo do idioma da conta, e os textos em malgaxe são menos comuns. Compare os dígitos, e não uma palavra traduzida, ao extrair a senha de uso único.

Quais serviços funcionam na rota de Madagascar?

Mais de 1.000 serviços podem entregar códigos a números de Madagascar neste momento. Entre os mais usados estão WhatsApp, Facebook, Telegram, Google (Gmail & YouTube), TikTok, Instagram, Microsoft & Outlook, LinkedIn, Viber, imo, Signal e ChatGPT (OpenAI).

Essa lista muda ao longo do dia, então leia-a em tempo real em GET /api/v1/services antes de uma execução de teste, em vez de presumir que a lista de ontem continua valendo.

Como trago códigos +261 para os meus próprios sistemas?

A API REST em https://otproute.com/api/v1 usa chaves Bearer que começam com or_live_. Você pode ter até 10 chaves e registrar 5 endpoints de webhook por conta, dentro de um teto de 300 requisições por minuto.

Para Madagascar, o id de país é mg. Uma sequência limpa:

1. Busque o preço com GET /api/v1/prices?country=mg&service=telegram.
2. Crie a ativação por POST /api/v1/activations com {"service": "telegram", "country": "mg"}.
3. Digite o número devolvido no produto em teste.
4. Receba activation.sms_received no seu endpoint ou chame GET /api/v1/activations/{id} se preferir polling.
5. Se o cenário for abandonado, POST /api/v1/activations/{id}/cancel o encerra e devolve a reserva.

Verifique cada webhook antes de confiar nele: o cabeçalho X-OTPRoute-Signature contém t=<unix>,v1=<hex>, e v1 deve ser igual ao HMAC-SHA256 de <t>.<raw body> com o segredo do endpoint. Rejeite qualquer coisa com timestamp antigo e indexe as suas gravações pelo id da ativação para que uma entrega repetida não cause dano. O guia de captura por webhook percorre um handler completo.

Existe um caminho pelo painel para a equipe não técnica?

Existe. Um líder de operações pode entrar, abrir o OTP Gateway, selecionar Madagascar e um serviço, conferir o preço exibido e fazer o pedido. O número +261 aparece em um cartão de ativação, e o texto recebido surge nesse mesmo cartão. Sem terminal, sem gerenciamento de chaves, e a janela de 20 minutos se comporta exatamente como pela API.

Um código de Madagascar não chegou. E agora?

A maioria das falhas vem do serviço remetente, e não da sua configuração. Antes de escalar:

• Dê à ativação os 20 minutos completos; reenvios podem chegar tarde.
• Verifique se o serviço aceita números virtuais. Alguns os recusam, e é por isso que uma ativação sem resposta se reembolsa sozinha.
• Tente de novo após uma pausa ou troque para outra rota de serviço que exercite o mesmo fluxo.
• Não dispare novos pedidos em loop rápido; isso desperdiça limite de taxa sem melhorar a entrega.

Quando nenhum SMS chega antes de a janela se fechar, ou quando você cancela, o valor integral volta para a carteira sem precisar de chamado.

Linhas de longa duração e como pagar pelo uso

Madagascar não tem número de longa duração em self-service na OTP Route. Nossos Números Dedicados cobrem apenas os Estados Unidos e o Canadá, a partir de $1.95/month; se você precisar de uma linha +261 duradoura, escreva para [email protected] e a equipe dirá se as regras locais permitem, sem promessa associada. O artigo sobre números temporários vs. dedicados explica qual produto serve para cada tarefa.

O pagamento passa por uma carteira pré-paga em USD: sem assinatura e sem nível para escolher. Abasteça-a por cartão ou com USDT/USDC e receba uma fatura em PDF por e-mail a cada recarga. Os valores atuais de cada par estão na página de preços. Os desenvolvedores também podem solicitar o modo sandbox, que serve números e códigos simulados para que a integração seja comprovada antes de qualquer gasto real.

Perguntas frequentes

Posso verificar o fluxo de cadastro malgaxe do meu app sem um chip local?

Sim. Peça um número +261 para o seu serviço no OTP Gateway e o código aparece no painel ou chega ao seu webhook. Você só paga se ele chegar.

Que id de país a OTP Route usa para Madagascar?

O id é mg, usado em chamadas como POST /api/v1/activations.

Devo manter o 0 inicial ao armazenar um celular malgaxe?

Não. Descarte o 0 de tronco e salve +261 mais nove dígitos; reformate com espaços apenas para exibição.

Em que idioma será o texto com a senha de uso único?

Depende do remetente e das configurações da conta. Francês e inglês são os casos usuais, então analise o código numérico em vez de uma frase fixa.

Um número +261 para testes pode ser reutilizado depois?

Cada ativação serve para um único código em até 20 minutos. Contas que precisam entrar de novo ao longo do tempo exigem outra abordagem, e os números de longa duração só estão disponíveis em self-service nos EUA e no Canadá.

Existem regras de uso?

Sim. Respeite os termos de cada serviço e a Política de Uso Aceitável da OTP Route; use os números para testar o seu próprio produto ou administrar contas empresariais genuínas, uma conta por pessoa real ou empresa.

O roteamento de OTP para Madagascar exige um contrato separado?

Não. A mesma carteira e a mesma API de verificação por SMS funcionam para todos os países, e você pode se cadastrar com um código por e-mail ou com o login do Google.

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.