Agentes
Conecta tu agente de IA a VillaSlot y gestiona tus anuncios de villas y tus reservas conversando. El skill VillaSlot enseña al agente a usar la API: encontrar una franja disponible, cambiar las tarifas de una villa, crear un cliente o gestionar una reserva.
Tu agente trabaja con los mismos datos de organización que la aplicación. Su acceso está limitado por la organización y los permisos asociados a tu clave API.
Elige tu agente
| Agente | Guía de instalación | Ejemplo de uso |
|---|---|---|
| Claude Code | Conectar Claude Code a VillaSlot | Encontrar villas disponibles y preparar una reserva a partir de la petición de un cliente |
| Codex | Conectar Codex a VillaSlot | Revisar los anuncios de villas y preparar una importación de clientes |
| OpenClaw | Conectar OpenClaw a VillaSlot | Preparar un resumen diario de las próximas reservas |
| Hermes | Conectar Hermes a VillaSlot | Revisar el horario de apertura y proponer cambios en la cuadrícula de tarifas |
Instalar el skill VillaSlot
Ejecuta este comando en tu terminal, desde el espacio de trabajo que usas con tu agente. Necesitas Node.js y npm disponibles para ejecutar npx.
npx skills add https://github.com/mikecodeur/skills --skill villaslotSigue el instalador para elegir tu agente y el alcance de la instalación. Instalar el skill aporta instrucciones; no da ningún acceso a tu cuenta de VillaSlot.
Generar una clave API
- Inicia sesión en VillaSlot y abre Cuenta → Claves API.
- Crea una clave para la organización cuyas villas debe gestionar el agente.
- Guarda la clave en un lugar seguro y ponla a disposición del agente como
VILLASLOT_API_KEY. - Da a
VILLASLOT_BASE_URLel valorhttps://www.villaslot.io.
Mantén la clave fuera del control de versiones y de los prompts públicos. Es una clave API de VillaSlot, distinta de las credenciales de tu cuenta de Claude u OpenAI. El entorno de ejecución del agente debe poder leer la variable y hacer peticiones HTTPS.
Pide al agente que empiece leyendo el contexto de la cuenta:
Use the villaslot skill. Read my VillaSlot organization context and list
my active villas. Tell me which organization and timezone you are using.
Do not change anything yet.Esta primera lectura te permite comprobar la organización antes de pedir al agente que haga cambios.
Qué puede gestionar tu agente
- Anuncios de villas: listar las villas, crear o renombrar una villa, subir una foto y archivar una villa.
- Disponibilidad: leer el horario de apertura y las duraciones con precio, y luego encontrar franjas libres.
- Tarifas: reemplazar la cuadrícula de tarifas por hora de una villa y modificar las reglas de reserva.
- Clientes: buscar o crear fichas, corregir datos de contacto e importar lotes de clientes.
- Reservas: crear reservas por horas, confirmarlas, moverlas, marcarlas como completadas o cancelarlas.
Se necesitan permisos de propietario o administrador para modificar las villas y las reglas de reserva. Los miembros de la organización pueden gestionar clientes y reservas dentro de sus permisos actuales.
La API no expone todas las funciones de la aplicación. El registro de pagos, el cobro y los reembolsos con Stripe, la creación de estancias por noches y la reordenación de los medios se hacen en la aplicación. Confirmar una reserva no la marca como pagada.
Mantener el control de los cambios
Indica al agente la villa, las fechas y la operación. Para una importación, pídele que muestre las fichas sin coincidencia antes de escribir. Para un cambio de tarifas o de horario, pídele que conserve las entradas que no has pedido eliminar: estas operaciones de la API reemplazan la colección completa.
Puedes revocar la clave API desde tu cuenta cuando la integración ya no sea necesaria. Consulta la referencia de la API para los permisos de los endpoints, los límites y las respuestas de error.