Pruebas de verificación telefónica en Tailandia (+66): lista de comprobación, pasos y soluciones

Antes de empezar: una lista de comprobación para pruebas con +66

Los flujos de registro tailandeses tienen algunas trampas que sale más barato detectar sobre el papel que en una ejecución de CI fallida. Confirma primero cada punto:

• Credenciales. Una clave Bearer con el prefijo or_live_ de la consola de desarrolladores, limitada al entorno que la vaya a usar.
• Identificadores. El id de país de Tailandia es th; toma el id del servicio de GET /api/v1/services en lugar de adivinarlo.
• Forma de entrega. O bien un endpoint de webhook con su secreto de firma guardado, o bien un trabajo de polling que respete el límite de 300 solicitudes por minuto.
• Manejo de números. Decide cómo tu código quita el 0 nacional antes de guardar nada (consulta la sección de formato).
• Análisis del mensaje. Asegúrate de que el analizador tolera la escritura tailandesa alrededor de los dígitos.
• Presupuesto. Un monedero recargado, o una cuenta sandbox si solo necesitas demostrar la integración.

¿Qué flujos de registro tailandeses puede cubrir el OTP Gateway?

Tailandia es una de las rutas más amplias, con más de 1,800 servicios en la instantánea en vivo. La mensajería y el comercio dominan el uso local, así que los equipos suelen empezar con LINE, Shopee, Lazada, TikTok, WhatsApp, Facebook, Instagram y Telegram. Otros de la lista son Google (Gmail y YouTube), Microsoft y Outlook, ChatGPT (OpenAI), Discord, Viber, Netflix, Amazon y Airbnb.

La disponibilidad por servicio cambia a medida que entran y salen números, así que lee el endpoint de precios antes de cada ejecución en lugar de fijar suposiciones en el código.

Cómo pedir un número de verificación de Tailandia mediante la API

La URL base es https://otproute.com/api/v1.

1. Solicita GET /api/v1/prices?country=th&service=<id>; una respuesta vacía o no disponible significa que conviene elegir otro momento u otra ruta.
2. Envía POST /api/v1/activations con un cuerpo como {"service": "line", "country": "th"}. Guarda el id de activación devuelto junto con tu ejecución de prueba.
3. Escribe el número +66 en la app que estás probando y dispara el SMS.
4. Recoge el código del evento activation.sms_received, o de GET /api/v1/activations/{id} si haces polling.
5. Libera los pedidos que no necesites con POST /api/v1/activations/{id}/cancel.

Verifica la cabecera X-OTPRoute-Signature (t=<unix>,v1=<hex>) en cada entrega y descarta los eventos cuya marca de tiempo sea demasiado antigua. Los eventos se identifican por el id de activación, lo que facilita ignorar las entregas duplicadas. Los ejemplos completos de solicitudes están en la documentación para desarrolladores.

Formatos de número tailandeses, el cero troncal y mensajes en escritura tailandesa

A nivel nacional, los móviles tailandeses se escriben con un 0 inicial y nueve dígitos más, normalmente empezando por 06, 08 o 09. Ese 0 es un prefijo troncal: en formato internacional desaparece, de modo que 08x xxx xxxx pasa a ser +66 8x xxx xxxx. Guarda la versión E.164 y normaliza cualquier entrada de usuario que aún lleve el cero, o tu deduplicación tratará un mismo teléfono como dos personas.

Los códigos de apps orientadas a Tailandia suelen llegar dentro de una frase en tailandés. Extrae el código por patrón (una serie de dígitos de la longitud esperada) en lugar de anclarte a palabras en inglés, y recuerda que los SMS en escritura tailandesa usan codificación Unicode, por lo que los mensajes se dividen en segmentos más cortos. La QA de localización es el otro motivo por el que los equipos prueban aquí: los campos de fecha en interfaces tailandesas suelen mostrar el año de la Era Budista, y los límites de longitud de los campos para nombres y direcciones tailandeses son fáciles de calibrar mal. Los lanzamientos de producto en el Sudeste Asiático, el alta de vendedores en marketplaces y los equipos de soporte que hablan tailandés completan la lista habitual.

¿Cómo usan el panel, en cambio, el personal de soporte y de operaciones?

No toda comprobación necesita un script. Alguien del equipo de operaciones puede registrarse, añadir fondos, abrir el OTP Gateway, elegir un servicio y Tailandia, revisar el precio cotizado y recibir el número. El código aparece en la tarjeta de activación en el navegador. Se aplica la misma ventana de 20 minutos, y el reembolso se hace solo si la ventana se cierra vacía.

Solución de problemas: códigos que nunca llegan al número +66

Cuando una activación sigue vacía, repasa esta lista:

• Dale la ventana completa antes de cancelar; los reenvíos retrasados son habituales.
• Confirma que el servicio acepta números virtuales para Tailandia. Algunos no lo hacen, y eso es lo que cubre el reembolso automático.
• Inténtalo de nuevo más tarde, o cambia a la ruta de otro país si tu caso de prueba lo permite. El artículo sobre enrutamiento por país explica cómo eligen los equipos las rutas alternativas.
• Espacia los reintentos. Volver a pedir en un bucle rápido rara vez ayuda y llena tus registros de ruido.

No se pierde dinero en un intento fallido: una activación caducada o cancelada devuelve el importe completo al monedero.

Líneas de larga duración, monedero y sandbox para proyectos en Tailandia

OTP Route no vende un número de larga duración en autoservicio en Tailandia. Los equipos que necesiten una línea tailandesa persistente pueden escribir a [email protected] para consultarlo; la normativa local decide si es posible. Los números dedicados que conservas y renuevas solo están disponibles en EE. UU. y Canadá, desde $1.95/mes.

Todo lo demás funciona con un monedero prepago en USD, sin suscripción. Recarga con tarjeta o con USDT/USDC, y se envía por correo una factura en PDF por cada recarga. Para el trabajo de integración, una cuenta de desarrollo puede pasarse a sandbox para que números y códigos simulados circulen por tu código sin coste. Consulta los precios para ver las tarifas actuales, respeta las condiciones de cada servicio y recuerda que la Política de Uso Aceptable de OTP Route cubre cada activación.

Preguntas frecuentes

¿Puedo verificar el registro tailandés de mi app sin una SIM de Tailandia?

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

¿Debo conservar el 0 inicial al guardar un móvil tailandés?

No. Quita el 0 troncal y guarda el número como +66 seguido de los nueve dígitos restantes.

¿Qué id espera la API para Tailandia?

Usa th como valor de país, por ejemplo en GET /api/v1/prices?country=th&service=<id>.

¿Por qué el mensaje de LINE o Shopee llega en tailandés?

Muchos servicios localizan su plantilla de SMS según el país del número o el idioma de la cuenta, así que analiza dígitos en lugar de palabras clave en inglés.

¿Cuánto cuesta una activación fallida en Tailandia?

Nada. Si la ventana de 20 minutos termina sin ningún SMS, o cancelas, el importe completo vuelve a tu monedero automáticamente.

¿Hay una forma de ejecutar pruebas OTP tailandesas en CI sin gastar dinero?

Sí, solicita el modo sandbox para una cuenta de desarrollo. Devuelve números y códigos simulados para que el pipeline pueda probarse de extremo a extremo, como se explica en la página de la solución de CI/CD.

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.