Agora Conector ✨ Nuevo y recomendado

⭐ Método recomendado para conectar Agora con haddock

haddock Conector es un pequeño programa que se instala en el ordenador de tu restaurante y envía automáticamente las ventas de Agora a haddock. Una vez configurado, funciona solo y no tienes que hacer nada más.

📄 Descargar guía completa en PDF

¿Qué necesito antes de empezar?

• El ordenador donde tienes instalado Agora debe estar encendido y con Agora funcionando.
• Necesitas acceso a ese ordenador para instalar el programa. Si no estás físicamente en el local, puedes pedirle a alguien que esté allí que te dé acceso remoto con AnyDesk o TeamViewer — son programas gratuitos que permiten ver y controlar el ordenador desde otro lugar.
• Ten a mano el Token API de Agora: no viene de fábrica, es la clave que se define al activar el módulo de integración en la sección «Antes de instalar — preparar Agora» (normalmente lo hace tu distribuidor).
• Y el Código de autenticación de haddock (lo encontrarás en la webapp de haddock, en Configuración del restaurante > Mis integraciones > Agora Conector).

💡 Consejo: Si no tienes todos los datos o no te sientes seguro haciendo la instalación, lo más cómodo es enviárselo todo a tu distribuidor o informático de Agora. Compártele la guía en PDF y el Código de autenticación de haddock — ellos podrán hacer la instalación y configuración en remoto sin que tengas que hacer nada técnico.

Antes de instalar — preparar Agora

El conector lee las ventas a través de la API HTTP de integración de Agora. Antes de instalarlo hay que activar ese módulo y definir la clave que usará el conector (el Token API). Necesitas Agora 6.0.6 o superior y que tu licencia incluya el Módulo de Servicios de Integración — lo activa tu distribuidor.

✅ Si algo ya está configurado, no lo cambies: apunta el dato y pasa al punto siguiente. Los puntos B y C son solo de consulta, no modifican nada en Agora.

A — Activar el módulo y obtener el Token API

1. En el Monitor de Agora (el servidor, no el TPV), abre Herramientas > Activar Módulos Adicionales.

2. Marca la casilla Activar Módulo de Servicios de Integración, en la columna de la izquierda.

3. Haz clic en Configurar Servicios de Integración, justo debajo, habilita la API HTTP de integración e introduce una clave. Puede ser cualquier valor, pero usa una clave larga y única: con ella se accede a las ventas del TPV. Anótala, porque esa clave es el Token API del Paso 2.
4. Pulsa Aceptar para guardar.

El puerto de esa API es el 8984 por defecto, el mismo que trae el conector en Ajustes de conexión.

⚠️ Si la casilla no se puede marcar, tu licencia no incluye el módulo: pídele a tu distribuidor de Agora que lo active. Sin él, el conector fallará en la comprobación Licencia API activa.

¿Ya está hecho? Si la casilla ya está marcada y la API HTTP ya tiene una clave, copia esa clave tal cual (es tu Token API) y pasa al punto B. No la cambies: si otra integración la usa, la romperías.

B — Obtener el ID del Local (Workplace ID) — solo con ACMS

En el conector, este dato se escribe en el campo IDs Workplace.

Solo hace falta si tienes ACMS (Agora Central Management System), es decir, una instalación central que gestiona varios locales; sirve para que el conector traiga únicamente las ventas de este restaurante. Con un solo local, deja el campo «IDs Workplace» vacío — lo encontrarás en Vincula un restaurante durante la configuración inicial; si ya está vinculado, ve a Conexiones, selecciona el restaurante y pulsa Editar configuración — y pasa al punto C.

En la Administración web de Agora, ve a Administración > Locales: la columna Id es el valor que necesitas (en el ejemplo, «La Macarena» tiene el Id 1). Si un mismo restaurante de haddock recoge las ventas de varios locales, indícalos separados por comas: 1, 2.

C — Obtener el ID del TPV (Punto de Venta) — solo si separas TPVs

Solo hace falta si un mismo local tiene varios TPVs y quieres que cada uno vaya a un restaurante distinto de haddock (por ejemplo, una barra y una terraza facturadas por separado). En cualquier otro caso — lo más habitual — sáltate este punto: haddock recogerá las ventas de todos los TPVs del local.

