Maître no sustituye tu TPV: lo lee. Se conecta a Ágora (agorapos.com) para traer las ventas y comandas de cada cliente, y con eso construye su ficha automáticamente.
Qué ofrece la API de Ágora
Ágora dispone de una API para intercambiar información con sistemas externos (ERP, PMS de hotel, plataformas de delivery, CRM). Es la vía por la que Maître obtiene los datos de consumo.
Dato
Para qué lo usa Maître
Acceso
Ventas / tickets
Historial de visitas y gasto por cliente
solo lectura
Comandas (líneas)
Qué repite, qué probó una vez, qué bebe
solo lectura
Clientes
Casar el consumo con la ficha correcta
solo lectura
Catálogo de artículos
Nombres de plato, categorías (opcional)
solo lectura
Maître solo lee. Nunca modifica ni bloquea tu TPV.
Cómo viajan los datos
Ágora (tu TPV)
ventas y comandas
→
Servidor Maître
llama a la API con la clave, guarda la ficha
→
App de sala
ficha del cliente en la tablet
Seguridad: las llamadas a Ágora se hacen desde el servidor de Maître, nunca desde el navegador. La API key se guarda como variable de entorno en el servidor — jamás en el código ni visible para el cliente.
Qué hace falta para activarlo
1
Licencia de Ágora con el módulo de API / integración activado (se solicita a Ágora o a tu distribuidor).
2
Documentación técnica de la API — endpoints de ventas, comandas y clientes. La entrega Ágora al habilitar la integración.
3
Datos del servidor Ágora del local (host / IP, puerto) y la API key / credenciales.
4
Confirmar si tu Ágora es local (on-premise) o cloud — cambia la forma de conectarnos.
Notas por voz · Whisper
Cuando sala dicta una nota, el audio se transcribe con Whisper (OpenAI) desde el servidor. La clave de OpenAI también vive como variable de entorno en el servidor. Ruta: audio → servidor → Whisper → texto en la ficha.