Agents
Connectez votre agent IA à VillaSlot et gérez vos annonces de villas et vos réservations par la conversation. Le skill VillaSlot apprend à l’agent à utiliser l’API : trouver un créneau disponible, modifier les tarifs d’une villa, créer un client ou gérer une réservation.
Votre agent travaille sur les mêmes données d’organisation que l’application. Son accès est limité par l’organisation et les permissions attachées à votre clé API.
Choisir votre agent
| Agent | Guide d’installation | Exemple d’usage |
|---|---|---|
| Claude Code | Connecter Claude Code à VillaSlot | Trouver des villas disponibles et préparer une réservation à partir d’une demande client |
| Codex | Connecter Codex à VillaSlot | Passer en revue les annonces de villas et préparer un import de clients |
| OpenClaw | Connecter OpenClaw à VillaSlot | Préparer un résumé quotidien des réservations à venir |
| Hermes | Connecter Hermes à VillaSlot | Vérifier les horaires d’ouverture et proposer des changements de grille tarifaire |
Installer le skill VillaSlot
Lancez cette commande dans votre terminal, depuis l’espace de travail que vous utilisez avec votre agent. Node.js et npm doivent être disponibles pour exécuter npx.
npx skills add https://github.com/mikecodeur/skills --skill villaslotSuivez l’installateur pour choisir votre agent et la portée de l’installation. Installer le skill fournit des instructions ; cela ne donne aucun accès à votre compte VillaSlot.
Générer une clé API
- Connectez-vous à VillaSlot et ouvrez Compte → Clés API.
- Créez une clé pour l’organisation dont l’agent doit gérer les villas.
- Conservez la clé en lieu sûr et rendez-la disponible pour l’agent sous le nom
VILLASLOT_API_KEY. - Donnez à
VILLASLOT_BASE_URLla valeurhttps://www.villaslot.io.
Gardez la clé hors du contrôle de version et des prompts publics. C’est une clé API VillaSlot, distincte des identifiants de votre compte Claude ou OpenAI. L’environnement d’exécution de l’agent doit pouvoir lire la variable et faire des requêtes HTTPS.
Demandez à l’agent de commencer par lire le contexte du compte :
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.Cette première lecture vous permet de vérifier l’organisation avant de demander à l’agent de faire des modifications.
Ce que votre agent peut gérer
- Annonces de villas : lister les villas, créer ou renommer une villa, téléverser une photo et archiver une villa.
- Disponibilités : lire les horaires d’ouverture et les durées tarifées, puis trouver des créneaux libres.
- Tarifs : remplacer la grille tarifaire horaire d’une villa et modifier les réglages de réservation.
- Clients : trouver ou créer des fiches, corriger des coordonnées et importer des lots de clients.
- Réservations : créer des réservations à l’heure, les confirmer, les déplacer, les marquer terminées ou les annuler.
Les permissions de propriétaire ou d’administrateur sont nécessaires pour modifier les villas et les réglages de réservation. Les membres de l’organisation peuvent gérer les clients et les réservations dans la limite de leurs permissions existantes.
L’API n’expose pas toutes les fonctionnalités de l’application. L’enregistrement des paiements, l’encaissement et le remboursement Stripe, la création de réservations à la nuitée et le réordonnancement des médias se font dans l’application. Confirmer une réservation ne la marque pas comme payée.
Garder le contrôle des modifications
Donnez à l’agent la villa visée, les dates et l’opération. Pour un import, demandez-lui de montrer les fiches sans correspondance avant d’écrire. Pour une modification de tarifs ou d’horaires, demandez-lui de conserver les entrées que vous n’avez pas demandé de supprimer : ces opérations de l’API remplacent toute la collection.
Vous pouvez révoquer la clé API depuis votre compte quand l’intégration n’est plus utile. Consultez la référence de l’API pour les permissions des endpoints, les limites et les réponses d’erreur.