Verificando cadastros +387 quando ninguém da equipe tem um chip bósnio

Nosso lançamento exige um teste +387, mas o chip está numa gaveta em Sarajevo. E agora?

É um aperto comum para equipes que lançam nos Bálcãs Ocidentais. O gerente de produto quer a prova de que usuários bósnios conseguem se cadastrar, o líder de QA tem um item no checklist dizendo "verificar com um número local", e o único chip físico +387 pertence a um colega que saiu na primavera passada.

Os motivos usuais para uma equipe chegar a esse ponto:

• Um lançamento regional que cobre a Bósnia e Herzegovina junto com Croácia, Sérvia e Montenegro, onde o caminho de cadastro de cada mercado precisa da sua própria checagem.
• Clientes da diáspora. Muita gente que mora na Alemanha, na Áustria, na Suécia e em outros lugares ainda mantém um número +387, então um produto fintech ou próximo de telecom pode receber números bósnios de usuários que nunca puseram os pés no país durante o cadastro.
• QA de localização. Bósnio, croata e sérvio são todos idiomas oficiais, e os alfabetos latino e cirílico aparecem no dia a dia, então textos e validação de formulários merecem uma passada real de ponta a ponta.

Em vez de enviar chips pelo correio, a OTP Route cuida do roteamento de OTP para você: o OTP Gateway entrega um número +387 para uma única verificação e devolve o SMS recebido por uma API de verificação por SMS que o seu harness de testes pode chamar.

Quais apps e plataformas conseguem enviar códigos para um número de verificação bósnio?

A cobertura é um retrato do momento, então use isto como ponto de partida e não como cardápio fixo. No momento em que escrevemos, as rotas da Bósnia e Herzegovina incluem Viber, WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Signal, Microsoft & Outlook, LinkedIn, Discord, Uber, Amazon e eBay.

No total, o país reúne mais de 1.600 serviços. Se você precisa de um número de verificação da Bósnia e Herzegovina para um serviço não listado aqui, consulte primeiro a lista atual. O Viber pesa mais nos Bálcãs do que em muitas outras regiões, o que vale lembrar se o seu próprio produto envia códigos por canais de mensagem além do SMS. Como a disponibilidade muda ao longo do dia, peça as opções atuais à API em vez de fixar uma lista na sua suíte de testes.

Como funciona o fluxo da API OTP da Bósnia e Herzegovina, chamada por chamada?

Para os testes bósnios, aponte o seu cliente para https://otproute.com/api/v1 e passe uma chave or_live_ como token Bearer. As chaves são criadas no console do desenvolvedor; uma conta pode ter até 10 chaves e 5 endpoints de webhook, com teto de 300 requisições por minuto.

1. Chame GET /api/v1/services e GET /api/v1/countries uma vez, guarde os ids em cache e confirme que ba está listado.
2. Verifique o custo com GET /api/v1/prices?country=ba&service=<id> para que o seu job registre o valor exato antes de gastar.
3. Envie POST /api/v1/activations com {"service": "<id>", "country": "ba"}. A resposta traz o id da ativação e o número +387 a digitar no app em teste.
4. Aguarde o webhook activation.sms_received ou consulte GET /api/v1/activations/{id} num intervalo moderado, se o seu runner não puder receber tráfego de entrada.
5. Se o teste for abortado, libere o número com POST /api/v1/activations/{id}/cancel para que o saldo volte imediatamente.

Nos webhooks, leia o cabeçalho X-OTPRoute-Signature (t=<unix>,v1=<hex>), calcule o HMAC-SHA256 sobre <t>.<raw body> com o segredo do endpoint, compare em tempo constante e descarte timestamps antigos. Como os eventos usam o id da ativação como chave, um código +387 entregue duas vezes deve ser gravado uma só vez. O guia de integração da API OTP aprofunda tentativas repetidas e tratamento de erros.

Existe um jeito sem código para a equipe de suporte ou operações?

Sim. Quem não tem acesso à API pode fazer o mesmo pelo navegador: entre na conta, abra o OTP Gateway, escolha Bósnia e Herzegovina e o serviço, veja o preço e confirme. O número aparece na tela, e o código surge ao lado dele quando o SMS for recebido. Isso serve a um atendente que reproduz o problema de cadastro de um cliente ou a um responsável de operações que confere um portal de parceiro depois de uma troca de telefone.

