OpenAB Gateway

Gateway Webhook independiente que conecta Telegram y LINE a cualquier instancia de OpenAB mediante WebSocket.

Requisitos previos

• Un servicio OpenAB en ejecución en el mismo proyecto de Zeabur
• Al menos uno de los siguientes:
  • Un token de bot de Telegram de @BotFather
  • Una cuenta oficial de LINE con Messaging API habilitada (LINE Channel Secret + Access Token)

Configuración

1. Crear Bot de Telegram

Abrir @BotFather, enviar /newbot y copiar el token en Token de Bot de Telegram.

2. Desplegar

Introducir el token y desplegar. Se asignará un dominio HTTPS automáticamente.

3. Registrar Webhook de Telegram

curl "https://api.telegram.org/botYOUR_TOKEN/setWebhook?url=https://YOUR_DOMAIN/webhook/telegram"

4. Configurar OAB

Editar /home/agent/.config/openab/config.toml en el servicio OpenAB:

[gateway]
url = "ws://openab-gateway:8080/ws"

Reiniciar el servicio OpenAB.

Configuración de LINE (Opcional)

1. Crear una cuenta oficial de LINE

1. Ir a LINE Official Account Manager y crear una cuenta
2. Configuración → Messaging API → Habilitar Messaging API
3. Abrir LINE Developers Console → tu canal:
   • Basic settings → Channel secret → copiar → pegar en LINE Channel Secret
   • Messaging API → Channel access token → Emitir → copiar → pegar en LINE Channel Access Token

2. Configurar URL de Webhook

En LINE Developers Console → pestaña Messaging API:

1. Webhook URL → Editar → introducir: https://YOUR_DOMAIN/webhook/line
2. Usar webhook → Activar
3. Mensajes de respuesta automática → Desactivar
4. Clic en Verificar

3. Configurar OAB para LINE

En config.toml, añadir platform = "line" en la sección gateway:

[gateway]
url = "ws://openab-gateway:8080/ws"
platform = "line"

Reiniciar el servicio OpenAB tras guardar.

Endpoints de Webhook

Ruta	Plataforma
POST /webhook/telegram	Telegram
POST /webhook/line	LINE
GET /ws	OAB WebSocket (interno)
GET /health	Health check

Enlaces

• OpenAB GitHub
• Guía de configuración de Telegram
• Guía de configuración de LINE
• Gateway README