Cómo enrutar los códigos de verificación de la República del Congo (+242) a tu stack de pruebas

¿Qué llamadas a la API obtienen un código +242 de principio a fin?

Todo vive bajo https://otproute.com/api/v1 y se autentica con una clave Bearer que empieza por or_live_. Genera las claves en la consola de desarrolladores; una cuenta puede tener hasta 10, lo que facilita dar credenciales separadas, revocables de forma independiente, a staging, a CI y al portátil de un compañero.

Una ejecución de pruebas típica para el mercado de Brazzaville es así:

1. Consulta GET /api/v1/services y GET /api/v1/countries y guarda los ids en caché. La República del Congo es cg (no hay que confundirla con su vecino más grande, que tiene su propio id y su página en Congo (RDC)).
2. Pide a GET /api/v1/prices?country=cg&service=<id> el precio en vivo y la disponibilidad de la app que pruebas.
3. Crea la activación con POST /api/v1/activations y un cuerpo como {"service": "telegram", "country": "cg"}. Recibes un id de activación y un número +242.
4. Escribe ese número en la pantalla de registro o de acceso de tu propio producto.
5. Recoge el código congoleño desde una entrega de webhook o consultando GET /api/v1/activations/{id}. Si la prueba se aborta, libérala con POST /api/v1/activations/{id}/cancel.

Ejecuta GET /api/v1/balance antes de que empiece una batería de pruebas para que un monedero vacío haga fallar el trabajo pronto y no a medias. El límite de 300 solicitudes por minuto deja mucho margen para unos cuantos workers en paralelo. Los formatos completos de solicitud y respuesta están en la documentación para desarrolladores.

¿Cómo configuro un webhook firmado para las activaciones congoleñas?

La consulta periódica va bien para un ingeniero que recorre un flujo a mano; un webhook es más amable con una flota de CI. Añade un endpoint en la consola de desarrolladores (se permiten cinco por cuenta) y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada solicitud lleva X-OTPRoute-Signature: t=<unix>,v1=<hex>. Reconstruye el HMAC-SHA256 de "<t>.<raw body>" con el secreto de ese endpoint, compáralo con v1 mediante una comprobación en tiempo constante y descarta todo lo que tenga una marca de tiempo antigua. Calcula el hash sobre los bytes sin procesar antes de analizar el JSON, porque un JSON reserializado rara vez coincide byte a byte.

Trata los eventos como indexados por el id de activación. Si el mismo evento llega dos veces, tu manejador debe notar que el id ya está resuelto y devolver simplemente un estado de éxito. La guía de captura por webhook recorre patrones de colas que evitan que los ejecutores de pruebas lentos agoten el tiempo de espera.

¿Qué servicios puede cubrir un número de verificación de Congo?

La captura de hoy para cg incluye WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber e imo. En total, el país tiene más de 1,000 servicios en el OTP Gateway.

Esa lista cambia durante el día a medida que las rutas se abren y se cierran, así que nunca la fijes en el código. Haz que tu arnés de pruebas pregunte al endpoint de precios por el servicio concreto que necesita, y que omita o reprograme con elegancia cuando no haya disponibilidad. Las apps de mensajería tienden a dominar la oferta congoleña, lo que coincide con la forma en que muchos clientes de allí conocen un producto nuevo: mediante un enlace compartido en un grupo de chat y no buscando en una tienda de apps.

¿Cómo se deben guardar y normalizar los números +242?

Los números de la República del Congo tienen nueve dígitos después del código de país y, a diferencia de muchos planes, el 0 inicial forma parte del número de abonado y no es un prefijo troncal. Las líneas móviles se escriben habitualmente como 06… o 05… a nivel local y como +242 06… en formato internacional. Un normalizador copiado de una base de código europea que elimina cualquier cero inicial los corromperá sin avisar, así que guarda exactamente la cadena E.164 que devuelve la API y valida la longitud por país en lugar de aplicar una única regla global.

El francés es el idioma oficial y el habitual de los SMS de verificación, aunque el lingala y el kituba se hablan mucho en el día a día. Espera caracteres con acento en algunas plantillas y asegúrate de que tu analizador extrae los dígitos con un patrón en lugar de depender de un texto fijo en inglés.

