Connect Manager es la plataforma de FOS que conecta el TPV Ágora con lo que un restaurante o un hotel usa además del TPV: las plataformas de delivery, el PMS del hotel, el ERP y la contabilidad, los sistemas fiscales, las reservas, el club de socios o las flotas de reparto. Esta documentación está pensada para los técnicos que ponen en marcha esas integraciones: qué datos hacen falta, dónde se configura cada una, cómo funciona por dentro y qué hacer cuando algo falla.
Las piezas de Connect Manager#
Toda integración tiene tres extremos: Ágora, Connect Manager y el sistema del tercero (Uber Eats, Mews, SAP…). Connect Manager habla con Ágora a través de la API del integrador de Ágora y con cada tercero a través de la suya, de modo que ninguno de los dos tiene que conocer al otro.
- Ágora: el TPV del local, o el ACMS central si es un grupo. Connect Manager le habla por su API del integrador (el servicio que escucha en el puerto 8984 del equipo de Ágora, con su
Api-Token). Desde Ágora salen también los avisos y botones que usan algunas integraciones: las acciones personalizadas que abren una pantalla de Connect Manager dentro del TPV, la integración de validación de documentos y la URL de aviso de los usuarios repartidor. - Connect Manager App (
app.connectmanager.es): el motor de las integraciones de pedidos de Uber Eats, Glovo y Just Eat, de los PMS de hotel, de los sistemas fiscales, de los ERP, de las reservas y del ticketing. Se configura en Administración → Locales, local a local. - El hub (
hub.connectmanager.es): los paneles. El del cliente (/app: Delivery Hub e informes), Fidelización (/fidelizacion), Delivery propio (/delivery-propio), el portal del distribuidor (/distributor-portal, con las integraciones y las conexiones de sus clientes) y el de administración (/admin), donde FOS configura las integraciones propias del hub, como las de las flotas de reparto. - Zero Connect: el programa que se instala en el equipo de Ágora para que Connect Manager llegue a su API sin abrir puertos en el router, sin IP fija y sin DNS dinámica. Ver Zero Connect.
El dibujo de abajo resume el camino de los datos: Ágora queda conectado a Connect Manager (directamente o a través de Zero Connect) y Connect Manager se encarga de hablar con cada tercero.
flowchart LR
TPV[TPV Ágora o ACMS] --- ZC[Zero Connect]
ZC --- CM[Connect Manager]
CM --- DEL[Uber Eats, Glovo y Just Eat]
CM --- PMS[PMS del hotel]
CM --- ERP[ERP y contabilidad]
CM --- FIS[Sistemas fiscales]
CM --- OTR[Reservas, ticketing, flotas y más]Cómo está organizada la documentación#
Los manuales están repartidos en portales, uno por producto, que se eligen en la barra de arriba. Todos se buscan a la vez con Ctrl + K (o ⌘ + K en Mac), y en la portada de la documentación están las integraciones documentadas de la A a la Z.
| Portal | Qué encontrarás |
|---|---|
| General | Esta introducción, la guía rápida, seguridad y glosario, Zero Connect, Connect Manager IA y las integraciones de ERP, fiscales, reservas, comunicación y pagos. |
| Delivery Hub | Pedidos de Uber Eats, Glovo y Just Eat en Ágora: el alta de cada plataforma, las cartas digitales, el panel y los informes. |
| Hotel Hub | Cargos a habitación desde Ágora en el PMS del hotel: cómo funciona y la configuración de cada PMS. |
| Fidelización | El club de socios conectado a Ágora, la tarjeta en Apple Wallet y Google Wallet, WhatsApp y las reseñas. |
| Plataformas de reparto | Riders de las flotas de reparto pedidos desde Ágora: la configuración de cada flota y su seguimiento. |
| Delivery propio | La tienda online propia conectada a Ágora: la carta, el ciclo del pedido, los mapas, la medición y la IA. |
Qué tiene cada manual de integración#
Los manuales de integración siguen siempre el mismo orden, para que encuentres lo que buscas sin leer todo:
- Qué hace la integración y, tan importante, qué no hace.
- Requisitos: versiones, licencias, cuentas en el tercero y quién hace cada parte.
- Datos que necesitamos: la tabla de lo que hay que pedir al cliente o al tercero antes de empezar.
- Configuración paso a paso, en cada sistema y en el orden real de trabajo.
- Cómo funciona, con los flujos dibujados.
- Comprobar que funciona y errores frecuentes, con su causa y su solución.
- Preguntas frecuentes.
[!NOTE] Los diagramas se dibujan en el navegador. Si no se ven, debajo de cada uno está su versión en texto.
Quién hace qué#
En una puesta en marcha intervienen varias partes, y conviene saber desde el principio qué le toca a cada una:
- FOS da de alta el local y la integración en Connect Manager y da soporte de la capa de Connect Manager.
- El distribuidor de Ágora prepara Ágora (API del integrador, acciones personalizadas, formas de pago, familias…), instala Zero Connect si hace falta y revisa la configuración siguiendo el manual de la integración.
- El cliente facilita las credenciales y los datos de su cuenta en el tercero y valida que todo funciona como espera.
- El tercero (la plataforma, el PMS, el ERP…) da el acceso a su API y responde de su disponibilidad.
Preguntas frecuentes#
¿Qué es Connect Manager?#
Es la plataforma de FOS que conecta el TPV Ágora con plataformas de delivery, PMS de hotel, ERP, sistemas fiscales, reservas, fidelización y flotas de reparto, sin integraciones punto a punto entre cada sistema y Ágora.
¿Hay que abrir puertos en el router para conectar Ágora?#
No. Con Zero Connect, el propio equipo de Ágora abre la conexión hacia fuera, así que no hacen falta puertos abiertos, IP fija ni DNS dinámica.
¿Quién da de alta una integración?#
FOS da de alta el local y la integración en Connect Manager. El distribuidor prepara Ágora y revisa la configuración con los datos que se piden en el manual de cada integración.
¿Dónde ve un distribuidor las integraciones de sus clientes?#
En el portal del distribuidor (hub.connectmanager.es/distributor-portal), que enseña las integraciones y las conexiones de sus clientes.
¿Qué versión de Ágora hace falta?#
Depende de la integración: cada manual lo indica en su apartado de requisitos.