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 avanzados.

⚠️ 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

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 Workplace ID vacío en Ajustes avanzados del conector 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

Cuando el programa se abra, verás una pantalla con varios campos para rellenar:

1. POS System (Sistema TPV):
Selecciona Agora en el menú desplegable.

2. Datos de conexión de Agora:

• API Token: la clave de la API HTTP de integración que definiste en el punto A de la sección anterior.
• Advanced settings (Ajustes avanzados): Al desplegar esta opción podrás configurar el puerto (por defecto 8984) y el Workplace ID (solo necesario si tienes varios locales con ACMS).

3. haddock Authentication (Autenticación de haddock):

• Authentication Code: Entra en la webapp de haddock, ve a Configuración del restaurante > Mis integraciones > Agora Conector y copia el código de 10 dígitos que aparece allí. Pégalo en este campo.

4. Sync Settings & Dates (Sincronización):

• Sync interval: Cada cuántos minutos se enviarán las ventas a haddock. Puedes dejar el valor por defecto (30 minutos).
• Sync Dates (Start / End): El periodo de tiempo del cual quieres importar el historial de ventas. Por defecto recuperará el historial del último año.

Paso 3 — Conectar

Haz clic en el botón azul "Connect". El programa hará una serie de comprobaciones y las irá mostrando como una lista de puntos que pasan a verde uno a uno:

1. POS accesible — el conector encuentra Agora en este ordenador.
2. Credenciales POS válidas — Agora acepta el Token API.
3. Licencia API activa — el módulo de integración de Agora está activado.
4. Nube de haddock — hay conexión con los servidores de haddock.
5. Código de haddock válido — tu código de autenticación es correcto.

Cuando todos están en verde, la conexión está lista y las ventas empezarán a sincronizarse. Si un punto aparece en rojo, ese es el origen del problema: busca el mensaje que muestra el conector en la sección Errores y soluciones de abajo.

¿Cómo sé que está funcionando?

Una vez conectado, verás el panel de estado con información en tiempo real: cuándo fue la última sincronización de ventas, cuántas sincronizaciones se han hecho y un registro de actividad reciente. Si quieres sincronizar en ese momento sin esperar, pulsa el botón "Sync Now".

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 una comprobación aparece en rojo al conectar, el conector muestra un mensaje. Búscalo aquí para ver qué hacer:

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

(Comprobación 1 — POS accesible)

✅ 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 avanzados 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."

(Comprobación 2 — Credenciales)

✅ 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)."

(Comprobación 3 — Licencia API)

✅ 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."

(Comprobación 4 — 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."

(Comprobación 5 — Código de haddock)

✅ 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.

🚨 Todo aparece en verde y conectado, pero no llegan ventas a haddock

(Las 5 comprobaciones pasan en verde, pero el Workplace ID es incorrecto)

✅ Cuando la conexión figura como conectada y las sincronizaciones se ejecutan, pero en haddock no aparece ninguna venta, casi siempre es por un Workplace ID mal configurado en Ajustes avanzados.

El Workplace ID le indica a Agora de qué local quieres recibir las ventas, y el conector envía a Agora tal cual lo que haya en ese campo. Como el token, el módulo y la conexión son correctos, las cinco comprobaciones salen en verde y el conector parece funcionar — pero si ese campo tiene cualquier cosa que no sea el ID numérico exacto de tu local (un número equivocado, o texto sobrante como WP1 o test), Agora no devuelve ninguna venta y a haddock no llega nada.

• Si tienes un solo local: deja el campo Workplace ID vacío. Así el conector recibe las ventas de todos los puntos de venta. Si quedó cualquier valor ahí por error, bórralo.
• Si tienes varios locales con ACMS: introduce el Workplace ID exacto de tu local — lo tienes en Administración > Locales, columna Id (punto B de la sección «Antes de instalar — preparar Agora»). Un número equivocado hará que no llegue ninguna venta, aunque la conexión esté en verde.

Tras corregirlo, pulsa "Connect" de nuevo y luego "Sync Now" para forzar la sincronización.

El conector estaba funcionando y ahora falla

• No veo las ventas justo después de conectar: la primera sincronización puede tardar si hay mucho historial. Pulsa "Sync Now" en el panel de estado para forzarla.
• Si ves el aviso "La sincronización falla — revisa tu configuración" con un botón Reconfigurar, púlsalo y revisa con la lista de arriba qué comprobación está en rojo.
• 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: 14/08/2026