Índice
¿Qué es esta integración?
La integración con SmartPanel conecta Golfmanager con SmartPanel, la plataforma de Business Intelligence (BI) y CRM especializada en el sector del golf (Visual Data Intelligence). SmartPanel forma parte de Golfmanager tras su adquisición, y su objetivo es acercar el análisis avanzado de datos a cualquier gestor, sin necesidad de conocimientos técnicos. Permite:
Analizar los datos del club (reservas, ventas, clientes…) en cuadros de mando visuales y sencillos de interpretar.
Trabajar el CRM con los datos reales del club: segmentación de comunicaciones, plantillas, análisis de campañas y encuestas de satisfacción.
Entrar en SmartPanel directamente desde Golfmanager mediante un enlace de acceso personal guardado en la ficha de cada usuario.
La conexión se realiza a través de la API v3 de Golfmanager, mediante un usuario de API dedicado que el club crea en su tenant y al que el equipo de Golfmanager asigna la API key de SmartPanel.
La API key es la credencial que identifica a SmartPanel frente a Golfmanager. Queda asociada al usuario «Smart Panel» del club y solo la gestiona el equipo de Golfmanager. No la compartas ni la copies en otros usuarios.
¿Qué problema resuelve?
Centraliza la información del club en un único panel visual, sin tener que cruzar informes a mano.
Evita exportaciones manuales a Excel u otras herramientas para analizar la actividad.
Potencia el CRM con datos reales de clientes, reservas y consumo para segmentar y lanzar campañas.
Facilita la toma de decisiones basada en datos (ocupación, ingresos, comportamiento de clientes, satisfacción).
Simplifica el acceso: cada usuario entra en SmartPanel desde Golfmanager con su enlace personal.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con SmartPanel a través de la API v3 de Golfmanager:
Golfmanager → SmartPanel: SmartPanel consulta los datos del club en Golfmanager usando la API key asignada al usuario «Smart Panel», y los procesa para mostrarlos en sus cuadros de mando y en su CRM.
SmartPanel → Golfmanager (acceso): SmartPanel genera un enlace de acceso directo por usuario, que se guarda en el campo «URL de SmartPanel» de su ficha en Golfmanager.
Las consultas están sujetas a los límites de peticiones (por minuto y por hora) configurados para el usuario y para la API de SmartPanel.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Clientes y socios (datos de ficha, tipo de cliente, consentimientos) | Golfmanager → SmartPanel | Segmentación y campañas en el CRM |
Reservas (salidas, recursos, fechas, jugadores) | Golfmanager → SmartPanel | Análisis de ocupación y actividad |
Ventas, cobros y productos | Golfmanager → SmartPanel | Análisis de ingresos y consumo |
Enlace de acceso directo del usuario (incluye token) | SmartPanel → Golfmanager (se copia manualmente) | Entrar en SmartPanel desde Golfmanager con el usuario correcto |
Formulario de autorización
Para autorizar la integración entre tu club y SmartPanel a través de la API, antes de empezar tendrás que enviar a Golfmanager el documento de autorización cumplimentado y firmado por ambas partes. Encontrarás el documento y el procedimiento en este enlace.
Requisitos previos (antes de activar la integración)
Tener contratado SmartPanel (ver Datos de contacto).
Trabajar con Golfmanager v3.
Haber enviado el formulario de autorización firmado por ambas partes.
Permisos de administrador en Golfmanager para crear y editar usuarios en Configuración > Sistema > Usuarios.
Permisos para editar usuarios en SmartPanel, para generar los enlaces de acceso directo.
Que el equipo de Golfmanager active tu club en la API de SmartPanel y asigne la API key (paso B).
Cómo se configura (paso a paso)
La puesta en marcha tiene cuatro bloques: (A) crear el usuario de SmartPanel en Golfmanager (lo hace el club), (B) dar de alta el club en la API de SmartPanel y asignar la API key (lo hace el equipo de Golfmanager), (C) comprobar la conexión y (D) configurar el acceso directo de cada usuario. Más abajo, en «Explicación de cada campo», tienes el detalle de cada campo.
A) Crear el usuario de SmartPanel (club)
Accede a Configuración > Sistema > Usuarios.
Crea un nuevo usuario con estos valores:
Nombre: Smart Panel
Email: info@smartpanel.com
Tipo: Administrador
Peticiones por hora: 1.000
Peticiones por minuto: 30
Guarda los cambios y avisa al equipo de Golfmanager de que el usuario ya está creado.
⚠️ El equipo de Golfmanager no puede completar el paso B hasta que el club haya creado el usuario «Smart Panel».
B) Alta del club en la API de SmartPanel (equipo de Golfmanager)
Desde Superadmin > Api V3, busca la API de Smartpanel (id 28).
En la sección Tenants, pulsa Nuevo, selecciona el tenant del club en el desplegable y pulsa Guardar.
En la sección Límites, ajusta:
Peticiones por minuto: 30 × número de tenants añadidos.
Peticiones por hora: 1.000 × número de tenants añadidos.
Selecciona la API key de SmartPanel y cópiala.
Desde el tenant del club, accede a Configuración > Sistema > Usuarios > Smart Panel, pega la API key en el usuario y guarda.
NOTA sobre los límites. Los límites de la API de SmartPanel se comparten entre todos los tenants dados de alta. Cada vez que se añade un club nuevo, hay que actualizar los límites multiplicando por el número total de tenants.
C) Comprobar la conexión
Confirma con SmartPanel que ya puede leer los datos del club.
Una vez confirmada, continúa con el paso D.
D) Configurar el acceso directo de cada usuario
Para cada persona que vaya a usar SmartPanel, genera su enlace en SmartPanel y guárdalo en su ficha de Golfmanager. Tienes el procedimiento completo en Acceso directo a SmartPanel desde Golfmanager.
Explicación de cada campo de configuración
Los campos 1 a 6 corresponden al usuario técnico «Smart Panel» en Configuración > Sistema > Usuarios. El campo 7 está en la ficha de cada usuario que accede a SmartPanel. De cada uno se indica qué es, su impacto, un ejemplo y cómo se comporta el sistema.
1. Nombre
Nombre del campo: Nombre.
Descripción: nombre identificativo del usuario de la integración.
Impacto en el sistema: permite identificar fácilmente qué usuario usa SmartPanel en el listado de usuarios y en los registros.
Ejemplo de uso: «Smart Panel».
Qué ocurre cuando se utiliza: las operaciones que haga SmartPanel quedan asociadas a este usuario.
Comportamiento del sistema: no afecta al funcionamiento, pero conviene respetarlo para que el equipo de Golfmanager lo localice sin errores.
2. Email
Nombre del campo: Email.
Descripción: email del usuario de la integración.
Impacto en el sistema: identifica de forma única al usuario de SmartPanel dentro del tenant.
Ejemplo de uso: info@smartpanel.com.
Qué ocurre cuando se utiliza: el equipo de Golfmanager lo usa para localizar el usuario al asignar la API key.
Comportamiento del sistema: si se usa otro email, puede retrasarse la activación al no encontrarse el usuario esperado.
3. Tipo
Nombre del campo: Tipo.
Descripción: nivel de permisos del usuario.
Impacto en el sistema: determina a qué datos puede acceder SmartPanel a través de la API.
Ejemplo de uso: «Administrador».
Qué ocurre cuando se utiliza: SmartPanel puede consultar todos los datos necesarios para sus análisis y su CRM.
Comportamiento del sistema: con un tipo con menos permisos, parte de la información no llegará a SmartPanel y los cuadros de mando quedarán incompletos.
4. Peticiones por hora
Nombre del campo: Peticiones por hora.
Descripción: número máximo de llamadas a la API que el usuario puede hacer en una hora.
Impacto en el sistema: protege el rendimiento de Golfmanager y marca el volumen de datos que SmartPanel puede leer.
Ejemplo de uso: 1.000.
Qué ocurre cuando se utiliza: cada consulta de SmartPanel suma al contador horario.
Comportamiento del sistema: al superarse, la API rechaza temporalmente las peticiones hasta la siguiente ventana y la actualización de datos se retrasa.
5. Peticiones por minuto
Nombre del campo: Peticiones por minuto.
Descripción: número máximo de llamadas a la API que el usuario puede hacer en un minuto.
Impacto en el sistema: evita picos de carga en el tenant del club.
Ejemplo de uso: 30.
Qué ocurre cuando se utiliza: SmartPanel reparte sus consultas respetando este límite.
Comportamiento del sistema: si se supera, las peticiones de ese minuto se rechazan y se reintentan más tarde.
6. API key (la asigna el equipo de Golfmanager)
Nombre del campo: API key.
Descripción: clave de la API v3 de SmartPanel que se asigna al usuario «Smart Panel» del club.
Impacto en el sistema: es la credencial que autoriza a SmartPanel a leer los datos del club; sin ella no hay conexión.
Ejemplo de uso: no la rellena el club: la pega el equipo de Golfmanager en el paso B.
Qué ocurre cuando se utiliza: SmartPanel la envía en cada llamada a la API de Golfmanager.
Comportamiento del sistema: si falta, se modifica o se elimina el usuario, SmartPanel deja de recibir datos del club.
7. URL de SmartPanel (ficha de cada usuario)
Nombre del campo: URL de SmartPanel.
Descripción: enlace de acceso directo a SmartPanel de una persona concreta. Se encuentra en la sección General de la ficha del usuario en Golfmanager.
Impacto en el sistema: vincula al usuario de Golfmanager con su usuario de SmartPanel para que pueda entrar directamente.
Ejemplo de uso: pegas el enlace generado con «Generar Enlace» en la edición de ese mismo usuario en SmartPanel.
Qué ocurre cuando se utiliza: al usar el enlace, se abre SmartPanel con el usuario al que pertenece.
Comportamiento del sistema: si el enlace está incompleto (falta el token o los parámetros finales), contiene espacios o saltos de línea, o es de otra persona, el acceso fallará o abrirá un usuario equivocado.
Acceso directo a SmartPanel desde Golfmanager (URL de SmartPanel)
Cada usuario de Golfmanager puede tener su propio enlace de acceso directo a SmartPanel. El enlace se genera en SmartPanel y se guarda en el campo «URL de SmartPanel» de la ficha del usuario en Golfmanager.
Antes de empezar: accede a ambas plataformas con permisos para editar usuarios e identifica a la misma persona en SmartPanel y en Golfmanager antes de copiar el enlace. Este enlace se configura en la ficha de cada persona, no en el usuario técnico «Smart Panel».
1) Generar el enlace en SmartPanel
Abre la edición del usuario. En SmartPanel, localiza al usuario que quieres vincular y entra en su pantalla de edición.
Localiza «Conectar Golfmanager». Desplázate hasta el bloque situado en la parte inferior de la pantalla.
Pulsa «Generar Enlace». El enlace de acceso directo aparecerá en el cuadro de texto del mismo bloque.
Copia el enlace completo. Pulsa el icono «Copiar al portapapeles». Si lo copias manualmente, selecciona todo el contenido del cuadro, aunque se muestre en varias líneas.
⚠️ Conserva el enlace tal como se genera, incluidos el token y los parámetros finales. Si falta cualquier parte, el acceso no funcionará.
2) Pegar el enlace en Golfmanager
Abre la ficha del usuario. En Golfmanager, entra en Configuración > Sistema > Usuarios y abre la ficha de la persona a la que pertenece el enlace generado en SmartPanel.
Pulsa «Editar». El botón se encuentra en la parte superior de la ficha.
Localiza «URL de SmartPanel». Está en la sección General de la ficha.
Pega el enlace. Introduce el contenido copiado desde SmartPanel. Si ya hay un valor, sustitúyelo por el enlace completo del usuario correcto. Evita añadir espacios o saltos de línea.
Guarda los cambios desde la pantalla de edición y vuelve a consultar la ficha para comprobar que el valor se conserva.
3) Comprobar la configuración
Reabre la ficha y verifica que el campo URL de SmartPanel sigue informado.
Prueba el acceso con el enlace configurado y comprueba que abre SmartPanel con el usuario previsto.
Si no funciona, revisa que has copiado todo el enlace y que no has mezclado usuarios.
Cómo se usa en el día a día
Análisis y CRM (club)
Entra en SmartPanel con el acceso directo configurado en tu usuario de Golfmanager.
Consulta los cuadros de mando con la actividad del club (ocupación, ingresos, clientes…).
Usa el CRM para segmentar clientes, preparar plantillas, lanzar campañas y enviar encuestas de satisfacción.
Analiza los resultados de las campañas y ajusta tus acciones comerciales.
Mantenimiento de la integración (administración)
Mantén activo el usuario «Smart Panel» en Golfmanager y no cambies su email, tipo ni límites sin consultarlo.
Cuando se incorpore una persona nueva que vaya a usar SmartPanel, configura su acceso directo. Si alguien deja de usarlo, vacía su campo «URL de SmartPanel».
Sigue registrando la actividad en Golfmanager como siempre: SmartPanel analiza lo que está en Golfmanager, así que la calidad de los datos depende de ello.
Comprobar el estado de la conexión
Si los datos de SmartPanel no se actualizan, revisa:
Configuración > Sistema > Usuarios > Smart Panel: que el usuario existe, está activo, es de tipo Administrador y tiene la API key asignada.
Límites de peticiones: que coinciden con los indicados (1.000/hora y 30/minuto).
SmartPanel: la fecha de los últimos datos cargados. Si no avanza, contacta con el soporte de SmartPanel.
Si el problema es de acceso (el enlace no abre SmartPanel), revisa el campo «URL de SmartPanel» de ese usuario según el apartado Comprobar la configuración.
Limitaciones a tener en cuenta
La activación requiere al equipo de Golfmanager: el club no puede asignar la API key por sí mismo.
El usuario debe existir antes de que Golfmanager dé de alta el club en la API de SmartPanel.
El enlace de acceso es individual: hay que generarlo y guardarlo para cada persona; no se comparte entre usuarios.
El enlace se copia manualmente de SmartPanel a Golfmanager; no se sincroniza solo.
Los datos se leen dentro de los límites de peticiones: un volumen alto puede hacer que la actualización tarde más.
SmartPanel muestra lo que hay en Golfmanager: datos incompletos o mal registrados se reflejarán igual en los análisis.
Si se elimina, desactiva o modifica el usuario «Smart Panel», la conexión se interrumpe.
Este artículo cubre la versión v3 de Golfmanager.
Preguntas frecuentes (FAQ)
¿Quién crea el usuario de SmartPanel en Golfmanager?
El club, desde Configuración > Sistema > Usuarios, con los datos indicados en el paso A. Después, el equipo de Golfmanager le asigna la API key.
¿Tengo que introducir yo la API key?
No. La API key la copia y asigna el equipo de Golfmanager desde Superadmin. El club solo tiene que crear el usuario y avisar.
¿Por qué el usuario debe ser de tipo Administrador?
Para que SmartPanel pueda leer toda la información necesaria (clientes, reservas, ventas…). Con menos permisos, los cuadros de mando quedarían incompletos.
Los datos de SmartPanel no se actualizan. ¿Qué reviso?
Comprueba que el usuario «Smart Panel» sigue activo, conserva la API key y tiene los límites correctos. Si todo está bien, contacta con el soporte de SmartPanel.
¿Puedo usar el usuario «Smart Panel» para entrar en Golfmanager?
No. Es un usuario técnico para la conexión entre sistemas. Para trabajar en Golfmanager usa tu propio usuario.
¿Cómo accedo a los cuadros de mando?
Con el acceso directo guardado en el campo «URL de SmartPanel» de tu ficha de usuario en Golfmanager. Si aún no lo tienes, sigue los pasos de Acceso directo a SmartPanel desde Golfmanager.
¿Dónde está el campo «URL de SmartPanel»?
En la ficha del usuario (Configuración > Sistema > Usuarios), sección General. Para modificarlo, pulsa Editar en la parte superior de la ficha.
¿Tengo que generar un enlace para cada usuario?
Sí. El enlace es personal: se genera en la edición de cada usuario en SmartPanel y se guarda en la ficha de esa misma persona en Golfmanager.
El enlace no abre SmartPanel. ¿Qué hago?
Lo más habitual es que el enlace esté incompleto (falta el token o los parámetros finales) o tenga espacios o saltos de línea. Vuelve a copiarlo con el icono «Copiar al portapapeles», pégalo sustituyendo el valor anterior y guarda.
El enlace abre SmartPanel con otro usuario. ¿Por qué?
Se han mezclado usuarios: el enlace pegado pertenece a otra persona. Genera el enlace desde la edición del usuario correcto en SmartPanel y sustitúyelo en su ficha de Golfmanager.
Tenemos varios clubes. ¿Hay que hacer algo especial?
Cada club (tenant) debe crear su usuario «Smart Panel». El equipo de Golfmanager añade cada tenant a la API de SmartPanel y ajusta los límites multiplicándolos por el número de tenants.
¿Qué pasa si borro o desactivo el usuario de SmartPanel?
SmartPanel deja de recibir datos del club. Para restablecerlo, vuelve a crear el usuario y pide al equipo de Golfmanager que le asigne de nuevo la API key.
¿Puedo cambiar los límites de peticiones?
No es recomendable hacerlo sin consultarlo. Los valores indicados (1.000/hora y 30/minuto) están pensados para equilibrar la actualización de datos y el rendimiento del club.
¿Con quién hablo para contratar SmartPanel?
Consulta el apartado Datos de contacto.
Buenas prácticas recomendadas
Respeta los datos indicados (nombre, email, tipo y límites) al crear el usuario.
No compartas la API key ni la reutilices en otros usuarios.
No uses el usuario técnico para trabajar en Golfmanager.
Copia el enlace con el icono «Copiar al portapapeles» para no dejar fuera el token ni los parámetros finales.
Comprueba que es la misma persona en SmartPanel y en Golfmanager antes de pegar el enlace.
Prueba el acceso después de guardar cada enlace.
Mantén los datos de Golfmanager limpios (fichas de cliente, consentimientos, productos) para obtener análisis y campañas fiables.
Avisa a Golfmanager antes de modificar o eliminar el usuario «Smart Panel».
Datos de contacto
Soporte: support@smartpanel.com
Contratación: Antonio Conde — aconde@golfmanager.com