# LINE Conecta tu propia **LINE Official Account** para que tus conversaciones de LINE fluyan hacia la aplicación y un Agente de IA pueda responder. Te conectas pegando tus credenciales de la API de mensajería de LINE (Channel secret + access token) y configurando una URL de webhook; no se requiere programación. --- ## ¿Qué es la integración con LINE? La integración de LINE vincula una **LINE Official Account (OA)** de tu propiedad a la plataforma utilizando la API de mensajería oficial de LINE, el propio sistema de LINE para enviar y recibir mensajes automáticamente, en lugar de escribirlos a mano en la aplicación LINE. Tus chats 1 a 1 con personas que han añadido tu OA como amigo estarán disponibles dentro de la aplicación, y un Agente de IA, las difusiones y una bandeja de entrada compartida funcionarán sobre ellos. A diferencia de Telegram o WhatsApp Web, esta es una integración **oficial**: utiliza la propia API de mensajería de LINE, por lo que es estable y cumple con las normas de LINE. Dado que LINE no tiene un botón de "conectar" con un solo clic para herramientas de terceros, pegarás las credenciales de tu OA una vez durante la configuración. > **Disponibilidad.** Las cuentas oficiales de LINE son más comunes en Japón, Taiwán, Tailandia e Indonesia, y **no están disponibles en la UE**. Necesitas una cuenta oficial de LINE registrada en una región compatible para usar este canal. --- ## Antes de empezar Crearás (o utilizarás) tres elementos en las propias consolas de LINE. Esta es una configuración única de unos 5 minutos. 1. Una **LINE Official Account** (creada en el [LINE Official Account Manager](https://manager.line.biz)). Si aún no tienes una, inicia sesión con tu LINE Business ID y **crea una cuenta nueva**: asígnale un nombre y completa el breve formulario. 2. Un **canal de Messaging API** para esa OA. La forma más sencilla es habilitarlo desde el interior del OA Manager (consulta el Paso 1 a continuación); no es necesario crear el canal manualmente en la consola de desarrolladores primero. Cuando se te solicite, elige un **proveedor** existente o crea uno nuevo. 3. De ese canal, tres valores que pegarás en la aplicación: - **Channel ID** (pestaña Basic settings) — opcional, solo informativo - **Channel secret** (pestaña Basic settings) - **Channel access token** — un token de larga duración que emites en la pestaña **Messaging API** No se requieren documentos comerciales para una cuenta oficial estándar (no verificada), solo un LINE Business ID. La verificación (la insignia azul) es opcional y solo se ofrece en algunas regiones. --- ## Configuración de LINE ### Paso 1: Habilitar la Messaging API para tu cuenta oficial 1. Inicia sesión en el [LINE Official Account Manager](https://manager.line.biz) (o crea primero una Official Account nueva). 2. Abre tu OA. 3. Haz clic en **Settings** (esquina superior derecha). 4. En el menú de configuración, haz clic en **Messaging API**. 5. El estado comienza como **Disabled** (deshabilitado); haz clic para habilitarlo. 6. Elige el **proveedor** para este canal (la empresa/desarrollador que lo posee). Si aún no tienes uno, **crea un proveedor nuevo** y luego confirma. ### Paso 2: Obtener tus credenciales de la consola de desarrolladores Habilitar la Messaging API crea un canal bajo tu proveedor en la [LINE Developers Console](https://developers.line.biz/console/). 1. Abre la **cuenta de desarrollador / proveedor**. 2. Haz clic en el **canal de Messaging API**. 3. Abre la pestaña **Basic settings** y copia tu **Channel ID** y **Channel secret**. 4. Abre la pestaña **Messaging API**, emite (o vuelve a generar) un **Channel access token** de larga duración y cópialo. > Ten estos valores a mano; los pegarás en la aplicación a continuación. ### Paso 3: Conectar LINE en la aplicación 1. En la barra lateral izquierda, haz clic en **Settings** (Configuración) cerca de la parte inferior. 2. En el panel izquierdo de Settings, bajo **Channels** (Canales), haz clic en **Channels**. 3. Busca la tarjeta **LINE** y haz clic en **Connect** (Conectar). 4. Opcionalmente, pega tu **Channel ID** (ID de canal); es solo informativo. 5. Pega tu **Channel secret** (Secreto de canal). 6. Pega tu **Channel access token** (Token de acceso de canal). 7. Haz clic en **Connect**. 8. La aplicación valida las credenciales con LINE y muestra **"Connected to: \"**. Si las credenciales son incorrectas, recibirás un error; vuelve a emitir el token de acceso en la consola de desarrolladores de LINE (LINE Developers Console) e inténtalo de nuevo. ### Paso 4: Configurar la URL del Webhook en LINE Después de conectarte, la aplicación muestra una sección **Finish setup in LINE** con una **webhook URL**; cópiala. (Una URL de webhook es simplemente una dirección web; pegarla en LINE le indica a LINE dónde enviar automáticamente los mensajes nuevos). Luego, en la **LINE Developers Console** para tu canal de Messaging API: 1. Abre la pestaña **Messaging API**. 2. Pega la URL en **Webhook URL**. 3. Haz clic en **Update**. 4. Activa **Use webhook** (**ON**). ### Paso 5: Corregir la configuración del Official Account Manager (Importante) De forma predeterminada, una LINE OA gestiona los chats y las *respuestas automáticas* por sí misma, lo que impide que los mensajes lleguen a la IA. De vuelta en el [LINE Official Account Manager](https://manager.line.biz), abre la configuración de tu OA y establece: | Configuración | Valor requerido | Por qué | |---|---|---| | **Chat** | **On** | Activa el chat para que la conversación fluya (te permite usar el filtro de chat). | | **Response mode** | **Bot** | Permite que la API (tu Agente de IA) gestione los mensajes. El modo "Chat" solamente los bloquea. | | **Response hours / Auto-response messages** | **Off** | Desactiva las respuestas automáticas de LINE para que la IA gestione las respuestas (la causa número 1 de las "respuestas dobles"). | | **Greeting messages** | **Off** | Evita que el saludo automático de LINE compita con la IA. | | **Webhooks** | **On** | Para que LINE reenvíe los mensajes a la aplicación. | > Si la aplicación advierte que tu cuenta está en **Chat mode**, cámbiala a **Bot mode** aquí; el bot no podrá recibir ni enviar mensajes hasta que lo hagas. ### Paso 6: Probar el bot 1. Desde un teléfono diferente (por ejemplo, tu propia aplicación LINE), añade tu Official Account como amigo y **envíale un mensaje**. 2. Abre la aplicación y ve a **Chats**; el mensaje entrante aparecerá en la lista de conversaciones. 3. Si un Agente de IA está gestionando este canal, verás que **responde automáticamente** al mensaje de prueba. Una vez conectado con el webhook configurado y los interruptores anteriores correctos, tu cuenta de LINE aparecerá como **Connected** en la página de Channels y la IA responderá a los mensajes entrantes. --- ## Coste LINE es un canal **gratuito** en la aplicación; no hay cargo por mensaje ni tarifa de conexión mensual por nuestra parte. Ten en cuenta que los **planes propios de LINE** tienen sus propios límites mensuales en mensajes *push* (envíos proactivos), que varían según la región y el tipo de cuenta. Las respuestas enviadas poco después de que un cliente te escriba son gratuitas en LINE; los envíos proactivos/difusiones cuentan contra la cuota de tu plan de LINE. --- ## Mensajes multimedia Las fotos, vídeos, notas de voz, archivos, stickers y ubicaciones entrantes se reconocen para que la IA sepa que se ha enviado contenido multimedia (se añade una nota breve a la conversación). Las respuestas salientes de la IA son **texto e imágenes** en esta versión. Las respuestas largas se recortan automáticamente al límite de 5000 caracteres de LINE. --- ## Gestión de sesiones ### Comprobación del estado de la conexión El estado de su conexión de LINE se muestra en la tarjeta **LINE** en la página **Canales**: | Estado | Significado | |---|---| | **Conectado** | Una cuenta oficial de LINE está vinculada a esta cuenta | | **No conectado** | No hay ninguna conexión configurada | La tarjeta también vuelve a comprobar el ajuste del **modo de chat** de su cuenta cada vez que abre la página de Canales. Si su cuenta de LINE ha vuelto al modo de chat (lo que impide que el bot reciba o envíe mensajes), aparecerá una advertencia de color ámbar en la tarjeta indicándole que debe volver a cambiarlo al **modo de bot** en el LINE Official Account Manager; vuelva a comprobar los conmutadores del Paso 5 allí y la advertencia desaparecerá en la siguiente visita. ### Desconexión Abre la tarjeta de **LINE** y haz clic en **Gestionar**, luego haz clic en **Desconectar** en el panel que se abre y confirma **¿Eliminar LINE?**. Esto elimina la conexión de nuestro lado. Para evitar por completo que LINE envíe eventos, desactiva también **Usar webhook** (o elimina la URL del webhook) en la consola de desarrolladores de LINE. --- ## Limitaciones - **Una cuenta oficial por conexión.** Conecta cada OA por separado; una OA solo puede estar vinculada a una cuenta. - **Envío de texto + imagen.** El bot de IA responde con texto e imágenes; los mensajes enriquecidos "Flex", plantillas o carruseles no se envían en esta versión. - **Región.** Las cuentas oficiales de LINE no están disponibles en la UE; necesitas una OA en una región compatible (por ejemplo, Japón, Taiwán, Tailandia, Indonesia). - **Tiempo de respuesta.** Las respuestas instantáneas gratuitas de LINE tienen un breve margen de tiempo; los mensajes enviados más tarde se entregan automáticamente como mensajes push (que cuentan para la cuota). --- ## Solución de problemas ### Credenciales rechazadas al conectar - Asegúrese de haber creado un canal de **Messaging API** (no "LINE Login"). - Vuelva a emitir un **token de acceso de canal de larga duración** en la pestaña Messaging API y pegue el nuevo valor. - Confirme que copió el **Channel secret** de la pestaña de configuración básica (no el Channel ID). ### El bot no responde - Confirme que **Webhooks** esté **activado** tanto en la consola de desarrolladores como en el OA Manager. - Confirme que la **Webhook URL** coincida con la que se muestra en la aplicación. - Confirme que el **Modo de respuesta** sea **Bot** (no Chat) en el OA Manager. ### El cliente recibe dos respuestas - Desactive los **mensajes de respuesta automática** y los **mensajes de saludo** en el OA Manager; las respuestas automáticas integradas de LINE se están enviando junto con la IA. ### Los mensajes no llegan a la aplicación - Verifique que el contacto haya **agregado su cuenta oficial como amigo** (LINE solo entrega mensajes de amigos). - Vuelva a comprobar la URL del webhook y que **Use webhook** esté activado. --- ## Mejores prácticas - **Complete los ajustes del OA Manager** (modo Bot, Webhooks activados, saludo + respuesta automática desactivados): la mayoría de los problemas de configuración provienen de estos. - **Responda con prontitud** para mantener las respuestas dentro de la ventana gratuita de LINE y conservar su cuota de envío. - **Mantenga su token de acceso seguro**: cualquier persona que lo tenga puede enviar mensajes como su cuenta oficial. Vuelva a emitirlo en la consola de desarrolladores si se filtra.