Recibir códigos SMS de LINE en números de OTP Route: lista de comprobación y pasos

¿Para qué usa LINE un número de teléfono?

LINE vincula una cuenta a un número de teléfono. Un registro nuevo se confirma con un código por SMS, y la aplicación puede volver a pedir el número cuando la cuenta se traslada a un dispositivo nuevo o cuando alguien inicia sesión tras reinstalarla. El número también interviene en la recuperación del acceso, así que importa con qué número se creó una cuenta.

Ese último punto condiciona la elección del producto: un número de un solo uso sirve para un único paso de verificación, mientras que una cuenta que deba volver a iniciar sesión meses después necesita un número que sigas controlando.

Lista de comprobación previa antes de pedir un número de LINE

• Una clave de API de la consola de desarrolladores (prefijo or_live_); hasta 10 claves por cuenta.
• Saldo suficiente en el monedero, confirmado con GET /api/v1/balance.
• Un país elegido según el mercado de la cuenta o del caso de prueba.
• Una consulta de precio en tiempo real para ese par, porque los precios varían según el país.
• Un endpoint de webhook registrado y su comprobación de firma probada, o un bucle de consulta periódica preparado.
• Una decisión sobre si esta cuenta debe volver a iniciar sesión más adelante; si es así, lee antes la sección sobre Números Dedicados.
• Una relectura rápida de las condiciones de LINE para el tipo de cuenta que vas a crear.

¿Qué países puedo elegir para LINE y por qué importa?

El servicio de LINE está disponible en 197 países. La aplicación tiene sus bases de usuarios más fuertes en partes de Asia Oriental y del Sudeste Asiático, así que los equipos que lanzan allí suelen empezar por Japón, Tailandia, Taiwán, Indonesia, Hong Kong o Malasia. Otras opciones son Singapur, Filipinas, Vietnam, Corea del Sur, Australia, Estados Unidos, Reino Unido, Alemania, Brasil y Rumanía.

Elige el país de donde proceden tus usuarios reales. Una versión para el mercado tailandés debe verificarse con un número tailandés para que el prefijo del país, el formato telefónico y las pantallas de incorporación regionales se comporten como lo harán en producción. Cubrir varios mercados cuesta poco esfuerzo extra, porque entre ejecuciones solo cambia el valor de country.

Paso a paso: el flujo de la API de códigos de verificación de LINE

1. Llama a GET /api/v1/prices?country=<id>&service=linemessenger y confirma que la ruta está disponible.
2. Crea la activación con POST /api/v1/activations y un cuerpo como {"service": "linemessenger", "country": "th"}.
3. Introduce el número devuelto en la pantalla de verificación telefónica de LINE.
4. Espera activation.sms_received, o consulta GET /api/v1/activations/{id} cada pocos segundos dentro del límite de 300 solicitudes por minuto.
5. Si la ejecución se abandona, llama a POST /api/v1/activations/{id}/cancel.

Los detalles de los endpoints están en la documentación para desarrolladores.

¿Cómo debe tratar el manejador del webhook los eventos de LINE?

Lee la cabecera X-OTPRoute-Signature, con formato t=<unix>,v1=<hex>, calcula HMAC-SHA256 sobre <t>.<raw body> con el secreto del endpoint, compara en tiempo constante y descarta todo lo que tenga una marca de tiempo antigua. Después usa el id de activación como clave de tu procesamiento, de modo que una entrega reintentada actualice el mismo registro en lugar de lanzar dos veces el paso de tu prueba. Trata activation.expired y activation.cancelled como resultados normales en la misma tabla. La guía de HMAC ofrece una explicación completa.

Pedir un número de LINE desde el panel

Inicia sesión, abre OTP Gateway, elige LINE y un país, revisa el precio que se muestra y haz el pedido. Escribe el número en LINE y deja abierta la tarjeta de la activación; el código aparece allí en cuanto se recibe. Los responsables de producto y los agentes de soporte suelen usar esta vista para comprobar a mano una pantalla de incorporación de LINE localizada antes de que tome el relevo la batería de pruebas automática. Se aplican la misma ventana de 20 minutos y la misma regla de reembolso.

Solución de problemas: por qué puede no llegar un código de LINE

LINE puede rechazar algunos números virtuales, y una ruta que funcionaba antes puede no estar disponible más tarde durante el día. Si no llega ningún SMS, la activación se reembolsa por completo cuando se cierra la ventana o cuando cancelas. Después:

• prueba otro país que siga encajando con el caso de prueba;
• reintenta más tarde en lugar de volver a pedir en un bucle rápido;
• confirma que el número se introdujo con el prefijo de país correcto.

¿Cuándo encaja mejor un Número Dedicado para LINE?

Si una cuenta de staging o un acceso de equipo compartido debe seguir iniciando sesión, un número de un solo uso no es la herramienta adecuada. Los Números Dedicados de Estados Unidos y Canadá parten de $1.95/mes, reciben SMS entrantes en el panel y en tu webhook mediante number.sms_received, y se renuevan desde el monedero hasta que los liberes. Los detalles están en la página de números virtuales.

Usa OTP Route solo para tus propios productos y cuentas legítimos: una cuenta por persona o empresa real, respetando las condiciones de LINE y siguiendo la Política de Uso Aceptable.

Preguntas frecuentes

¿Qué id de servicio usa OTP Route para LINE?

El id es linemessenger. Úsalo en la consulta de precios y en el campo service al crear una activación.

¿Puedo hacer la verificación SMS de LINE para pruebas sin una SIM física?

Sí. Un número de OTP Gateway recibe el código de LINE, que lees a través de la API, un webhook o el panel.

¿Qué país debo elegir para un número virtual de LINE?

Elige el mercado al que pertenecen tus usuarios o tu caso de prueba, por ejemplo Japón o Tailandia para un lanzamiento allí.

¿LINE aceptará todos los números de OTP Route?

No siempre. LINE puede rechazar algunos números virtuales, y cuando no llega ningún código se te reembolsa automáticamente.

¿Cuánto cuesta recibir un OTP de LINE?

Desde $0.20 por código, según el país; el precio actual lo devuelve GET /api/v1/prices.

¿Puedo conservar el mismo número de LINE para inicios de sesión posteriores?

Solo con un Número Dedicado, disponible en EE. UU. y Canadá. Los números de un solo uso sirven para un único código.

¿Necesito un webhook para recibir los códigos OTP de LINE o basta con consultar periódicamente?

Consultar GET /api/v1/activations/{id} funciona bien para ejecuciones pequeñas. Los webhooks escalan mejor cuando se ejecutan muchas activaciones en paralelo.

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.