Como armazenar números +387 e interpretar o texto dos SMS bósnios?

Dentro do país, os números bósnios são discados com o prefixo de tronco 0, e os celulares costumam começar com 06. Em E.164 esse zero desaparece: um número escrito localmente como 061 seguido de seis dígitos vira +387 61 mais esses seis dígitos. Guarde apenas a forma E.164, remova espaços, traços e barras na entrada e rejeite qualquer coisa que ainda traga o zero inicial depois do código de país.

Os textos de verificação podem chegar em inglês ou num dos idiomas locais, e uma mensagem em cirílico é perfeitamente possível. Extraia o código com um padrão de dígitos em vez de procurar uma palavra específica e garanta que seus logs preservem o UTF-8, para que diacríticos como č, ć, š e ž não sejam corrompidos ao depurar uma execução que falhou.

E se uma execução de teste nunca receber o código?

Nada é cobrado quando um código não chega. Se nenhum SMS cair em 20 minutos, ou se você cancelar antes, o valor total volta para a carteira automaticamente. Quando isso acontecer:

• Deixe a janela seguir seu curso em vez de refazer o pedido de imediato; um SMS tardio ainda conta.
• Tente de novo um pouco mais tarde, ou escolha outra rota de serviço para o mesmo cenário.
• Confirme se o serviço de destino aceita números virtuais; alguns os recusam, e é exatamente por isso que o reembolso existe.
• Evite pedir em loop a partir do CI, o que queima o limite de requisições sem melhorar as chances.

Como reduzir entregas de OTP que falham reúne os padrões que costumam ajudar.

Podemos manter uma linha bósnia de longo prazo, e como funciona a cobrança?

Não como produto em autoatendimento. Os Números Virtuais Dedicados, que renovam a partir da carteira por $1.95/mês, são vendidos instantaneamente apenas para os Estados Unidos e o Canadá. Se sua equipe realmente precisa de uma linha +387 de longo prazo, escreva para [email protected]; a possibilidade depende das regras locais, e não há promessa de que possa ser providenciada.

A cobrança do gateway é uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Os fundos podem ser adicionados com cartão ou stablecoins USDT/USDC; uma fatura em PDF de cada depósito chega à sua caixa de entrada. Para o trabalho de integração, uma conta de desenvolvimento pode ser colocada em sandbox mediante solicitação, devolvendo números e códigos simulados para que seu pipeline rode sem tocar nos fundos da carteira. As tarifas atuais estão na página de preços, e você pode criar uma conta com um código por e-mail ou login do Google.

Perguntas frequentes

Posso testar o fluxo de cadastro bósnio do meu app sem um chip local?

Sim. Peça um número +387 para o seu serviço pelo OTP Gateway, digite-o no seu app e leia o código no painel ou pela API.

Qual id de país a OTP Route usa para a Bósnia e Herzegovina?

O id é ba. Informe-o como o campo country ao criar uma ativação e como o parâmetro de consulta country ao verificar preços.

Pago se o código +387 nunca chegar?

Não. Se nada chegar dentro da janela de 20 minutos, ou se você cancelar, o valor total volta para a sua carteira automaticamente.

Devo manter o zero inicial ao salvar um celular bósnio?

Não. Salve os números em E.164, ou seja, +387 seguido do número sem o zero de tronco doméstico.

Um número +387 para testes serve para uma conta em que precisaremos entrar de novo no mês que vem?

Não muito, pois cada número do gateway cobre uma verificação. Para logins repetidos, um Número Dedicado nos EUA ou no Canadá é a opção em autoatendimento; para uma linha bósnia de longo prazo, pergunte à equipe por e-mail.

Posso rodar testes de OTP bósnios no CI sem gastar dinheiro?

Sim, pedindo o modo sandbox numa conta de desenvolvimento. Ele devolve números e códigos simulados, para que o fluxo inteiro, incluindo webhooks, possa ser exercitado de graça.

Há regras sobre como esses números podem ser usados?

Sim. Siga os termos de cada serviço, use os números apenas para seus próprios produtos e contas legítimos, e lembre que a Política de Uso Aceitável da OTP Route se aplica a cada pedido.

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.