La integración de CiberSuite con Ágora añade al TPV un botón que genera un PIN de acceso a la wifi del local: el camarero lo pulsa, Connect Manager pide el PIN a CiberSuite y Ágora imprime un ticket con el código, la tarifa, la duración y los dispositivos permitidos para dárselo al cliente.
Este manual es para el técnico de FOS o del distribuidor que configura la integración en un local que gestiona su wifi con CiberSuite.
Qué hace la integración#
- Abre desde una acción personalizada de Ágora la ventana Solicitud de WIFI, que pide al momento un PIN nuevo a CiberSuite.
- Muestra en pantalla el PIN, la tarifa asignada, la duración, los dispositivos permitidos y si se pueden usar redes P2P y streaming.
- Imprime esos mismos datos en la impresora de Ágora configurada, con una cabecera opcional (por ejemplo, el nombre de la red o un saludo) y corte de papel.
- Imprime de dos maneras: a través del propio TPV, sin abrir Ágora a Internet, o desde Connect Manager con la API de Ágora.
- Se autentica en CiberSuite con un token permanente o con la pareja de claves del cliente, con la que obtiene un token en cada petición.
- Guarda cada petición con la respuesta de CiberSuite.
Qué no hace#
- No deja elegir desde el TPV la duración ni el número de dispositivos: la petición va siempre con 1 dispositivo y 1 hora, y se imprime lo que CiberSuite confirma según la tarifa.
- No asocia el PIN al ticket ni al cliente de Ágora, ni lo cobra: es un ticket aparte.
- No anula ni consulta PIN ya generados.
Requisitos#
- CiberSuite con acceso a su API para TPV y las credenciales del local: un token permanente, o una Customer key y un Customer token. Las facilita CiberSuite.
- Local en Connect Manager. FOS da de alta el local y la integración.
- Ágora con Acciones personalizadas y una impresora de tickets dada de alta.
- Solo si se marca Imprimir usando la API de Agora: la URL de la API y la API key de Ágora en el local, y la API accesible desde Internet (puerto abierto o Zero Connect). Sin esa opción, el ticket lo imprime el propio TPV y no hace falta.
Datos que necesitamos#
| Dato | Quién lo facilita / dónde se saca | Ejemplo o formato | Obligatorio |
|---|---|---|---|
| URL de la API de CiberSuite | CiberSuite | https://cibersuite.ejemplo.com/ (con / final) | Sí |
| Token permanente | CiberSuite | •••••••• | Sí, o la pareja de claves |
| Customer key y Customer token | CiberSuite | •••••••• | Sí, si no hay token permanente |
| Nombre de la impresora de Ágora | Configuración de impresoras de Ágora | BARRA | Sí |
| Cabecera del ticket | Cliente | WIFI HOTEL DEMO | No |
Configuración paso a paso#
En CiberSuite#
- Pide a CiberSuite la URL de su API y las credenciales del local: token permanente, o Customer key y Customer token.
- Comprueba con CiberSuite qué tarifa se aplica a los PIN generados desde el TPV: de ella salen la duración, los dispositivos y los permisos que se imprimen.
En Connect Manager#
- En
https://app.connectmanager.es, ve a Administración → Locales, abre el local y pulsa Guardar para habilitar los módulos. Si vas a imprimir por API, revisa antes la URL de API y la API key de Ágora. - Entra en Otras integraciones, pulsa Añadir y en Proveedor elige CiberSuite.
- Rellena la pestaña Configuración:
- URL Api: la de CiberSuite, terminada en
/. - Impresora: el nombre exacto de la impresora de Ágora.
- Imprimir usando la API de Agora: márcala solo si el TPV no puede imprimir desde la ventana y la API de Ágora es accesible desde Internet.
- Utilizar token permanente: márcala si CiberSuite te ha dado un token permanente y escríbelo en Token permanente:. Desmarcada, rellena Customer key: y Customer token:.
- Cabecera del ticket WIFI: texto opcional que se imprime arriba.
- URL Api: la de CiberSuite, terminada en
- Pulsa Guardar y copia la URL del botón de petición de WIFI que aparece al pie.
En Ágora#
- En Herramientas → Acciones personalizadas, pulsa Nuevo: en Texto escribe, por ejemplo,
WIFI; en Tipo, Url/Aplicación; en Acción, la URL del botón de petición de WIFI. Deja marcada Mostrar Urls en un diálogo de Ágora y pulsa Aceptar. - Coloca la acción en Herramientas → Configuración de botones, en el perfil que use el local, y da su permiso a los perfiles de usuario que vayan a generar PIN.
Cómo funciona#
Al pulsar el botón, Ágora abre la ventana de Connect Manager, que pide un PIN a CiberSuite. Si la integración usa la pareja de claves, primero obtiene un token con ellas; con token permanente, lo usa directamente. CiberSuite devuelve el PIN y los datos de su tarifa, la ventana los enseña y el ticket se imprime: por defecto, la ventana se lo pasa a Ágora y es el TPV quien lo imprime; con Imprimir usando la API de Agora, lo manda Connect Manager a la API de Ágora. Si la impresión va bien, la ventana se cierra sola.
sequenceDiagram
participant TPV as TPV Ágora
participant CM as Connect Manager
participant CS as CiberSuite
TPV->>CM: Abre la ventana Solicitud de WIFI
CM->>CS: Token con la Customer key, si no hay token permanente
CS-->>CM: Token
CM->>CS: Genera un PIN para 1 dispositivo y 1 hora
CS-->>CM: PIN, tarifa, duración y dispositivos
CM-->>TPV: Muestra los datos y el ticket listo
TPV->>TPV: Imprime el ticket del PIN y cierra la ventana
Qué se imprime#
- La cabecera configurada, si la hay.
- Código PIN, tarifa asignada, duración en horas y dispositivos permitidos.
- Si se pueden usar redes P2P y streaming.
- El corte de papel al final.
Si algo falla#
Los errores salen en la ventana en rojo, precedidos de «Ocurrió un error:». Si CiberSuite contesta con un error, se ve su texto; si no contesta, «No se ha recibido respuesta de la api de CiberSuite». Si falla la impresión por la API de Ágora, la ventana enseña el PIN igualmente y el motivo del fallo, para que el camarero pueda dárselo al cliente. No hay reintentos automáticos: se vuelve a pulsar el botón y se genera un PIN nuevo.
Comprobar que funciona#
- Pulsa el botón WIFI en el TPV: la ventana debe mostrar «Realizando la petición...» y después el PIN con sus datos.
- Comprueba que el ticket sale por la impresora configurada, con la cabecera y el corte de papel.
- Conecta un móvil a la wifi con ese PIN y comprueba la duración y los dispositivos de la tarifa.
- Si usas impresión por API, prueba también con la impresora apagada: la ventana debe mostrar el PIN y el error de impresión.
Errores frecuentes y solución#
| Síntoma | Causa | Solución |
|---|---|---|
| «Ocurrió un error: El token no es válido» | Token permanente vacío o incorrecto, o CiberSuite no ha devuelto token con la pareja de claves. | Revisa el token o la Customer key y el Customer token con CiberSuite. |
| «Ocurrió un error: No se ha recibido respuesta de la api de CiberSuite» | CiberSuite no responde o la URL Api está mal. | Comprueba la URL (terminada en /) y el servicio de CiberSuite. |
| Mensaje de error de CiberSuite en la ventana | CiberSuite rechaza la petición (por ejemplo, por la tarifa o la cuenta). | Revísalo con CiberSuite. |
| Se ve el PIN pero no se imprime | El nombre de la impresora no coincide con Ágora, o la acción no se abre en un diálogo de Ágora. | Corrige el campo Impresora y marca Mostrar Urls en un diálogo de Ágora. |
| «Error: …» al imprimir con la opción de API | Connect Manager no llega a la API de Ágora del local. | Revisa la URL de API y la API key, o desmarca Imprimir usando la API de Agora. |
| El botón no aparece en el TPV | Falta colocarlo en la configuración de botones o el permiso en el perfil del usuario. | Añádelo al perfil de botones y da el permiso. |
Preguntas frecuentes#
¿Cómo imprimo un PIN de wifi de CiberSuite desde Ágora?#
Con la acción personalizada que crea la integración: el camarero pulsa el botón y Ágora imprime el ticket con el PIN.
¿Puedo elegir cuántas horas dura el PIN?#
No desde el TPV. La duración y los dispositivos los marca la tarifa que aplica CiberSuite.
¿Hace falta abrir Ágora a Internet?#
No, salvo que se marque Imprimir usando la API de Agora. Por defecto imprime el propio TPV.
¿Puedo cambiar el texto de la cabecera del ticket?#
Sí, en Cabecera del ticket WIFI de la configuración de la integración.
Referencias#
- Ficha de la integración: CiberSuite en el catálogo de Connect Manager.
- Zero Connect: publicar la API de Ágora sin abrir puertos.