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 (te lo proporciona tu distribuidor de Agora) 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.

Paso 1 — Descarga e instalación

1. En el ordenador donde está Agora, descarga el instalador de haddock Conector.
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: Una clave que te da Agora para identificarte. Pídesela a tu distribuidor de Agora (ej. a1b2c3d4e5f6...).
• 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 de integración de Agora no está activado en esta instalación. Contacta con tu distribuidor de Agora para que lo active.

🚨 "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

✅ Pídeselo a tu distribuidor de Agora. Es un dato que ellos gestionan y te lo deben proporcionar al activar la integración.

🚨 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 número de Workplace ID exacto de tu local (te lo da tu distribuidor de Agora o lo ves en la configuración de ACMS). 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: 17/07/2026