Cómo llevar los códigos de verificación de Chad (+235) a tu stack

¿Cuál es la secuencia de llamadas de una solicitud a la API OTP de Chad?

Las solicitudes para Chad llegan a la misma URL base que las de cualquier otro mercado, https://otproute.com/api/v1, firmadas con una clave Bearer or_live_. Creas las claves en la consola de desarrolladores; una cuenta puede tener hasta 10 y hacer 300 solicitudes por minuto.

Una ejecución típica para Chad requiere cuatro llamadas:

1. GET /api/v1/countries y GET /api/v1/services para confirmar que td figura en la lista y consultar el id del servicio que tu prueba apunta.
2. GET /api/v1/prices?country=td&service=<id> para leer el precio en vivo de ese par antes de gastar nada.
3. POST /api/v1/activations con un cuerpo como {"service": "telegram", "country": "td"}. La respuesta incluye un id de activación y el número +235 que debes escribir en la aplicación bajo prueba.
4. Espera el código y deja que la activación se complete, o llama a POST /api/v1/activations/{id}/cancel si la prueba se interrumpe antes.

Vale la pena llamar a GET /api/v1/balance al inicio de un trabajo de CI para que un pipeline falle de forma visible con un monedero vacío en lugar de agotar el tiempo a la mitad. La referencia completa está en la documentación para desarrolladores.

¿Cómo debe tratar un receptor de webhooks los códigos +235?

Sondear GET /api/v1/activations/{id} cada pocos segundos va bien para un solo script. Cuando varios ejecutores de pruebas comparten una clave, un webhook es más limpio. Registra un endpoint (cinco por cuenta) y suscríbete a activation.sms_received, activation.expired y activation.cancelled.

Cada solicitud incluye un encabezado X-OTPRoute-Signature con la forma t=<unix>,v1=<hex>. Reconstruye la cadena <t>.<raw body>, fírmala con HMAC-SHA256 usando el secreto del endpoint y compárala con v1 en tiempo constante. Rechaza cualquier solicitud con una marca de tiempo antigua; así se cierra la puerta a las solicitudes reproducidas. Nuestra guía sobre cómo proteger webhooks OTP con HMAC lo explica en varios lenguajes.

Trata el id de activación como clave de idempotencia. Si el mismo evento se entrega dos veces, la segunda escritura no debe cambiar nada, y tu manejador debe devolver un 2xx rápidamente y hacer el trabajo lento después.

¿Qué aplicaciones pueden enviar códigos a un número de verificación de Chad?

La instantánea en vivo de td lista más de 1,500 servicios. Entre los populares están WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Viber, imo, Signal, Microsoft & Outlook, LinkedIn, ChatGPT (OpenAI) y AliExpress.

La disponibilidad no es estática. Las rutas se abren y se cierran durante el día a medida que nuestros socios de red cambian la capacidad, así que un servicio visible esta mañana puede faltar esta tarde. Lee el catálogo en tiempo de ejecución en lugar de fijarlo en el código, y mantén un segundo servicio en tu plan de pruebas por si el primero no está disponible temporalmente para Chad.

¿Cómo guardo y normalizo un número +235?

Chad usa un plan de numeración cerrado: los números nacionales tienen ocho dígitos y no hay prefijo troncal que quitar, por lo que la forma E.164 es simplemente +235 seguido de esos ocho dígitos. Eso hace de Chad uno de los mercados más fáciles de validar.

• Guarda la cadena E.164 completa en una sola columna en lugar de separar el código de país y el número de abonado.
• Si tu formulario acepta espacios o la agrupación de dos en dos que la gente suele escribir, elimínalos antes de guardar.
• Comprueba en las pruebas que un valor con un 0 inicial sobrante se rechaza o se limpia, ya que los usuarios que vienen de otros planes a veces lo añaden por costumbre.

El francés y el árabe son los idiomas oficiales. La redacción de un SMS de verificación, sin embargo, sigue el idioma configurado en la aplicación o en la cuenta, así que una batería de pruebas de localización debe revisar por separado las plantillas en francés, árabe e inglés.