En la Administración web de Agora, ve a Administración > Puntos de Venta: la columna Id de cada TPV es el valor que necesitas. La columna Local indica a qué local pertenece y Tipo si es un TPV, una comandera, una tablet, etc. Para varios, sepáralos por comas: 1006, 1009.

⚠️ No confundas los Puntos de Venta con los Grupos de Puntos de Venta: los grupos solo filtran informes dentro de Agora y no son válidos aquí.

💡 El conector solo filtra por local (Workplace ID), no tiene campo de ID de TPV. Si necesitas separar los TPVs de un mismo local, anota estos Ids y escríbenos al chat de soporte de haddock.

Paso 1 — Descarga e instalación

1. En el ordenador donde está Agora, descarga el instalador de haddock Conector desde bit.ly/haddockconector.
2. Abre el archivo descargado. Si Windows te pide permiso (pantalla de protección de Windows), haz clic en "Más información" y luego en "Ejecutar de todas formas".

3. Sigue los pasos del instalador:
4. • Pantalla de bienvenida:

• Selecciona la carpeta de destino:

• Asegúrate de que la opción "Crear un acceso directo en el escritorio" (Create a desktop shortcut) esté marcada.

• Revisa el resumen y haz clic en "Instalar".

4. Al terminar la instalación, asegúrate de marcar "Launch haddock Conector" y haz clic en "Finalizar". El programa se abrirá automáticamente.

Paso 2 — Configuración

Al abrir haddock Conector, completarás dos pantallas: primero conectarás Agora y después vincularás tu restaurante de haddock.

1. Conecta tu TPV

• En la pantalla ¿Qué TPV utilizas?, selecciona Agora.
• En Token de API, introduce la clave de la API HTTP de integración que obtuviste en el punto A de «Antes de instalar — preparar Agora».
• Si necesitas cambiar el puerto, despliega Ajustes de conexión. El valor por defecto es 8984.
• Pulsa Continuar.

2. Vincula un restaurante

• Nombre del restaurante (opcional): escribe un nombre para identificarlo en el Conector.
• Código de autenticación: entra en haddock y ve a Configuración del restaurante > Mis integraciones > Agora Conector. Copia el código de 10 caracteres que verás allí y pégalo aquí.
• IDs Workplace: introduce el ID del local de Agora indicado en el punto B. Si tienes un solo local, déjalo vacío. Para incluir varios locales en este restaurante, separa sus Ids por comas: 1, 2.

3. Preferencias de importación y sincronización

Puedes mantener los valores predeterminados o desplegar esta sección para cambiarlos:

• Historial de ventas a importar: por defecto, Últimos 180 días. También puedes seleccionar Último año o Elegir fechas.
• Intervalo de sincronización: por defecto, 30 minutos.

Paso 3 — Conectar

Pulsa Conectar restaurante. El Conector comprobará la conexión con Agora, el Token de API, la licencia de integración y la conexión con haddock. También revisará el código de autenticación y los IDs Workplace, si los has indicado.

Si todo es correcto, se guardará la configuración y accederás a la pantalla Conexiones, donde podrás seguir la sincronización de las ventas.

Si hay algún problema, el Conector señalará el campo que debes corregir o mostrará un mensaje con el motivo. Revisa la sección Errores y soluciones de esta guía.

¿Cómo sé que está funcionando?

En la pantalla Conexiones verás los restaurantes vinculados, su estado y la última sincronización de cada uno.

Durante la primera importación aparecerá el mensaje «Importando el historial de ventas», junto con su progreso. Puede tardar si hay mucho historial.

Cuando la sincronización termine correctamente, el restaurante aparecerá «Al día» y se actualizará la hora de su última sincronización.

Uso del día a día

• El programa funciona en segundo plano — no necesitas tenerlo abierto. Al cerrar la ventana, se minimiza al área de notificaciones (abajo a la derecha del escritorio de Windows) y sigue trabajando.
• Para abrirlo de nuevo, haz clic en el icono del área de notificaciones.
• Se actualiza y se reinicia solo si hay algún problema — no tienes que preocuparte de nada.

🔧 Errores y soluciones

Si hay un problema al conectar, el Conector señalará el campo que debes corregir o mostrará un mensaje con el motivo. Búscalo aquí para ver qué hacer:

🚨 "API no accesible en localhost:8984. Asegúrate de que Agora está funcionando en esta máquina."

✅ Agora no está abierto, está en otro ordenador, el puerto no es correcto, o un firewall/antivirus bloquea el puerto. Comprueba que:

