Integración de Speakeasy con Ágora: entradas al momento

La integración de Speakeasy con Ágora crea en el TPV cada entrada que el local vende en Speakeasy, en el momento en que se vende y con las consumiciones que incluye, para canjearla en barra leyendo su código. Se configura en tres pasos: un tipo de entrada en Ágora por número de consumiciones, la integración en Connect Manager y las credenciales para Speakeasy.

Esta guía es para el técnico de FOS o del distribuidor que conecta un local que vende con Speakeasy. Speakeasy manda las entradas a la API de entradas de Connect Manager; los detalles técnicos de esa API, para los desarrolladores de Speakeasy, están en su propia guía.

Qué necesitas#

Paso 1: crea los tipos de entrada en Ágora#

1. En la configuración de entradas de Ágora, crea un tipo de entrada por cada número de consumiciones que vaya a vender el local, válido en los grupos de TPV de ese local. Un nombre que diga la ticketera y las consumiciones ayuda en los informes, por ejemplo «CONS. SPEAKEASY FITZ MALLORCA (1 CONS)».
2. Apunta el identificador numérico de cada tipo: es el que se pone después en Connect Manager.
3. Decide cuál será el tipo por defecto, el que se usa si llega una entrada con un número de consumiciones que no has previsto. Lo más prudente es el de sin consumición.

[!TIP] Si el local ya vende con otra ticketera, puede usar sus mismos tipos de entrada, pero entonces en los informes de Ágora no se distinguen las dos ticketeras.

Paso 2: da de alta la integración en Connect Manager#

1. En /admin → Locales, abre el local y entra en Ecosistema Conectado.
2. Pulsa crear y, en Servicio / Proveedor, elige API de entradas.
3. Deja encendido Modo prueba: recibir sin mandar a Ágora. Con él, las entradas se reciben y se guardan pero no se crean en Ágora.
4. En Proveedor, escribe Speakeasy.
5. En ID del workplace en Ágora, pon el workplace del local. Así solo se aceptan las entradas de ese local, aunque alguien use el token con otro.
6. En Tipo de entrada en Ágora (SettingsId), pon el tipo por defecto del paso 1.
7. Deja vacío Imprimir en el TPV (PosId), salvo que el local quiera que cada entrada se imprima al crearse en un TPV concreto.
8. En Tipos según la entrada, pulsa Añadir regla una vez por cada número de consumiciones: deja vacío Nombre de la entrada, pon el número en Copas y el identificador del tipo en Tipo en Ágora.
9. Guarda.

Las reglas se miran de arriba abajo y vale la primera que coincide. Un campo vacío vale para todo. Así queda la configuración de un local que vende entradas de 0, 1 y 2 consumiciones:

Si una entrada concreta tiene que ir a otro tipo aunque lleve las mismas consumiciones, añade arriba una regla con su nombre exacto en Nombre de la entrada; el nombre se compara sin distinguir mayúsculas.

Paso 3: pasa las credenciales a Speakeasy#

1. En la fila de la integración, pulsa Datos para el proveedor. Salen la Dirección (POST), https://hub.connectmanager.es/api/v1/tickets, y el Token (Authorization: Bearer).
2. Pásale a Speakeasy la dirección, el token y el workplace del local por un canal privado: con el token se crean entradas en el Ágora de ese local.
3. Diles qué número de consumiciones lleva cada entrada que vende el local: es el dato que manda Speakeasy y con el que se elige el tipo de entrada en Ágora.

Cada local tiene su propia integración y su propio token. Si el token se filtra, pulsa Generar token nuevo: el anterior deja de funcionar en el acto y Speakeasy tendrá que poner el nuevo.

Paso 4: prueba y apaga el modo prueba#

