> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://support.haddock.app/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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](https://storage.googleapis.com/haddock-connector/haddock-connector-latest-install-guide-agora.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](https://storage.googleapis.com/haddock-connector/haddock-connector-latest-install-guide-agora.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**. ![Ventana Activar Módulos Adicionales de Agora](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/pos-setup-01-agora-activate-additional-modules-window.png) 2. Marca la casilla **Activar Módulo de Servicios de Integración**, en la columna de la izquierda. ![Detalle de la casilla Activar Módulo de Servicios de Integración](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/pos-setup-02-agora-integration-services-module-checkbox.png) 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`. ![Listado de Locales en la administración de Agora con la columna Id](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/pos-setup-03-agora-admin-locales-id-column.png) ### 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`. ![Listado de Puntos de Venta en la administración de Agora con la columna Id](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/pos-setup-04-agora-admin-points-of-sale-id-column.png) > ⚠️ **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](https://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"**. ![Advertencia de Windows Defender](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/01-windows-defender-smartscreen-warning.png) ![Ejecutar de todas formas](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/02-windows-defender-smartscreen-run-anyway.png) 3. Sigue los pasos del instalador: - Pantalla de bienvenida: ![Bienvenida del instalador](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/03-haddock-connector-installer-welcome-screen.png) - Selecciona la carpeta de destino: ![Carpeta de destino](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/04-haddock-connector-installer-select-destination-folder.png) - Asegúrate de que la opción **"Crear un acceso directo en el escritorio"** (Create a desktop shortcut) esté marcada. ![Tareas adicionales](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/05-haddock-connector-installer-select-additional-tasks-desktop-shortcut.png) - Revisa el resumen y haz clic en **"Instalar"**. ![Listo para instalar](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/06-haddock-connector-installer-progress.png) 4. Al terminar la instalación, asegúrate de marcar **"Launch haddock Conector"** y haz clic en **"Finalizar"**. El programa se abrirá automáticamente. ![Finalizar instalación](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/07-haddock-connector-installer-finish-and-launch-application.png) --- ## 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**. ![Selección de Agora y Token de API en la pantalla Conecta tu TPV](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/08-haddock-connector-app-connect-agora.png) **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`. ![Vinculación del restaurante con Código de autenticación e IDs Workplace](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/09-haddock-connector-app-link-restaurant.png) **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. ![Pantalla Conexiones durante la importación del historial de ventas](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/10-haddock-connector-app-importing-sales-history.png) Cuando la sincronización termine correctamente, el restaurante aparecerá **«Al día»** y se actualizará la hora de su última sincronización. ![Restaurante al día con la última sincronización y el botón Sincronizar ahora](https://storage.googleapis.com/helpdesk-haddock-images/integrations/point-of-sale/agora-connector-new-and-recommended/images/11-haddock-connector-app-up-to-date.png) --- ## 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](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](https://support.haddock.app/es/article/como-solucionar-los-problemas-de-conexion-con-mi-tpv-x9w7m2/)** o contacta con el chat de soporte de haddock. *Las integraciones pueden incluir costes adicionales no soportados por haddock.*