Cómo recibir códigos SMS de Botsuana con una llamada de API

¿Por qué llamadas de API pasa una activación de Botsuana?

Todo cuelga de https://otproute.com/api/v1 y se autentica con una clave Bearer que empieza por or_live_. Las claves se crean en la consola de desarrolladores; una cuenta puede tener hasta 10, y el límite es de 300 solicitudes por minuto, más que suficiente para una suite de pruebas que pide un puñado de números de Botsuana por ejecución.

Una secuencia típica es así:

1. Llama una vez a GET /api/v1/countries y guárdalo en caché, para que tu código sepa que bw es el identificador de Botsuana.
2. Pregunta a GET /api/v1/prices?country=bw&service=whatsapp por el precio y la disponibilidad en vivo de la combinación que necesitas. Los precios varían según el servicio y el país, así que léelos en lugar de fijarlos en el código.
3. Envía POST /api/v1/activations con el cuerpo {"service": "whatsapp", "country": "bw"}. La respuesta trae el número +267 y un id de activación.
4. Introduce ese número en el formulario de registro bajo prueba y luego consulta GET /api/v1/activations/{id} o espera un webhook.
5. Si la prueba se aborta, llama a POST /api/v1/activations/{id}/cancel para que los fondos vuelvan al monedero de inmediato.

La guía de integración de la API de OTP recorre las mismas llamadas pensando en el manejo de errores.

¿Cómo debe tratar mi receptor de webhooks los eventos +267?

Los webhooks son la opción más limpia cuando se ejecuta más de una prueba en paralelo. Registra un endpoint (cinco por cuenta) y escucha activation.sms_received, activation.expired y activation.cancelled, cada uno identificado por el id de activación que recibiste al pedir.

Cada entrega lleva una cabecera X-OTPRoute-Signature con la forma t=<unix>,v1=<hex>. Reconstruye el HMAC-SHA256 de la cadena "<t>.<raw body>" con el secreto del endpoint, compáralo con v1 en tiempo constante y descarta todo lo que tenga una marca de tiempo antigua. Analiza el JSON solo después de que la comprobación pase, porque reserializar el cuerpo cambia los bytes.

Haz el manejador idempotente: guarda el id de activación cuando se consuma el código e ignora una repetición del mismo evento. Los detalles están en proteger los webhooks de OTP con HMAC.

¿Para qué sirve un número de verificación de Botsuana?

La instantánea en vivo de Botsuana lista más de 800 servicios. Entre los populares están WhatsApp, Telegram, Google (Gmail y YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Microsoft y Outlook, Amazon, LinkedIn, Uber, Signal, Netflix y Airbnb.

La disponibilidad de una ruta concreta cambia durante el día a medida que varía la capacidad de los operadores. Por eso el endpoint de precios también informa de lo que se puede pedir ahora mismo: toma su respuesta como fuente de verdad, no esta lista.

¿Qué deben saber los ingenieros sobre los números de teléfono de Botsuana?

Botsuana usa el código de país +267 y no tiene prefijo troncal, así que el número nacional se marca tal como se escribe. Los números móviles tienen ocho dígitos y empiezan por 7. En E.164 eso da +267 seguido de los ocho dígitos, sin ningún cero que eliminar.

Algunos puntos prácticos para quien guarde o valide estos números:

• Normaliza todo a E.164 al recibir la entrada. Los usuarios pueden escribir 00267, espacios o un signo más inicial; redúcelos todos a una forma canónica antes de comparar o deduplicar.
• No reutilices la regla de prefijo troncal de un mercado vecino. Un validador copiado de un país que elimina un cero inicial rechazará entradas válidas de Botsuana.
• El inglés y el setsuana son los idiomas principales. Los códigos de apps globales suelen llegar en inglés, pero tu analizador debe extraer los dígitos por patrón en lugar de depender de una redacción fija.

Los equipos prueban aquí cuando lanzan un producto en el África austral, revisan la incorporación de clientes que están al otro lado de la frontera con Sudáfrica, o gestionan operaciones regionales que necesitan un número local +267 para pruebas.

¿Puede alguien que no programa pedir un código de Botsuana desde el panel?

Sí. Regístrate con tu correo y un código de seis dígitos (o con Google), recarga el monedero, abre el OTP Gateway, elige Botsuana y el servicio, comprueba el precio mostrado y haz el pedido. Pega el número en la app que estás probando; el código aparece en el panel en cuanto el SMS llega a la ruta.

Cada activación permanece abierta 20 minutos. Si no llega ningún mensaje en ese tiempo, o cancelas antes, el importe completo vuelve a tu monedero automáticamente.

¿Y si el código de Botsuana nunca llega?

La velocidad de entrega depende del servicio y de la ruta, así que dale tiempo a la ventana antes de actuar. Si se cierra vacía, repasa esta lista:

• Inténtalo de nuevo un poco más tarde, o elige otra ruta de servicio para el mismo flujo si tu producto lo admite.
• Confirma que la app al otro lado está dispuesta a enviar un SMS a una línea virtual; unas pocas apps rechazan estos números, y por eso las activaciones sin usar vuelven a tu saldo.
• Deja que termine la ventana de 20 minutos en lugar de cancelar al cabo de un minuto.
• Evita repetir pedidos en un bucle cerrado desde CI; añade un retroceso entre intentos.

Hay más patrones en reducir las entregas fallidas de OTP. Pruebes lo que pruebes, respeta los términos de cada servicio; la Política de Uso Aceptable de OTP Route se aplica a todos los pedidos.

¿Existe una línea +267 de largo plazo y cómo se gestiona la facturación?

No como producto de autoservicio. Los Números Dedicados se venden al instante solo en Estados Unidos y Canadá, desde $1.95/month; para Botsuana puedes escribir a [email protected] para consultarlo, y la disponibilidad depende de la normativa local. Consulta números virtuales para ver qué incluyen las líneas de EE. UU. y Canadá.

La facturación es un único monedero prepago en USD sin cuota mensual, que se recarga con tarjeta o con USDT/USDC, y cada recarga viene con una factura en PDF por correo. Para el trabajo de integración, una cuenta de desarrollo puede pasarse a sandbox bajo petición para que todo el flujo funcione con números y códigos simulados. Las tarifas actuales están en la página de precios.

Preguntas frecuentes

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

Es bw. Pásalo como country en POST /api/v1/activations y en la cadena de consulta de GET /api/v1/prices.

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

Sí. Pide un número +267 para el servicio de tu app mediante el OTP Gateway y lee el código en el panel o en tu webhook, sin tarjeta SIM ni teléfono de por medio.

¿Los números de Botsuana necesitan un cero inicial al guardarse?

No. Botsuana no tiene prefijo troncal, así que guarda el número como +267 más el móvil de ocho dígitos.

¿Se me cobra si el código +267 no llega?

No. Si no llega nada dentro de la ventana de 20 minutos, o cancelas, el importe completo vuelve a tu monedero automáticamente.

¿Puedo conservar un número de Botsuana para futuros inicios de sesión?

No hay un número de largo plazo de autoservicio para Botsuana. Las líneas de largo plazo son un producto de EE. UU. y Canadá; escribe a [email protected] si necesitas consultar otras opciones.

¿Puedo ejecutar pruebas de Botsuana en CI sin gastar fondos del monedero?

Pide que tu cuenta de desarrollo se pase a sandbox. Devuelve números y códigos simulados, de modo que todo el camino de la API y de los webhooks se puede ejercitar sin coste.

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.