Checklist pré-voo para a verificação por SMS na Bolívia (+591)

O que entra no checklist antes de pedir um número +591?

A maioria das execuções de teste da Bolívia que falham se deve a algo que nunca foi configurado, e não à rota em si. Marque estes itens primeiro:

• Uma chave de API com o prefixo or_live_, criada no console do desenvolvedor e guardada como segredo na configuração do seu CI ou app. Uma chave por ambiente deixa os logs legíveis.
• Um endpoint de webhook que responde rápido por HTTPS, com o segredo de assinatura carregado. O polling também funciona, mas decida qual dos dois o seu harness usa.
• Saldo na carteira para a execução, ou uma conta sandbox se você só precisa exercitar a infraestrutura.
• O id do serviço do app que você está testando, obtido em GET /api/v1/services, mais o id de país da Bolívia, bo.
• Um parser de números de telefone no seu produto que aceite entradas +591, para que o número recebido possa mesmo ser digitado no formulário de cadastro.

Se algum item estiver faltando, corrija antes de gastar uma única ativação.

Quais apps posso rotear pela Bolívia atualmente?

A lista atual da Bolívia cobre mais de 1.700 serviços. Entre os mais pedidos pelas equipes estão WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Microsoft & Outlook, Discord, LinkedIn, Viber, Signal e AliExpress.

Essa variedade importa num mercado como o boliviano, onde um app de consumo muitas vezes depende de login por mensageiro, enquanto um produto de entregas ou de transporte exige a sua própria checagem de telefone. Trate a lista acima como um retrato do momento: a disponibilidade por serviço muda ao longo do dia, e é exatamente por isso que o endpoint de preços a informa em tempo real em vez de uma página estática.

Como executar o fluxo da API OTP da Bolívia, passo a passo?

Toda chamada vai para https://otproute.com/api/v1 com a sua chave Bearer, e o limite da conta é de 300 requisições por minuto.

1. Obtenha o preço e a disponibilidade atuais com GET /api/v1/prices?country=bo&service=<id>. Pule o pedido se a rota estiver vazia no momento.
2. Crie a ativação: POST /api/v1/activations com {"service": "<id>", "country": "bo"}. Guarde o id da ativação e o número retornado.
3. Digite o número na tela de cadastro ou login do app em teste.
4. Aguarde o webhook activation.sms_received ou consulte GET /api/v1/activations/{id} em um intervalo calmo.
5. Se o teste for abandonado, chame POST /api/v1/activations/{id}/cancel para que a retenção volte à carteira na hora.

Verifique cada webhook antes de confiar nele: o cabeçalho X-OTPRoute-Signature traz t=<unix>,v1=<hex>, sendo o hex um HMAC-SHA256 de "<t>.<raw body>" com o segredo do seu endpoint. Rejeite timestamps antigos. O guia de integração da API OTP mostra um handler completo.

Como armazenar e conferir um número boliviano?

Os celulares bolivianos têm oito dígitos depois do código de país +591 e geralmente começam com 6 ou 7. Guarde-os em E.164, por exemplo +591 seguido desses oito dígitos, sem espaços, e normalize qualquer coisa que o usuário digite com espaçamento local ou zero inicial antes de salvar.

O espanhol é o idioma em que chega a maioria das mensagens de verificação, embora a Bolívia reconheça oficialmente também o quéchua, o aimará, o guarani e muitos outros idiomas. Se o seu produto oferece uma interface em língua indígena, confira se o modelo de SMS que o seu próprio backend envia continua sendo exibido corretamente, já que esse caminho é separado do que apps de terceiros enviam.

As equipes costumam chegar à Bolívia para um lançamento regional nos países andinos, para QA de localização de fluxos em espanhol, ou para atender clientes que se cadastraram com um número boliviano enquanto moram no exterior.

Existe um caminho pelo painel para quem não escreve código?

Sim, e segue a mesma lógica do checklist. Uma pessoa de operações ou suporte pode:

1. Entrar em /signup com um código por e-mail ou com o Google e ativar a autenticação em dois fatores TOTP.
2. Abrir o OTP Gateway, escolher o serviço e depois a Bolívia; o preço atual aparece antes de qualquer cobrança.
3. Copiar o número para o app e manter a aba do painel aberta. O código aparece ali quando o SMS chegar.

Isso é útil para uma checagem pontual de uma tela de login em produção sem mexer na integração.

O que investigar quando um código boliviano nunca aparece?

Siga esta ordem:

• Deixe a janela correr. Uma ativação fica aberta por 20 minutos; encerrá-la antes desperdiça a tentativa.
• Confira as regras do próprio app. Alguns serviços rejeitam números virtuais de imediato, e o reembolso existe justamente para esse caso.
• Tente de novo mais tarde, ou outra rota. O estoque muda ao longo do dia, então uma segunda tentativa uma hora depois pode se comportar de outra forma.
• Não refaça o pedido em loop. Repetições rápidas contra um mesmo serviço tendem a piorar as coisas e poluir seus logs.

Se nenhum SMS chegar antes do fim da janela, o valor total volta para a carteira automaticamente. Mais padrões em como reduzir entregas de OTP que falham.

Posso manter uma linha boliviana de longo prazo, e como é a cobrança?

Não há número de longo prazo em autoatendimento para a Bolívia. A OTP Route vende Números Virtuais Dedicados apenas nos Estados Unidos e no Canadá, a partir de $1.95/mês; se sua equipe precisa de uma linha boliviana duradoura, escreva para [email protected] e a equipe dirá se algo é possível sob as regras locais, sem nenhuma promessa.

A cobrança é uma única carteira pré-paga em USD, sem mensalidade e sem plano para escolher. Recarregue com cartão ou com USDT/USDC, e uma fatura em PDF chega por e-mail a cada recarga. Para o trabalho de integração, peça o modo sandbox, que devolve números e códigos simulados sem gastar saldo. As tarifas completas estão em /pricing.

Perguntas frequentes

Posso testar o fluxo de cadastro do meu app na Bolívia sem um chip local?

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

Qual é o id de país da Bolívia na API da OTP Route?

Use bo tanto na consulta de preços quanto no corpo da ativação.

Pago se o SMS boliviano nunca chegar?

Não. Se nada chegar em 20 minutos, ou se você cancelar antes, o valor volta para a sua carteira automaticamente.

Em que idioma virão os textos de verificação da Bolívia?

Em geral em espanhol, embora a redação seja definida por cada app e possa seguir o idioma da conta ou do dispositivo.

Um pipeline de QA pode usar esse número +591 para testar toda noite?

Cada ativação cobre um código, então um job noturno pede um número novo a cada execução. Veja testes de SMS OTP em pipelines de CI para conhecer os padrões.

Um número boliviano serve para contas que precisam fazer login de novo meses depois?

Não muito, porque os números temporários não são mantidos. Para contas de longa duração, um Número Dedicado dos EUA ou do Canadá é a melhor opção.

Há regras sobre o que posso verificar com um número de verificação da Bolívia?

Sim. Use-o apenas para seus próprios produtos e contas empresariais legítimas, siga os termos de cada serviço e lembre que a Política de Uso Aceitável da OTP Route se aplica.

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.