1. Pide a Speakeasy que mande unas entradas de prueba con el token, una de cada número de consumiciones, y que cancele una de ellas.
2. Pulsa Entradas recibidas en la fila de la integración: deben aparecer con su código, su nombre, sus consumiciones y el estado Prueba (no va a Ágora).
3. Si todo llega bien, edita la integración, apaga Modo prueba: recibir sin mandar a Ágora y guarda.
4. Pide otra entrada de prueba y comprueba que en Entradas recibidas pasa a En Ágora y que en el TPV se canjea con el tipo de entrada esperado.
5. Pide que la cancelen y comprueba que pasa a Anulada en Ágora y que el TPV ya no la acepta.

[!WARNING] Las entradas que llegaron en modo prueba no se mandan a Ágora al apagarlo. Si alguna era una venta de verdad, que Speakeasy la vuelva a mandar.

Cómo funciona#

Speakeasy avisa a Connect Manager de cada entrada y de cada cambio de estado (vendida, usada, cancelada, devuelta). Connect Manager responde enseguida, guarda el aviso y crea o actualiza la entrada en el Ágora del local por detrás, para que un Ágora apagado no frene la venta. Si Ágora no responde, lo reintenta.

sequenceDiagram
    participant SE as Speakeasy
    participant CM as Connect Manager
    participant AG as Ágora del local
    SE->>CM: Entrada vendida (código, consumiciones, validez)
    CM-->>SE: Recibida
    CM->>CM: Elige el tipo de entrada por las consumiciones
    CM->>AG: Crea la entrada canjeable
    AG-->>CM: Creada
    SE->>CM: Entrada cancelada o devuelta
    CM-->>SE: Recibida
    CM->>AG: La vuelve a mandar ya caducada

Qué llega a Ágora#

• Tipo de entrada: el de la primera regla que coincide o, si no coincide ninguna, el de por defecto.
• Código: el de la entrada en Speakeasy, que es el que se lee en barra.
• Validez: desde y hasta cuándo se puede canjear, en la hora del evento. Si Speakeasy no la manda, vale lo que diga el tipo de entrada en Ágora.

A Ágora no llegan ni el cliente ni el importe: la entrada no es una venta del TPV, porque la cobró Speakeasy. Esos datos se guardan en Connect Manager para poder conciliar.

Qué pasa con cada estado#

flowchart LR
    A[Aviso de Speakeasy] --> B{Estado}
    B -- Vendida, usada o devuelta en parte --> C[Se crea o se mantiene en Ágora]
    B -- Cancelada o devuelta --> D{Estaba ya en Ágora}
    D -- Sí --> E[Se manda caducada y deja de valer]
    D -- No --> F[No se manda]
    B -- Pendiente de pago o caducada --> F

Errores frecuentes#

Preguntas frecuentes#

¿Cuánto tarda una entrada vendida en poder canjearse?#

Unos segundos: Speakeasy avisa al venderla y Connect Manager la crea en Ágora en cuanto la recibe, sin esperar a ninguna sincronización programada.

¿Cómo sabe Ágora cuántas consumiciones lleva cada entrada?#

Por el tipo de entrada. Connect Manager elige el tipo con las reglas de la integración, según las consumiciones incluidas que manda Speakeasy. Por eso hace falta un tipo en Ágora por cada número de consumiciones.

¿Qué pasa si se cancela una entrada en Speakeasy?#

Si ya estaba en Ágora, se vuelve a mandar caducada y deja de poder canjearse. Si se cancela antes de llegar a Ágora, no se manda. Una entrada que ya se ha canjeado no se puede anular.

¿Se cobra o se factura la entrada en Ágora?#

No. La cobra Speakeasy y en Ágora solo existe como entrada canjeable, no como venta.

¿Cuánto cuesta la integración?#

20 € al mes por local, como dice su ficha del catálogo.

Fuentes#

• Connect Manager: API de entradas, la especificación que siguen las ticketeras, y la pantalla de la integración «API de entradas» del panel, versión del 04-11-2026.
• Guía del integrador de Ágora, apartado «Entradas»: importación de entradas con su tipo, su código y su validez.
• Ficha del catálogo: Speakeasy.