Verificación por SMS de Túnez (+216): lista de comprobación para desarrolladores

¿Qué debe incluir la lista de comprobación previa antes de pedir un número +216?

Repasa esta lista una vez y la mayoría de las pruebas con Túnez irán sin contratiempos:

• Clave de API lista. Crea una clave Bearer en la consola de desarrolladores; las claves reales empiezan por or_live_.
• Billetera con fondos. El OTP Gateway descuenta de tu saldo prepagado en USD; GET /api/v1/balance lo confirma desde un script.
• Webhook accesible. Registra un endpoint HTTPS, guarda su secreto y confirma que el reloj de tu servidor es exacto para que pasen las comprobaciones de marca de tiempo.
• Precio comprobado. Llama a GET /api/v1/prices?country=tn&service=<id> para el servicio exacto que piensas probar.
• Campo de teléfono probado. Asegúrate de que tu propio formulario acepta un número nacional tunecino de ocho dígitos y uno internacional +216 pegado.
• Analizador tolerante. Confirma que la extracción del código funciona con cuerpos de mensaje en árabe, francés e inglés (ver más abajo).
• Condiciones revisadas. Estás probando tu propio producto u operando tu propia cuenta legítima, conforme a las reglas del servicio y a la Política de Uso Aceptable de OTP Route.

¿Cómo se formatean los números tunecinos en E.164?

Túnez usa un plan de numeración cerrado: todos los números de abonado tienen ocho dígitos y no hay prefijo troncal, así que no hay que quitar nada antes de añadir el código de país. La forma E.164 es simplemente +216 seguido de esos ocho dígitos. La gente local suele escribir los números en grupos como xx xxx xxx, así que elimina espacios, puntos y guiones al normalizar. Evita validar contra una lista fija de dígitos iniciales; la comprobación de longitud junto con una biblioteca telefónica fiable es más segura que una tabla de rangos escrita a mano.

¿En qué idiomas llegan los textos de verificación tunecinos?

El árabe es el idioma oficial, el árabe tunecino es lo que se habla a diario y el francés es habitual en los negocios, la administración y muchas apps. Por eso, una misma ejecución de pruebas puede recibir códigos en francés, inglés o árabe según el remitente y la configuración regional del dispositivo.

Los mensajes en árabe viajan como SMS Unicode y pueden contener marcas de dirección de derecha a izquierda alrededor de los dígitos. Una expresión regular que capture la primera secuencia de cuatro a ocho dígitos ASCII, tras eliminar las marcas invisibles, funciona en los tres idiomas. Los equipos suelen añadir Túnez a su matriz para lanzamientos en el norte de África francófono junto con Marruecos y Argelia, para el QA de localización de diseños de derecha a izquierda, o porque atienden a clientes tunecinos que viven en Europa; un número +216 para pruebas cubre cada uno de esos casos.

Paso a paso: recibir un OTP de Túnez a través de la API

La instantánea en vivo enumera más de 1,700 servicios para Túnez, entre ellos Facebook, WhatsApp, Instagram, Telegram, TikTok, Google (Gmail & YouTube), Snapchat, Signal, LinkedIn, Discord, ChatGPT (OpenAI), Microsoft & Outlook, Amazon y Uber. La disponibilidad cambia durante el día, así que haz que tu lógica de enrutamiento OTP la lea de GET /api/v1/services y GET /api/v1/countries al empezar una ejecución.

1. Envía POST /api/v1/activations con {"service": "facebook", "country": "tn"} y guarda el id de activación.
2. Escribe el número devuelto en la app que estás probando y desencadena el código.
3. Gestiona activation.sms_received en tu webhook: verifica X-OTPRoute-Signature (HMAC-SHA256 de la marca de tiempo, un punto y el cuerpo sin procesar), rechaza las marcas de tiempo antiguas e ignora los duplicados de un id de activación que ya procesaste.
4. Sin webhook, consulta periódicamente GET /api/v1/activations/{id}, manteniéndote muy por debajo del límite de 300 solicitudes por minuto.
5. Llama a POST /api/v1/activations/{id}/cancel si la prueba se aborta.

La documentación de la API enumera todos los campos, y la guía de pruebas en CI muestra cómo integrarlo en un pipeline.

Paso a paso desde el panel

1. Crea una cuenta con tu correo y un código de seis dígitos, o con el inicio de sesión de Google, y activa el doble factor TOTP.
2. Añade fondos con tarjeta o con USDT/USDC.
3. Elige Túnez, luego el servicio, y comprueba el precio mostrado.
4. Haz el pedido, copia el número +216 y solicita el código en la app de destino.
5. Copia el código tunecino del panel en cuanto aparezca y termina el registro que estás probando.

Solución de problemas: ¿y si el código +216 nunca aparece?

Cada activación dura 20 minutos, y solo pagas cuando llega un código. Si la ventana caduca o cancelas, el importe completo vuelve a la billetera.

• No llegó nada: deja que la ventana se agote y luego reintenta más tarde o con otra ruta de servicio si la prueba lo permite.
• El servicio rechazó el número: algunos servicios rechazan los números virtuales; el reembolso cubre ese caso.
• El webhook calla pero el panel muestra el código: lo más probable es que falle tu comprobación de firma; compara con el cuerpo sin procesar, no con JSON reserializado, y revisa la deriva del reloj.
• Varios fallos seguidos: añade un retroceso; repetir el pedido en un bucle apretado rara vez ayuda.

Líneas de largo plazo, facturación y sandbox para Túnez

No existe un número tunecino de largo plazo de autoservicio. Los Números Dedicados son un producto de EE. UU. y Canadá desde $1.95/month; si necesitas una línea +216 duradera, escribe a [email protected], teniendo en cuenta que la disponibilidad depende de la normativa local.

La billetera es de pago por uso sin cuota mensual, y cada recarga recibe una factura en PDF por correo. Las cuentas de desarrollo pueden solicitar el modo sandbox, en el que números y códigos simulados te permiten demostrar la integración sin gastar saldo.

Preguntas frecuentes

¿Puedo probar un flujo de registro tunecino sin una SIM tunecina?

Sí. Usa un número +216 del OTP Gateway y recoge el código en el panel o mediante la API de verificación por SMS y los webhooks.

¿Los números tunecinos tienen un prefijo troncal que quitar?

No. Los números tunecinos tienen ocho dígitos sin prefijo troncal, así que la forma E.164 es simplemente +216 más esos dígitos.

¿Cuál es el id de país de Túnez en la API OTP?

Usa tn en la consulta de precios y en el cuerpo de la solicitud POST /api/v1/activations.

¿Cuánto cuesta un número de verificación de Túnez?

Desde $0.20 por código; el importe exacto depende del servicio y aparece en el panel y en el endpoint de precios antes de pedir. Consulta los precios.

Mi analizador falla con los mensajes OTP en árabe. ¿Qué debo cambiar?

Elimina las marcas de dirección Unicode y busca la secuencia de dígitos en lugar de las palabras que la rodean, de modo que la misma regla funcione con cuerpos en árabe, francés e inglés.

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

No mediante autoservicio. Un número del Gateway cubre un único código, y las líneas de largo plazo disponibles al instante existen solo en EE. UU. y Canadá.

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.