Introducción
Claude es un asistente de inteligencia artificial. Si lo conectas a tu cuenta de Kunas, puedes preguntarle en lenguaje simple por tus reservas, tu ocupación o tus ingresos, y él consulta tus datos reales y te los explica. No necesitas saber de reportes ni de filtros.
Importante: por ahora Kunas no tiene un conector automático para Claude. Por eso la conexión se hace con tu usuario, tu contraseña y el token de Kunas, y debes repetirla cada vez que abras una conversación nueva con Claude. La configuración del Paso 1 se hace una sola vez.
Antes de empezar
Una cuenta de Claude en claude.ai o en la app de escritorio.
Tu usuario y contraseña de Kunas (los mismos con los que entras a app.kunas.io).
El token de Kunas: fb7c874dde4c05b017cd50ef5d868ad2bba96aca
El archivo con la documentación de la API de Kunas: (Descárguelo aqui: OPEN API )
Paso 1. Permite el acceso a Kunas en Claude (Solo una vez)
En Claude, haz clic en tu perfil y entra a Configuración.
Abre la sección Capacidades.
En "Ejecución de código y creación de archivos", activa la opción y activa también "Permitir salida de red".
En "Dominios adicionales permitidos", escribe: app.hotelsync.com y haz clic en Añadir.
Si usas un plan Team o Enterprise, esto lo configura el propietario de la organización en Configuración de la organización > Capacidades.
Paso 2. Conecta tu cuenta (cada vez que abras una conversación nueva)
Abre una conversación nueva en Claude.
Adjunta el archivo de documentación de la API que descargaste.
Copia y pega este mensaje, reemplazando tu usuario y tu contraseña:
Conéctate a la API de Kunas en https://app.hotelsync.com usando el archivo adjunto como documentación.
Token: fb7c874dde4c05b017cd50ef5d868ad2bba96aca
Usuario: [Tu Usuario en Kunas]
Contraseña: [Tu Contraseña en Kunas]
Primero inicia sesión con POST /api/user/auth/login enviando token, username y password en JSON, y guarda la clave de sesión (pkey). En las demás llamadas envía token, key (el pkey) e id_properties en el cuerpo JSON. Si recibes el error 401, vuelve a iniciar sesión. Haz solo consultas: no crees, modifiques ni elimines nada. Dime qué propiedades tengo y espera mi pregunta.
4. Claude responderá con la lista de tus propiedades. Si lo hace, ya estás conectado.
Paso 3. Has tus preguntas
Qué puedes consultar:
Reservas futuras, llegadas y salidas de hoy o de la semana.
Detalle de una reserva: huésped, fechas, canal y valor.
Disponibilidad, precios y restricciones por fechas.
Datos de huéspedes y estado de los pagos.
Qué puedes analizar:
Ocupación del mes comparada con el mes anterior.
Ingresos por canal (Airbnb, Booking.com, motor de reservas).
Cancelaciones: cuántas hubo y de qué canal.
Duración promedio de las estadías y valor promedio por noche.
Fechas con baja ocupación donde podrías ajustar precios o lanzar una promoción.
Explicación de tus informes en palabras simples.
Ejemplos de preguntas:
"¿Cuántas reservas futuras tengo en [nombre de la propiedad]?"
"¿Qué llegadas / salidas tengo mañana?"
"Compara mi ocupación de septiembre con la de agosto y explícame por qué cambió."
"¿Qué canal me trae más ingresos?"
"Dame tres ideas para llenar las fechas libres de noviembre."
Nota: Si deseas realizar acciones distintas a consultar, como modificar Tarifas y Disponibilidad te recomendamos esta guía: ¿Cómo modificar Tarifas y Disponibilidad con Claude?
Consejos
Indica siempre la propiedad y el rango de fechas.
Si Claude te pide más datos o dice que la sesión venció, pega de nuevo el mensaje del Paso 2.
Pídele que te responda en una tabla o en un resumen corto.
Verifica los datos importantes en Kunas antes de tomar decisiones.
Seguridad
Al pegar tu contraseña en el chat, Claude la usa para iniciar sesión por ti. No compartas esa conversación con nadie.
Lo ideal es usar un usuario de Kunas creado solo para esto, con los permisos que necesites.
Claude solo ve lo que tu usuario tiene permiso de ver.
Si cambias tu contraseña, usa la nueva en el mensaje del Paso 2.
¿Necesitas ayuda?
Escríbenos a [email protected] o agenda una sesión con un especialista en kunas.io/agenda-soporte.