Testando códigos de cadastro macedônios (+389) antes do seu lançamento

Sua lista de lançamento diz "verificar cadastros +389": por onde o QA começa?

Uma situação conhecida: o produto está se expandindo para os Bálcãs Ocidentais, o fluxo de cadastro já atende uma dúzia de mercados e alguém precisa provar que ele aceita números da Macedônia do Norte e que o SMS enviado pelo seu app realmente chega. Pegar emprestado o celular de um colega não escala, e um chip local é incômodo de manter dentro de um runner de CI.

O OTP Gateway elimina essa dependência. Você pede um número de verificação da Macedônia do Norte pela API ou pelo painel, digita-o no seu próprio fluxo e recolhe o código que chegar. Cada número atende a uma verificação, então uma suíte de regressão pode pedir um número +389 novo para testes a cada execução. A visão geral de testes de QA mostra como as equipes encaixam isso em um processo de release.

Como se escrevem os números +389 e o que o seu validador deve aceitar?

O código do país da Macedônia do Norte é +389 e o prefixo de tronco nacional é 0. Os celulares são escritos localmente como 07X XXX XXX; na forma internacional o 0 desaparece, resultando em +389 7X XXX XXX, com um número nacional de oito dígitos. Guarde a forma E.164 (+3897…) e trate o formato local apenas como formato de entrada.

Casos de teste que vale manter na suíte:

• O usuário seleciona +389 e ainda digita o 0; o formulário deve removê-lo em vez de rejeitar a entrada.
• Números colados com espaços, barras ou traços devem ser normalizados para um único valor armazenado.
• Verificações de faixa pertencem a uma biblioteca de números de telefone mantida, não a prefixos fixos no código, porque as faixas das operadoras mudam com o tempo.

Por que os modelos de SMS em cirílico merecem um teste próprio?

O macedônio é o idioma oficial em todo o país e se escreve em cirílico; o albanês também tem status oficial e é muito falado. Se o seu app envia a mensagem de verificação em macedônio, os caracteres cirílicos forçam a codificação UCS-2, o que reduz um segmento de SMS de 160 para 70 caracteres. Um modelo que cabe confortavelmente em inglês pode se dividir em vários segmentos, ou ser cortado se o seu remetente limitar o tamanho.

Receber a mensagem real em um número +389 mostra o que um usuário veria: se o código aparece cedo o bastante para ser lido na prévia da notificação, se entra um fallback em alfabeto latino e se as dicas de preenchimento automático continuam funcionando. O seu parser deve capturar os dígitos em vez de uma frase fixa, já que serviços de terceiros escolhem sua própria redação e idioma.

Quais chamadas buscam um número da Macedônia do Norte por programação?

A documentação para desenvolvedores cobre cada campo; o esboço desta API de verificação por SMS é curto. Autentique-se com uma chave Bearer que começa com or_live_ em https://otproute.com/api/v1 e depois:

1. Carregue a lista de países com GET /api/v1/countries; o id da Macedônia do Norte é mk.
2. Peça o preço e a disponibilidade atuais com GET /api/v1/prices?country=mk&service=<id>.
3. Crie a ativação com POST /api/v1/activations e um corpo como {"service": "viber", "country": "mk"}.
4. Faça polling em GET /api/v1/activations/{id}, ou aguarde activation.sms_received em um webhook.
5. Cancele com POST /api/v1/activations/{id}/cancel quando um teste terminar antes.

As chamadas de webhook trazem X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstrua o HMAC-SHA256 sobre "<t>.<raw body>" com o segredo do endpoint, compare em tempo constante, recuse timestamps antigos e processe com base no id da ativação, para que um reenvio seja inofensivo. Cada conta tem até 10 chaves, 5 endpoints de webhook e 300 requisições por minuto.

Quais serviços estão abertos na rota +389 agora?

A Macedônia do Norte tem atualmente mais de 900 serviços no OTP Gateway. O retrato atual inclui Viber, WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), TikTok, Microsoft & Outlook, Signal, LinkedIn, Uber e ChatGPT (OpenAI).

Nem todo serviço está aberto a toda hora; isso é normal no estoque de SMS e é o motivo de preços e disponibilidade serem servidos pela API. Colegas que trabalham sem código podem seguir os mesmos passos no painel: crie uma conta, recarregue, escolha Macedônia do Norte e o serviço, e o código aparece na página da ativação assim que chega.

O código não chegou: e agora?

Cada ativação dura 20 minutos e você só paga se o SMS chegar. Cancele, ou deixe a janela fechar vazia, e o valor integral volta para a carteira automaticamente.

Antes de pedir de novo:

• Espere a janela terminar; um remetente lento é muito mais comum do que uma mensagem perdida.
• Confirme se o serviço aceita números virtuais; alguns os recusam por política, e é exatamente isso que o reembolso cobre.
• Tente de novo mais tarde ou por outra rota de serviço.
• Coloque uma pausa entre as tentativas para que um teste instável não dispare pedido após pedido na rota +389.

O guia de roteamento por país explica como planejar fallbacks entre mercados. Limite o uso aos seus próprios produtos e contas, respeite os termos de cada serviço e lembre-se de que a Política de Uso Aceitável da OTP Route se aplica.

E uma linha macedônia permanente, cobrança e sandbox?

A OTP Route não oferece um número de longo prazo em autoatendimento na Macedônia do Norte. Os Dedicated Numbers são um produto dos EUA e do Canadá, vendidos na hora a partir de $1.95/month; para uma linha +389 duradoura, escreva para [email protected] e a equipe dirá se as regras locais permitem, sem promessa de disponibilidade.

O pagamento é pay as you go, a partir de uma carteira pré-paga em USD recarregada por cartão ou USDT/USDC, sem mensalidade e com fatura em PDF a cada recarga. Contas de desenvolvimento podem ser movidas para sandbox mediante pedido, para que as integrações rodem com números e códigos simulados.

Perguntas frequentes

Posso verificar o SMS de cadastro macedônio do meu app sem um chip?

Pode. Peça um número do OTP Gateway com o país mk, use-o na sua própria tela de cadastro e leia a mensagem no painel ou por um webhook.

Quanto custa um código de verificação +389?

A partir de $0.20 por código; o valor exato depende do serviço e aparece no painel ou é devolvido por GET /api/v1/prices. Quando a janela de 20 minutos fecha sem SMS, você recebe o valor integral de volta.

As mensagens de verificação para números da Macedônia do Norte virão em cirílico?

Depende do remetente. O seu próprio app controla seu modelo, enquanto serviços de terceiros escolhem o idioma conforme as configurações da conta ou do aparelho, então capture apenas os dígitos.

Meu banco de dados deve manter o 0 inicial dos celulares macedônios?

Mantenha o formato E.164: +389 seguido do número nacional de oito dígitos, sem o 0 de tronco e sem espaços.

Posso manter um número da Macedônia do Norte para logins repetidos?

Não em autoatendimento. Os Dedicated Numbers de longo prazo existem apenas para os EUA e o Canadá; para +389, escreva ao suporte, e a resposta depende das regras locais.

Dá para rodar o CI com a Macedônia do Norte sem gastar crédito?

Peça o sandbox para uma conta de desenvolvimento. Ele simula números e códigos para que toda a integração rode de ponta a ponta sem cobranças na carteira.

Por que um serviço pode rejeitar o meu número +389?

Algumas plataformas recusam números virtuais. A ativação então expira ou pode ser cancelada, e o valor volta automaticamente para a sua carteira.

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.