¿Por qué los equipos de producto hacen pruebas en Chad?

Pocos equipos de ingeniería tienen su sede en Yamena, y precisamente por eso resulta útil un número +235 remoto. Estos son los motivos más comunes:

• Lanzamientos en el África central francófona, donde un producto ya activo en mercados vecinos añade Chad a su selector de país de registro y necesita demostrar que el flujo funciona.
• QA de localización en árabe y francés, incluida la disposición de derecha a izquierda de la pantalla de entrada del código.
• Clientes de la diáspora que conservan un número chadiano mientras viven en el extranjero, lo que afecta a cómo tus reglas antifraude interpretan el código de país.
• Equipos de operaciones que gestionan cuentas de mensajería empresarial para socios regionales.

El patrón general se describe en enrutamiento por país para OTP.

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

Un número silencioso suele ser un problema de ruta o de aceptación, no un error de tu código. Revísalo en este orden:

• Deja que la ventana de 20 minutos corra; algunos remitentes agrupan sus mensajes.
• Comprueba que el servicio de destino acepta números virtuales. Algunos no lo hacen, y por eso existe el reembolso.
• Inténtalo más tarde, o con otro servicio en el mismo país, en lugar de repetir pedidos en un bucle cerrado. Los reintentos rápidos pueden activar los límites del propio remitente.
• Confirma que tu manejador verificó bien la firma; un webhook rechazado parece un código que no llegó.

Si la ventana se cierra o cancelas, el importe completo vuelve al monedero sin necesidad de abrir un ticket de soporte. Hay más tácticas en cómo reducir las entregas fallidas de OTP.

¿Hay una línea de Chad a largo plazo y cómo se factura?

No existe un número de largo plazo de autoservicio para Chad. Los Números Dedicados son un producto de Estados Unidos y Canadá, desde $1.95/mes, con SMS entrantes y salientes y llamadas desde el navegador. Si necesitas una línea +235 duradera, escribe a [email protected]; la disponibilidad depende de la normativa local y no es algo que podamos prometer.

Los cargos por códigos +235 salen de un único saldo prepago en USD; no hay nivel de suscripción ni cuota mensual. Se recarga con tarjeta o con las stablecoins USDT/USDC, y tras cada depósito llega a tu bandeja una factura en PDF. Las tarifas en vivo aparecen en la página de precios. Para el trabajo de integración, pide el cambio a sandbox: devuelve números y códigos simulados para que puedas ensayar el flujo sin tocar los fondos del monedero. Abrir una cuenta nueva requiere un código de seis dígitos por correo, o el inicio de sesión de Google si tu equipo lo prefiere.

Preguntas frecuentes

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

Usa td en el campo country de POST /api/v1/activations y en la consulta de precios.

¿Puedo probar el registro de mi aplicación en Chad sin una SIM local?

Sí. Pide un número +235 en el OTP Gateway, introdúcelo en tu aplicación y lee el código en el panel, en la API o en un webhook.

¿Cuánto tiempo se puede usar un número +235?

Una activación permanece abierta durante 20 minutos y cubre un solo código. Pasado ese tiempo, pide uno nuevo.

¿Pago si el SMS nunca llega?

No. Si no llega ningún mensaje antes de que se cierre la ventana, o cancelas, el importe se acredita de vuelta a tu monedero automáticamente.

¿Hay que quitar un prefijo troncal de los números de Chad?

No. Chad no tiene prefijo troncal, así que la forma guardada es +235 más el número nacional de ocho dígitos.

¿Puedo conservar un número de Chad para accesos posteriores?

No en autoservicio. Los Números Dedicados de largo plazo existen solo en EE. UU. y Canadá; para Chad, escribe al equipo para consultar qué es posible.

¿Hay normas de uso?

Sí. Sigue los términos de cada servicio y la Política de Uso Aceptable de OTP Route; el gateway es para probar y operar tus propios productos y cuentas legítimos.

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.