Checklist previo para la verificación por SMS en Bolivia (+591)

¿Qué debe figurar en el checklist antes de pedir un número +591?

La mayoría de las pruebas fallidas en Bolivia se deben a algo que nunca se configuró, no a la ruta en sí. Revisa primero estos puntos:

• Una clave de API con el prefijo or_live_, creada en la consola de desarrolladores y guardada como secreto en tu CI o en la configuración de la app. Una clave por entorno mantiene legibles los registros.
• Un endpoint de webhook que responda rápido por HTTPS, con su secreto de firma cargado. La consulta periódica también funciona, pero decide cuál usa tu harness.
• Fondos en el monedero para la ejecución, o una cuenta sandbox si solo necesitas ejercitar la infraestructura.
• El id del servicio de la app que estás probando, tomado de GET /api/v1/services, más el id de país de Bolivia, bo.
• Un analizador de números telefónicos en tu producto que acepte entradas +591, para que el número recibido pueda escribirse de verdad en el formulario de registro.

Si falta alguno, corrígelo antes de gastar una sola activación.

¿Qué apps puedo enrutar ahora mismo por Bolivia?

La lista en vivo de Bolivia cubre más de 1,700 servicios. Entre los que más piden los equipos están WhatsApp, Telegram, Google (Gmail y YouTube), Facebook, Instagram, TikTok, Uber, Microsoft y Outlook, Discord, LinkedIn, Viber, Signal y AliExpress.

Esa amplitud importa en un mercado como Bolivia, donde una app de consumo suele apoyarse en un inicio de sesión de mensajería mientras que un producto de reparto o de transporte necesita su propia verificación telefónica. Toma la lista anterior como una instantánea: la disponibilidad de cada servicio cambia a lo largo del día, y por eso el endpoint de precios la informa en vivo en lugar de una página estática.

¿Cómo ejecuto el flujo de la API OTP de Bolivia, paso a paso?

Cada llamada va a https://otproute.com/api/v1 con tu clave Bearer, y el límite de la cuenta es de 300 solicitudes por minuto.

1. Obtén el precio y la disponibilidad actuales con GET /api/v1/prices?country=bo&service=<id>. Omite el pedido si la ruta está vacía en este momento.
2. Crea la activación: POST /api/v1/activations con {"service": "<id>", "country": "bo"}. Guarda el id de activación y el número que devuelve.
3. Introduce el número en la pantalla de registro o de inicio de sesión de la app bajo prueba.
4. Espera el webhook activation.sms_received o consulta GET /api/v1/activations/{id} a un intervalo tranquilo.
5. Si la prueba se abandona, llama a POST /api/v1/activations/{id}/cancel para que la retención vuelva al monedero de inmediato.

Verifica cada webhook antes de confiar en él: la cabecera X-OTPRoute-Signature lleva t=<unix>,v1=<hex>, donde el hex es un HMAC-SHA256 de "<t>.<raw body>" con el secreto de tu endpoint. Rechaza las marcas de tiempo antiguas. La guía de integración de la API OTP recorre un manejador completo.

¿Cómo se debe almacenar y validar un número boliviano?

Los móviles bolivianos tienen ocho dígitos después del código de país +591 y normalmente empiezan por 6 o 7. Guárdalos en E.164, por ejemplo +591 seguido de esos ocho dígitos, sin espacios, y normaliza antes de guardar cualquier cosa que el usuario escriba con espaciado local o con un cero inicial.

El español es el idioma en que llegan la mayoría de los mensajes de verificación, aunque Bolivia también reconoce oficialmente el quechua, el aimara, el guaraní y muchas otras lenguas. Si tu producto ofrece una interfaz en una lengua indígena, comprueba que la plantilla de SMS que envía tu propio backend se muestre bien, ya que esa vía es independiente de lo que envían las apps de terceros.

Los equipos suelen llegar a Bolivia por un lanzamiento regional en los países andinos, para el QA de localización de flujos en español o para atender a clientes que se registraron con un número boliviano mientras vivían en el extranjero.

