Índice
ℹ️ Importante: CourseRev no es un módulo dentro de Golfmanager. Es un sistema externo que se conecta con Golfmanager a través de su API pública. Por eso no se "instala": se activa generando una clave de API y entregándosela a CourseRev.
¿Qué es esta integración?
CourseRev es un asistente de reservas por teléfono (voz/IA): atiende las llamadas de los jugadores y gestiona sus salidas (tee times) automáticamente. La integración consiste en que CourseRev se conecta con Golfmanager mediante su API pública para consultar la disponibilidad real y crear las reservas directamente en Golfmanager.
Así, una reserva hecha por teléfono a través de CourseRev aparece en Golfmanager como cualquier otra, en tiempo real y sin que nadie tenga que pasarla a mano.
¿Qué problema resuelve?
Atiende reservas por teléfono sin ocupar a recepción, incluso fuera de horario.
Usa la disponibilidad real de Golfmanager: no hay dobles reservas ni descuadres de agenda.
Las reservas entran solas en Golfmanager, sin teclearlas dos veces.
Mejora la experiencia del jugador y libera tiempo del personal.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta CourseRev con la API de Golfmanager, en tiempo real y en ambos sentidos:
CourseRev pregunta a Golfmanager qué salidas hay disponibles para una fecha y un número de jugadores.
Golfmanager responde con los huecos libres y sus precios.
CourseRev crea la reserva (y, si hace falta, da de alta o localiza al cliente) en Golfmanager.
Golfmanager confirma la reserva, que queda registrada como cualquier otra.
Golfmanager es siempre el sistema de referencia: la agenda y las reglas de reserva las manda Golfmanager; CourseRev solo consulta y crea a través de la API.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Fecha, campo/área y nº de jugadores | CourseRev → Golfmanager | Consultar la disponibilidad |
Salidas libres y precios | Golfmanager → CourseRev | Ofrecer las horas al jugador |
Datos del jugador (nombre, teléfono, email) | CourseRev → Golfmanager | Localizar o dar de alta al cliente |
Reserva a crear (hora, tipo, jugadores) | CourseRev → Golfmanager | Crear la reserva |
Confirmación de la reserva | Golfmanager → CourseRev | Confirmar al jugador |
Requisitos previos (antes de activar la integración)
Tener contratado CourseRev y haber acordado con ellos la puesta en marcha.
Tener el módulo de Reservas activo en Golfmanager, con los campos/áreas y reglas de reserva configurados.
Una clave de API de Golfmanager (la genera un administrador; ver más abajo).
El nombre del tenant (el identificador de tu club en Golfmanager) y la dirección (URL) de tu Golfmanager.
Permisos de administrador de sistema para generar la clave de API.
Cómo se configura (paso a paso)
La configuración consiste en generar una clave de API en Golfmanager, vincularla a tu club y a un usuario, y entregar los datos a CourseRev.
Paso 1 — Generar la clave de API
En la administración de Golfmanager, ve a API V3 > Claves de API.
Crea una nueva clave.
En Nombre, ponle un nombre identificativo (por ejemplo,
CourseRev).Opcionalmente, define los límites de uso: Peticiones por minuto y Peticiones por hora (déjalos vacíos para sin límite).
Guarda. Golfmanager genera una clave larga automáticamente. Cópiala en ese momento: por seguridad, solo se muestra al crearla.
Paso 2 — Vincular la clave a tu club y a un usuario
En la ficha de la clave, vincúlala a tu tenant (tu club).
Indica el usuario cuyos permisos usará CourseRev al operar (es lo que controla qué puede hacer la integración: reservas y clientes).
Guarda.
Paso 3 — Entregar los datos a CourseRev
Facilita a CourseRev la clave de API.
Facilita el nombre del tenant (tu club).
Facilita la URL de tu Golfmanager.
🔒 Trata la clave de API como una contraseña: da acceso a tus datos de reservas y clientes. Compártela solo con CourseRev por un canal seguro y, si se ve comprometida, genera una nueva y elimina la anterior.
Detalle de cada campo de la clave de API
A continuación se explica cada campo de la clave de API (en API V3 > Claves de API): qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso.
Nombre
Nombre del campo: Nombre.
Descripción: un nombre identificativo para la clave, para reconocerla en el listado.
Impacto en el sistema: no afecta a la conexión; sirve para que tú sepas para qué es cada clave.
Comportamiento del sistema: es obligatorio. Aparece en el listado de claves.
Ejemplo de uso / qué ocurre: pones
CourseRev; así, si en el futuro tienes varias integraciones, identificas de un vistazo cuál es la de CourseRev y puedes revocarla sin tocar las demás.
Clave de API
Nombre del campo: la clave de API (el código largo que se genera).
Descripción: el código secreto (de unos 80 caracteres) que autentica a CourseRev ante Golfmanager.
Impacto en el sistema: es la "contraseña" de la integración. Quien la tenga puede operar contra tu Golfmanager con los permisos del usuario vinculado.
Comportamiento del sistema: se genera automáticamente al guardar y solo se muestra una vez (al crearla). Después queda oculta y no se puede volver a ver.
Ejemplo de uso / qué ocurre: al crear la clave, la copias y se la das a CourseRev. Si la pierdes, no podrás recuperarla: tendrás que generar una nueva.
Peticiones por minuto
Nombre del campo: Peticiones por minuto.
Descripción: el número máximo de peticiones que la clave puede hacer en un minuto.
Impacto en el sistema: protege tu Golfmanager de un uso excesivo. Si se supera, las peticiones se rechazan temporalmente con un error de "límite excedido".
Comportamiento del sistema: si lo dejas vacío (o en 0), no hay límite por minuto. Si pones un número, se cuenta el uso por ventanas de un minuto.
Ejemplo de uso / qué ocurre: normalmente no necesitas tocarlo. Si CourseRev te indica un límite concreto, lo configuras aquí.
Peticiones por hora
Nombre del campo: Peticiones por hora.
Descripción: el número máximo de peticiones que la clave puede hacer en una hora.
Impacto en el sistema: igual que el límite por minuto, pero en ventana de una hora.
Comportamiento del sistema: vacío (o 0) = sin límite por hora.
Ejemplo de uso / qué ocurre: lo dejas vacío salvo que quieras (o CourseRev pida) acotar el volumen de llamadas a la API.
Tenant (club vinculado)
Nombre del campo: tenant (la vinculación de la clave a tu club).
Descripción: el identificador de tu club en Golfmanager, al que apunta la clave.
Impacto en el sistema: dirige las peticiones a la base de datos de tu club. Cada petición de CourseRev indica este tenant en una cabecera.
Comportamiento del sistema: sin el tenant correcto, las peticiones no saben a qué club aplicarse y fallan.
Ejemplo de uso / qué ocurre: vinculas la clave a tu club y le das ese mismo nombre de tenant a CourseRev.
Usuario (permisos)
Nombre del campo: usuario (el usuario vinculado a la clave en tu club).
Descripción: el usuario de Golfmanager cuyos permisos se aplican cuando CourseRev opera con la clave.
Impacto en el sistema: es lo que controla qué puede hacer CourseRev. La integración solo podrá hacer lo que ese usuario tenga permitido (consultar disponibilidad, crear reservas, gestionar clientes).
Comportamiento del sistema: si el usuario está desactivado o no tiene un permiso, esa acción de CourseRev fallará.
Ejemplo de uso / qué ocurre: vinculas un usuario con los permisos justos de reservas y clientes; así CourseRev hace lo necesario, ni más ni menos.
Cómo funciona en el día a día
Una vez configurado, no hay que hacer nada en el club: el proceso es automático.
El jugador llama por teléfono y CourseRev atiende.
CourseRev consulta la disponibilidad en Golfmanager según la fecha y el número de jugadores.
Ofrece las horas libres y el jugador elige.
CourseRev localiza o da de alta al cliente y crea la reserva en Golfmanager.
La reserva aparece en Golfmanager en tiempo real, igual que una reserva hecha por recepción o por el portal online.
Las reservas creadas por CourseRev se pueden ver, modificar o cancelar en Golfmanager como cualquier otra. CourseRev respeta siempre la disponibilidad y las reglas de reserva del club.
Qué usa de la API (referencia técnica)
Esta sección es para el equipo técnico de CourseRev. Las peticiones se autentican con las cabeceras key (la clave de API) y tenant (tu club). Los principales endpoints de reservas son:
Acción | Endpoint |
Consultar disponibilidad de salidas |
|
Crear reserva(s) |
|
Cancelar reserva(s) |
|
Buscar / crear / editar clientes |
|
📖 La especificación completa y actualizada (parámetros exactos de cada endpoint, formatos y ejemplos) está en la documentación integrada de la API: /api/doc, con un entorno de pruebas en /api/playground. Es la fuente de referencia que debe seguir el equipo de CourseRev. (En el playground, la clave se borra tras 60 minutos de inactividad por seguridad.)
Limitaciones a tener en cuenta
No es un módulo de Golfmanager: es un servicio externo que se conecta por API. La calidad de la experiencia depende también de CourseRev.
Respeta las reglas de Golfmanager: CourseRev solo puede reservar lo que la disponibilidad y las reglas del club permiten; conviene tenerlas bien configuradas.
Depende de la clave de API: si eliminas la clave o desactivas el usuario vinculado, CourseRev deja de poder reservar.
La clave solo se muestra una vez: al crearla. Si la pierdes, hay que generar una nueva.
La clave no caduca por fecha: sigue siendo válida hasta que la elimines o se desactive el usuario. Si sospechas que se ha filtrado, genera una nueva.
Puede haber límites de uso (peticiones por minuto/hora) si los has configurado en la clave.
Los permisos los marca el usuario asignado a la clave: CourseRev hará solo lo que ese usuario tenga permitido.
Preguntas frecuentes
¿CourseRev es un módulo que se instala en Golfmanager?
No. CourseRev es un sistema externo que se conecta a Golfmanager por su API pública. No se instala nada: la integración se activa generando una clave de API y entregándosela a CourseRev.
¿Cómo se activa la integración?
En tres pasos: (1) generas una clave de API en API V3 > Claves de API, (2) la vinculas a tu club y a un usuario, y (3) le das a CourseRev la clave, el tenant (tu club) y la URL de tu Golfmanager.
¿Tengo que programar o configurar algo más?
No. La parte técnica (cómo llama a la API) la hace CourseRev. Tú solo generas la clave, la vinculas y entregas los datos. El resto es automático.
Las reservas hechas por teléfono, ¿aparecen en Golfmanager?
Sí, en tiempo real y como cualquier otra reserva (igual que las de recepción o las del portal online). Las puedes ver, modificar y cancelar con normalidad.
¿Qué datos necesita CourseRev de mí?
Tres: la clave de API, el nombre del tenant (el identificador de tu club) y la URL de tu Golfmanager.
¿Qué es el "tenant"?
Es el identificador de tu club en Golfmanager. Las peticiones de la API lo indican en una cabecera para saber a qué club aplicarse. Tiene que coincidir con el que has vinculado a la clave.
¿La clave de API se puede volver a ver después de crearla?
No. La clave solo se muestra una vez, en el momento de crearla. Cópiala y guárdala en lugar seguro. Si la pierdes, tendrás que generar una nueva y entregársela a CourseRev.
He perdido la clave. ¿Qué hago?
Genera una clave nueva en API V3 > Claves de API, entrégasela a CourseRev y elimina la antigua cuando la nueva esté funcionando.
¿Cómo controlo qué puede hacer CourseRev en mi Golfmanager?
A través de los permisos del usuario vinculado a la clave. CourseRev solo podrá hacer lo que ese usuario tenga permitido (consultar disponibilidad, crear reservas, gestionar clientes). Asígnale un usuario con los permisos justos.
¿Puedo limitar el número de peticiones de CourseRev?
Sí. En la clave puedes fijar un máximo de peticiones por minuto y por hora. Si los dejas vacíos, no hay límite. Normalmente no hace falta tocarlos salvo que CourseRev te indique un valor.
CourseRev recibe el error "Rate Limit Exceeded". ¿Qué significa?
Significa que se ha superado el límite de peticiones que has configurado en la clave (por minuto o por hora). El mensaje indica el contador, el máximo y la ventana. Espera un poco o amplía/quita los límites de la clave de API.
CourseRev no puede conectarse o da un error de autenticación. ¿Qué reviso?
Comprueba los tres datos: la clave de API, el tenant (tu club) y la URL. Si dudas, genera una clave nueva y vuelve a entregarla. Mensajes habituales: "Clave no válida" (la clave es incorrecta o está vacía) y "Se requiere el tenant" (falta el identificador del club).
Sale "Se requiere el tenant" o "Clave no válida". ¿Qué pasa?
"Se requiere el tenant" quiere decir que la petición no incluye tu club; revisa que CourseRev envía el tenant correcto. "Clave no válida" quiere decir que la clave es incorrecta o no se está enviando; revisa la clave o genera una nueva.
No aparece disponibilidad para reservar. ¿Por qué?
Porque no hay huecos libres según la agenda o las reglas del club para esa fecha, área y número de jugadores. Revisa la configuración de reservas (horarios, reglas, campo/área) en Golfmanager.
CourseRev reserva, pero no puede hacer algo concreto. ¿Qué pasa?
Probablemente el usuario vinculado a la clave no tiene ese permiso. Revisa los permisos de ese usuario y añádele los que necesite (o quítaselos si no quieres que CourseRev haga algo).
Una reserva no aparece en Golfmanager. ¿Qué reviso?
Confirma que la clave apunta al club correcto (el tenant) y que la creación no devolvió error. El equipo de CourseRev puede revisar la respuesta de la API para ver qué ocurrió.
¿La clave de API caduca?
No caduca por una fecha. Sigue siendo válida hasta que la elimines o se desactive el usuario vinculado. Por seguridad, conviene rotarla si sospechas que se ha filtrado.
¿CourseRev puede saltarse las reglas de reserva del club?
No. CourseRev solo puede reservar lo que la disponibilidad y las reglas de Golfmanager permiten. Golfmanager es siempre el sistema de referencia; por eso conviene tener bien configuradas las reglas de reserva.
¿Dónde está la documentación técnica de la API para CourseRev?
En la propia plataforma: la documentación integrada está en /api/doc y hay un entorno de pruebas en /api/playground. Es la referencia que debe seguir el equipo técnico de CourseRev.
¿Qué permisos necesito para crear la clave de API?
Permisos de administrador de sistema. Son los necesarios para acceder a API V3 > Claves de API y generar y vincular la clave.
¿Cómo revoco el acceso de CourseRev?
Eliminando la clave de API de CourseRev (o desactivando el usuario vinculado). A partir de ese momento, CourseRev deja de poder consultar y reservar.
¿La clave da acceso a todos mis datos?
La clave da acceso a lo que permita el usuario vinculado; por eso conviene asignarle solo los permisos necesarios. Aun así, trátala como una contraseña: compártela solo con CourseRev por un canal seguro.
¿Puedo usar la misma clave para CourseRev y para otra integración?
Es mejor usar una clave dedicada para CourseRev. Así, si necesitas revocar su acceso, lo haces sin afectar a otras integraciones.
¿Qué pasa si Golfmanager o CourseRev no están disponibles en un momento dado?
Si la API de Golfmanager no responde, CourseRev no podrá consultar ni reservar durante ese tiempo; cuando se restablezca, vuelve a funcionar. Igualmente, si el servicio de CourseRev falla, las llamadas se atienden según lo que CourseRev tenga previsto. La agenda de Golfmanager sigue siendo siempre la fuente de la verdad.
Buenas prácticas recomendadas
Usa una clave de API dedicada a CourseRev (no la compartas con otras integraciones), para poder revocarla sin afectar a nada más.
Asigna a la clave un usuario con los permisos justos que CourseRev necesita (reservas y clientes), ni más ni menos.
Configura bien las reglas de reserva en Golfmanager: son las que CourseRev respetará.
Haz una reserva de prueba al activar la integración y comprueba que aparece correctamente en Golfmanager.
Guarda la clave en lugar seguro y rótala si sospechas que se ha filtrado.