• Agora está abierto y funcionando en este mismo ordenador.
• El puerto en Ajustes de conexión es 8984 (el valor por defecto).
• Si al abrir http://localhost:8984 en el navegador de este equipo no carga nada, la API de Agora no está escuchando ahí: contacta con tu distribuidor de Agora.

🚨 "El servidor Agora es accesible pero el Token API fue rechazado."

✅ El Token API es incorrecto o no está activo. Pide a tu distribuidor de Agora el token correcto y que confirme que está activo.

🚨 "El módulo de servicios de integración no está activado en Agora (501)."

✅ El token es válido, pero el módulo no está activado en esta instalación. Revisa el punto A de la sección «Antes de instalar — preparar Agora»: la casilla Activar Módulo de Servicios de Integración debe estar marcada y la API HTTP de integración habilitada. Si no se puede marcar, tu licencia no incluye el módulo: contacta con tu distribuidor.

🚨 "No se puede conectar con la nube de haddock."

✅ El equipo no tiene salida a internet, o un firewall/proxy/antivirus bloquea la conexión segura (HTTPS) con haddock. Revisa la conexión a internet del equipo y que el firewall o antivirus permita el tráfico HTTPS saliente hacia haddock. Si el mensaje dice que la nube «es accesible pero rechazó la solicitud», es un fallo temporal: reinténtalo en unos minutos.

🚨 "El código de autenticación no es válido" / "Formato de código de autenticación inválido."

✅ El código está mal copiado o ha caducado. Ve a la webapp de haddock (Configuración del restaurante > Mis integraciones > Agora Conector), genera uno nuevo y pégalo completo. Los códigos caducan si no se usan.

🚨 No tengo el Token API de Agora

✅ Es la clave de la API HTTP de integración de Agora: la encuentras (o la creas) en Herramientas > Activar Módulos Adicionales > Configurar Servicios de Integración — pasos en la sección «Antes de instalar — preparar Agora». Si no tienes acceso al Monitor de Agora, pídesela a tu distribuidor.

🚨 La sincronización termina, pero no veo ventas

✅ Comprueba que estás consultando el restaurante y las fechas correctas en haddock, que hay ventas en Agora para ese periodo y que esas fechas están incluidas en el historial que has importado.

Revisa también el campo IDs Workplace: indica de qué local de Agora se reciben las ventas. Para consultarlo, ve a Conexiones, selecciona el restaurante y pulsa Editar configuración.

• Si tienes un solo local: deja el campo IDs Workplace vacío para recibir las ventas de todos sus puntos de venta.
• Si tienes varios locales con ACMS: comprueba que los IDs corresponden al local que quieres vincular. Los encontrarás en Administración > Locales, columna Id (punto B de «Antes de instalar — preparar Agora»).

El Conector rechaza valores no numéricos como WP1 o test y, cuando puede consultar los locales de Agora, también los IDs inexistentes o inactivos. Sin embargo, un ID válido puede pertenecer a otro local: que la validación sea correcta no garantiza que hayas elegido el restaurante adecuado. Si no puede comprobar los locales, mostrará un aviso.

Tras corregir los datos, pulsa Guardar configuración. Cuando no haya una importación del historial ni una sincronización en curso, puedes pulsar Sincronizar ahora en Conexiones. En la configuración inicial, el botón para vincular el restaurante es Conectar restaurante.

El conector estaba funcionando y ahora falla

• No veo las ventas justo después de conectar: la primera importación puede tardar si hay mucho historial. Consulta su progreso en Conexiones y espera a que termine. Durante la importación no aparece el botón Sincronizar ahora.
• Si ves el aviso «La sincronización se ha retrasado», el Conector volverá a intentarlo automáticamente. Pulsa Ver detalles para consultar el problema y revisa la sección Errores y soluciones de esta guía.
• El conector también muestra avisos en el área de notificaciones de Windows (abajo a la derecha) cuando lleva un rato sin poder conectar con el TPV o con haddock.
• Comprueba que el ordenador del TPV está encendido y que Agora sigue funcionando.

¿Sigue sin funcionar tras revisar esto? Consulta Cómo solucionar los problemas de conexión con mi TPV o contacta con el chat de soporte de haddock.

Las integraciones pueden incluir costes adicionales no soportados por haddock.

Actualizado el: 19/10/2026