¿Hay una vía en el panel para quienes no programan?

Sí, y sigue la misma lógica del checklist. Una persona de operaciones o soporte puede:

1. Iniciar sesión en /signup con un código por correo o con Google, y activar la autenticación en dos pasos TOTP.
2. Abrir el OTP Gateway, elegir el servicio y luego Bolivia; el precio en vivo aparece antes de que se cobre nada.
3. Copiar el número en la app y mantener abierta la pestaña del panel. El código aparece allí cuando llega el SMS.

Es útil para una comprobación puntual de una pantalla de inicio de sesión en producción sin tocar la integración.

¿Qué reviso cuando un código boliviano no aparece?

Repasa estos puntos en orden:

• Deja correr la ventana. Una activación permanece abierta 20 minutos; cerrarla antes desperdicia el intento.
• Revisa las reglas de la propia app. Algunos servicios rechazan los números virtuales de plano, y el reembolso existe precisamente para ese caso.
• Reintenta más tarde o prueba otra ruta. El inventario se mueve durante el día, así que un segundo intento una hora después puede comportarse distinto.
• No repitas el pedido en bucle cerrado. Las repeticiones rápidas contra un mismo servicio tienden a empeorar las cosas y a llenar tus registros.

Si no llega ningún SMS antes de que se cierre la ventana, el importe completo vuelve al monedero automáticamente. Hay más patrones en cómo reducir las entregas fallidas de OTP.

¿Puedo conservar una línea boliviana a largo plazo y cómo se factura?

No existe un número de largo plazo en autoservicio para Bolivia. OTP Route vende Dedicated Virtual Numbers solo en Estados Unidos y Canadá, desde $1.95/mes; si tu equipo necesita una línea boliviana duradera, escribe a [email protected] y el equipo te dirá si hay alguna posibilidad según la normativa local, sin ninguna promesa.

La facturación es un único monedero prepago en USD sin cuota mensual ni plan que elegir. Recarga con tarjeta o con USDT/USDC, y recibirás por correo una factura en PDF por cada recarga. Para el trabajo de integración, pide el modo sandbox, que devuelve números y códigos simulados sin gastar fondos. Las tarifas completas están en /pricing.

Preguntas frecuentes

¿Puedo probar el registro de mi app en Bolivia sin una SIM local?

Sí. Pide un número +591 para tu servicio en el OTP Gateway, introdúcelo en tu app y lee el código en el panel o por la API.

¿Cuál es el id de país de Bolivia en la API de OTP Route?

Usa bo tanto en la consulta de precios como en el cuerpo de la activación.

¿Pago si el SMS de Bolivia nunca llega?

No. Si no llega nada en 20 minutos, o cancelas antes, el importe vuelve a tu monedero automáticamente.

¿En qué idioma llegarán los textos de verificación de Bolivia?

Normalmente en español, aunque la redacción la fija cada app y puede seguir el idioma de la cuenta o del dispositivo.

¿Puede un pipeline de QA usar este número +591 para pruebas todas las noches?

Cada activación cubre un código, así que un trabajo nocturno pide un número nuevo por ejecución. Consulta pruebas de SMS OTP en pipelines de CI para ver patrones.

¿Sirve un número de Bolivia para cuentas que deben iniciar sesión de nuevo meses después?

No mucho, porque los números de un solo uso no se conservan. Para cuentas de larga vida, lo más adecuado es un Dedicated Number de EE. UU. o Canadá.

¿Hay reglas sobre lo que puedo verificar con un número de verificación de Bolivia?

Sí. Úsalo solo para tus propios productos y cuentas empresariales legítimas, respeta los términos de cada servicio y recuerda que se aplica la Política de Uso Aceptable de OTP Route.

Los nombres de los servicios son marcas registradas de sus respectivos propietarios. OTP Route no está afiliado a ellos. Usa los números de forma lícita y respeta las condiciones de cada servicio y nuestra Política de Uso Aceptable.