Los equipos suelen hacer pruebas aquí al lanzar un producto en el África Central francófona, al dar soporte a personal de operaciones en Brazzaville o Pointe-Noire, o al atender a clientes congoleños en el extranjero que aún se registran con un número de su país. Revisar todo el flujo sobre una ruta +242 real detecta problemas de formato y de textos que un simulador pasaría por alto.

¿Y si no llega ningún código al número +242?

El silencio suele ser un problema de ruta o de aceptación, no un fallo de integración. Un protocolo razonable:

• Deja que la ventana de 20 minutos siga su curso antes de sacar conclusiones; algunos remitentes agrupan su tráfico saliente.
• Confirma que el servicio de destino acepta números virtuales. Varios no lo hacen, y por eso precisamente un código que no llega no cuesta nada.
• Vuelve a intentarlo más tarde, o cambia a otra ruta de servicio, en lugar de lanzar pedidos nuevos en un bucle rápido que consume el límite de solicitudes.
• Cancela los números que ya no necesites para que los fondos regresen de inmediato en lugar de esperar a la caducidad.

Nuestro artículo sobre cómo reducir las entregas fallidas de OTP cubre con más profundidad el backoff y los presupuestos de reintentos.

¿Puedo conservar una línea congoleña de larga duración?

No existe ningún número de larga duración en autoservicio para la República del Congo. El OTP Gateway emite un número por código de verificación, y es el único producto que se ofrece ahora mismo para cg.

Los Dedicated Virtual Numbers de OTP Route son un producto de Estados Unidos y Canadá desde $1.95/month, con SMS entrantes y salientes además de llamadas desde el navegador. Si tu equipo realmente necesita una línea congoleña persistente, escribe a [email protected]; que se pueda gestionar algo depende de la normativa local, así que tómalo como una consulta y no como una promesa. Las ventajas e inconvenientes se resumen en números temporales frente a dedicados.

¿Cómo se factura y se prueba de forma segura una configuración de enrutamiento OTP de Congo?

La facturación sale de un único monedero prepago en USD, sin suscripción ni niveles de plan. Recarga con tarjeta o con stablecoins USDT/USDC, y cada recarga genera una factura en PDF por correo para tu equipo de finanzas.

Antes de conectar dinero real a un pipeline, pide a soporte que cambie una cuenta de desarrollo al modo sandbox. Devuelve números y códigos simulados, de modo que puedes ejercitar todo el recorrido de la API de verificación por SMS de extremo a extremo sin gastar nada. Usa OTP Route solo en tus propios productos y en cuentas que tengas derecho a operar; los términos de cada servicio y nuestra Política de Uso Aceptable siguen aplicándose. Consulta los precios para ver cómo aparecen los cargos y reembolsos en el monedero.

Preguntas frecuentes

¿Cuál es el id de país de la República del Congo en la API de OTP Route?

Es cg. La República Democrática del Congo es otro país con su propio id, así que verifica bien a cuál se refiere tu configuración.

¿Puedo probar el registro congoleño de mi app sin una SIM local?

Sí. Pide un número +242 para pruebas en el OTP Gateway, introdúcelo en tu app y lee el código en el panel o a través de la API.

¿Elimino el cero inicial al guardar un número +242?

No. En la República del Congo el 0 pertenece al número de abonado de nueve dígitos, así que conserva el valor E.164 exactamente como lo devuelve la API.

¿En qué idioma llegarán los SMS de verificación del Congo?

La mayoría llegan en francés, a veces en inglés en las apps internacionales. Extrae los dígitos con un patrón en lugar de buscar palabras concretas.

¿Me cobran si el código no aparece?

No. Si la ventana se cierra sin SMS, o cancelas antes, el importe completo vuelve automáticamente a tu monedero.

¿Cuánto cuesta recibir un SMS OTP de Congo?

Desde $0.20 por código; el precio +242 de cada app se cotiza en vivo, así que consúltalo antes de pedir.

¿Hay un sandbox para construir la integración?

Sí, bajo petición. Soporte puede poner una cuenta de desarrollo en modo sandbox, que devuelve números y códigos simulados sin tocar los fondos del monedero.

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.