Comment gérer vos annonces de villa avec un agent IA

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.

Ce que l’agent peut faire

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.

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.

1. Installer le skill VillaSlot

Dans le terminal de l’environnement où votre agent travaille, lancez :

npx skills add https://github.com/mikecodeur/skills --skill villaslot

Choisissez 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.

2. Générer une clé API

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"

3. Commencer par une lecture

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.

4. Passer d’une demande client à une réservation

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.

Modifier les tarifs sans perdre le reste de la grille

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.

Ce qui reste dans l’application

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.

Un premier usage simple

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.