Connectez Claude Code, Codex, OpenClaw ou Hermes à VillaSlot pour consulter vos villas, vérifier les disponibilités et gérer vos réservations avec une clé API.
Un client cherche une villa pour un shooting de deux heures. Avant de lui répondre, vous devez retrouver les disponibilités, vérifier le tarif et vous assurer que le créneau laisse assez de temps pour préparer le lieu. Ces informations existent déjà dans VillaSlot. Un agent IA peut les consulter pour vous et préparer la suite à partir de votre demande.
Le point de départ tient en deux éléments : le skill VillaSlot et une clé API de votre organisation. Le skill explique à l’agent comment utiliser l’application. La clé lui donne accès à vos données, avec vos permissions.
L’agent travaille sur les fiches de villas et les réservations de VillaSlot. Il ne publie pas automatiquement vos annonces sur Airbnb ou d’autres plateformes.
| Votre demande | Ce que l’agent peut faire dans VillaSlot |
|---|---|
| « Montre-moi mes villas » | Lister les lieux et consulter leurs informations |
| « Mets à jour cette annonce » | Renommer une villa ou ajouter une photo |
| « Quels créneaux sont libres ? » | Lire les horaires, les durées tarifées et les disponibilités |
| « Prépare cette réservation » | Retrouver le client et créer une réservation horaire selon vos instructions |
| « Le client veut décaler » | Vérifier un autre créneau et déplacer la réservation |
| « Voici mon fichier clients » | Préparer puis importer les fiches clients autorisées |
La création ou la modification des villas et des tarifs nécessite un rôle owner ou admin. Un membre conserve les opérations clients et réservations que ses permissions lui permettent.
Dans le terminal de l’environnement où votre agent travaille, lancez :
npx skills add https://github.com/mikecodeur/skills --skill villaslotChoisissez votre agent dans l’installateur. Les guides détaillés sont disponibles pour Claude Code, Codex, OpenClaw et Hermes. La documentation des agents est en anglais.
Si votre agent tourne sur un serveur, installez le skill sur ce serveur. Une installation sur votre ordinateur ne configure pas automatiquement un environnement distant.
Connectez-vous à VillaSlot, puis ouvrez Compte → Clés API. Créez une clé pour l’organisation dont vous souhaitez gérer les villas.
Rendez cette clé accessible à l’environnement de votre agent sous le nom VILLASLOT_API_KEY. Définissez également l’adresse du service :
export VILLASLOT_BASE_URL="https://www.villaslot.io"Avant de demander une modification, vérifiez que l’agent a accès à la bonne organisation :
Utilise le skill villaslot et la clé API de ton environnement.
Indique le nom de mon organisation et son fuseau horaire, puis liste
mes villas actives avec leurs durées tarifées. Ne modifie rien.Cette première demande permet de contrôler le contexte. L’agent doit utiliser le fuseau horaire de l’organisation pour les créneaux, même si votre ordinateur se trouve dans un autre pays.
Donnez une date précise, une durée et le lieu souhaité :
Cherche un créneau de deux heures à Garden Villa le 20 octobre 2026,
après 10 h dans le fuseau de l’organisation. Présente les disponibilités
et le prix. Attends mon choix avant de créer la réservation.Une fois le créneau choisi, demandez à l’agent de retrouver le client ou de créer sa fiche, puis indiquez si la réservation doit être provisoire ou confirmée. Une réservation provisoire peut déjà bloquer le créneau : ce n’est pas un simple brouillon de conversation.
Le serveur vérifie à nouveau la disponibilité au moment de la création. Si quelqu’un réserve entre-temps, l’agent doit vous proposer une autre option plutôt que répéter la même tentative.
Pour changer un prix, précisez ce qui doit être conservé :
Lis la grille complète de Garden Villa. Prépare le tarif de deux heures
à 1 500 000 IDR, conserve toutes les autres durées et montre-moi la grille
avant de l’enregistrer.L’API remplace la grille entière. La même logique s’applique aux horaires d’ouverture : omettre un jour le ferme. Une instruction précise évite qu’une petite modification retire des données utiles.
L’API actuelle ne permet pas d’enregistrer un paiement manuel, d’encaisser via Stripe, de rembourser ou de créer une réservation de nuitée. Confirmer une réservation ne la rend pas payée. Ces opérations restent disponibles dans les parcours concernés de l’application.
Pour un import, demandez un bilan des correspondances et des lignes refusées. L’agent doit conserver les identifiants créés afin d’éviter les doublons après une interruption. Il n’existe pas de paramètre API pour désactiver les emails : si l’import doit être silencieux, configurez d’abord les réglages d’envoi dans l’application.
Commencez par une tâche que vous connaissez bien : consulter les réservations de demain ou vérifier les disponibilités d’une villa. Comparez le résultat à votre calendrier, puis élargissez progressivement les opérations confiées à l’agent.
Le guide Agents réunit l’installation et les exemples de connexion. Vous gardez les mêmes villas, les mêmes clients et les mêmes règles ; l’agent devient une autre façon de travailler avec votre organisation.