Connectez Smoobu à Famulor : créez un agent de réservation vocal par IA

Quiconque gère des locations de courte durée via Smoobu connaît bien le scénario : les appels affluent à toute heure. Demandes de disponibilité, réservations de dernière minute, questions sur le statut des séjours en cours. Un agent vocal IA communiquant directement avec l'API Smoobu comble ce fossé. Il vérifie les disponibilités en temps réel, crée des réservations, répond aux questions sur les séjours confirmés et déclenche l'envoi de messages aux clients à la demande. Tout cela en un seul appel, sans aucune intervention humaine.

Ce guide vous explique comment mettre en place un agent vocal Smoobu opérationnel en moins d'une heure grâce à la plateforme d'IA vocale no-code de Famulor. Vous apprendrez quels endpoints Smoobu sont essentiels, comment configurer les outils d'appel Famulor dans le tableau de bord et comment instruire l'agent via le prompt système pour qu'il sollicite ces outils au moment opportun. Le même agent pourra ensuite être déployé sur téléphone, chat web et WhatsApp avec une configuration identique.

Qu'est-ce que Smoobu et pourquoi est-ce un pilier idéal pour l'IA vocale ?

Smoobu est un système de gestion immobilière basé à Berlin, destiné aux locations de courte durée, aux hôtels de charme et aux appartements avec services. Il synchronise les réservations provenant d'Airbnb, Booking.com, Vrbo et de votre propre site de réservation directe dans un calendrier unifié. Ce qui rend Smoobu particulièrement attractif pour l'IA vocale : une API REST entièrement documentée avec authentification OAuth et clé API, une limite de 1 000 requêtes par minute et des endpoints qui correspondent précisément aux questions posées par les appelants.

Les intentions typiques des appelants qu'un agent vocal peut résoudre via l'API Smoobu : vérifier la disponibilité sur une période, obtenir un prix, créer une réservation, consulter le statut d'une réservation existante, envoyer un message au client. Chacune de ces actions correspond à un endpoint documenté de Smoobu, ce qui constitue exactement le cas d'usage pour lequel l'architecture des outils d'appel de Famulor a été conçue.

Comment fonctionnent les outils d'appel dans Famulor

Famulor distingue les connaissances statiques (PDF, URL, FAQ) des outils d'appel dynamiques. Ces derniers sont des requêtes HTTP que l'agent IA exécute en temps réel pendant la conversation. L'agent extrait les paramètres nécessaires de l'appel, interroge l'endpoint configuré, attend la réponse JSON et répond à l'appelant en utilisant les données en direct.

Concrètement, un outil d'appel est créé soit via l'API à POST /api/user/tools, soit, plus couramment, directement dans le tableau de bord Famulor sous Mid Call Tools. Pour chaque outil, vous définissez :

• nom : identifiant en snake_case (par exemple check_smoobu_availability) auquel l'agent fait référence en interne.

• description : jusqu'à 255 caractères décrivant quand le modèle doit utiliser cet outil (par exemple « quand l'appelant demande une disponibilité pour une période donnée »).

• endpoint : URL Smoobu comme https://login.smoobu.com/booking/checkApartmentAvailability.

• méthode : GET, POST, PUT, PATCH ou DELETE.

• en-têtes : c'est ici que se trouvent Api-Key: YOUR_KEY et Content-Type: application/json.

• schéma : liste des paramètres que l'IA extrait de la conversation. Chaque élément possède un nom, un type (string/number/boolean) et une description aidant le modèle à identifier la valeur.

• délai d'expiration : 1 à 30 secondes, 10 par défaut (8 secondes est un choix confortable pour Smoobu).

Les descriptions du schéma ne sont pas décoratives. Elles sont le seul signal utilisé par le modèle pour traduire une phrase comme « du 14 au 17 mai pour quatre personnes » en champs structurés. Soyez précis.

Les cinq outils d'appel dont votre agent vocal Smoobu a besoin

En pratique, cinq outils couvrent 90 % des intentions des appelants. Le tableau ci-dessous les résume :

Ajouts optionnels : cancel_smoobu_reservation pour les annulations et get_smoobu_rates pour les recherches de tarifs saisonniers. Même schéma.

Étape 1 - obtenir la clé API Smoobu

Connectez-vous à Smoobu et allez dans Paramètres → API. Générez une clé API personnelle, liée à votre compte. Les scénarios multi-utilisateurs utilisent OAuth 2 en tant que partenaire Smoobu ; pour un hôte unique, la clé personnelle suffit. Notez également les IDs de vos appartements depuis le tableau de bord Smoobu, car l'endpoint de disponibilité les attend sous forme de liste.

Smoobu autorise 1 000 requêtes par minute, bien plus que ce dont un agent vocal aura besoin. Surveillez les en-têtes X-RateLimit-* si vous exécutez également des campagnes sortantes parallèles avec la même clé.

Étape 2 - créer votre premier outil « check_smoobu_availability »

Dans le tableau de bord Famulor, ouvrez Mid Call Tools et cliquez sur « New Tool ». Remplissez :

• Nom : check_smoobu_availability

• Description : « Vérifie la disponibilité Smoobu pour les dates et appartements demandés. N'appeler qu'après que l'appelant a indiqué la date d'arrivée, de départ et le nombre de personnes. »

• Endpoint : https://login.smoobu.com/booking/checkApartmentAvailability

• Méthode : POST

• En-têtes : Api-Key: YOUR_SMOOBU_KEY, Content-Type: application/json

• Schéma :

  • arrival_date (string) - « Date d'arrivée au format yyyy-mm-dd, extraite de la parole de l'appelant »

  • departure_date (string) - « Date de départ au format yyyy-mm-dd »

  • guests (number) - « Nombre de personnes séjournant »

Enregistrez et c'est terminé. Pendant l'appel, le modèle assemble la charge utile JSON à partir des valeurs fournies par l'appelant. Famulor fait correspondre les noms du schéma aux champs exacts de Smoobu (arrivalDate, departureDate, guests) ; vous pouvez aussi utiliser les noms camelCase de Smoobu directement dans votre définition d'outil.

Étape 3 - ajouter les outils de réservation et de recherche

L'outil le plus important est create_smoobu_booking. Smoobu exige des champs comme arrivalDate, departureDate, apartmentId et channelId, ainsi que des coordonnées pour toute réservation sérieuse. Assurez-vous que la description indique explicitement au modèle d'appeler cet outil uniquement après que tous les champs requis ont été confirmés, sinon le modèle a tendance à agir avec trop d'optimisme.

Exemple de description : « Crée une réservation Smoobu. N'appeler qu'après le succès de check_smoobu_availability ET que l'appelant a fourni son prénom, nom, email, téléphone et l'ID de l'appartement choisi. Répétez les données à l'appelant et obtenez une confirmation explicite avant de l'invoquer. »

Le second outil indispensable est get_smoobu_booking pour les questions sur les réservations existantes. Lorsqu'un appelant dit « J'ai déjà réservé mais je ne trouve pas mon numéro de réservation », l'agent peut effectuer une recherche par email ou par code de réservation et répondre avec des données en direct.

Étape 4 - rédiger un prompt système qui déclenche le bon outil

C'est là que la plupart des équipes échouent. Le prompt système doit indiquer au modèle précisément quand un outil doit être déclenché, sinon le modèle décide à l'instinct et appelle soit trop tôt, soit trop tard, soit pas du tout. Une structure fiable :

1. Identité et ton. « Tu es Hannah, assistante virtuelle pour les appartements de vacances Black Forest. Parle de manière brève, amicale et simple. »

2. Règles du domaine. Quels appartements ? Quelles règles saisonnières ? Quel contexte FAQ se trouve dans la base de connaissances ?

3. Règles d'utilisation des outils. Énoncez-les clairement :

   • « Quand l'appelant demande une disponibilité ou un prix, appelle check_smoobu_availability dès que l'arrivée, le départ et le nombre de personnes sont connus. »

   • « Quand l'appelant veut réserver fermement, rassemble tous les champs requis (prénom, nom, email, téléphone, appartement cible), répète-les, obtiens une confirmation explicite, puis appelle create_smoobu_booking. »

   • « Quand l'appelant mentionne une réservation existante et fournit un ID, appelle get_smoobu_booking et relis les champs pertinents. »

   • « Quand l'appelant veut une confirmation par email ou WhatsApp, après une réservation réussie, appelle send_smoobu_message. »

4. Règles d'escalade. Quand passer la main à un humain, généralement pour les plaintes, demandes spéciales ou toute demande humaine explicite.

Cette guidance explicite des outils fait la différence entre un agent qui réserve de manière fiable et un agent qui hallucine. Utilisez les mêmes phrases de déclenchement pour chaque outil afin que le modèle reconnaisse le motif de manière cohérente.

Étape 5 - multi-canal : téléphone, chat web, WhatsApp

L'une des forces de Famulor : le même agent avec les mêmes outils d'appel fonctionne sur tous les canaux. Un appelant qui ne peut pas vous joindre par téléphone envoie un WhatsApp ; l'agent répond avec la même logique et réserve dans le même calendrier Smoobu. Le widget de chat web sur votre site de réservation directe utilise les mêmes outils, transformant chaque visite de page en une réservation réelle plutôt qu'en un labyrinthe de formulaires de contact.

Vous pouvez ajuster le comportement par canal : réponses plus courtes au téléphone, réponses riches en listes dans le chat, liens de confirmation dans WhatsApp. Famulor gère la logique de routage ; vous n'ajustez que le ton par canal, l'intégration Smoobu reste identique. Pour plus d'informations sur l'architecture multi-canal, consultez le guide sur le constructeur de flux omnicanal.

Exemple : appel de 90 secondes, une réservation confirmée

Voici à quoi ressemble un appel réel dans une location de vacances typique à la campagne :

Appelant : Bonjour, avez-vous quelque chose du 22 au 25 mai pour deux adultes et un enfant ?
Agent : Un instant, je vérifie. (appelle check_smoobu_availability avec arrivée 2026-05-22, départ 2026-05-25, personnes 3)
Agent : J'ai deux appartements disponibles - Studio Talblick à 348 euros et Bergwiese à 420 euros, ménage de fin de séjour inclus.
Appelant : Nous prendrons le studio.
Agent : Parfait. Puis-je avoir votre prénom, nom, email et numéro de téléphone ? (collecte les données)
Agent : Pour confirmer : famille Berger, du 22 au 25 mai, Studio Talblick à 348 euros, email b@example.com. Dois-je valider cette réservation ?
Appelant : Oui, s'il vous plaît.
Agent : (appelle create_smoobu_booking, ID 9241 retourné) Réservé, numéro de confirmation 9241. Dois-je vous envoyer la confirmation par mail et WhatsApp ?
Appelant : Les deux, s'il vous plaît.
Agent : (appelle send_smoobu_message) C'est fait, l'email arrivera dans quelques minutes.

90 secondes, une réservation confirmée, un client heureux, sans aucune intervention humaine. La même expérience fonctionne un dimanche à 22h.

Coût de la configuration

L'accès à l'API de Smoobu est inclus dans les plans professionnels, sans frais d'API supplémentaires. Côté Famulor, vous payez des frais de plateforme mensuels plus un tarif à la minute selon la voix et le modèle. Les tarifs sont transparents sur la page de tarification de Famulor. Pour un hôte traitant 50 à 200 appels par mois, le coût mensuel total est bien inférieur à la moitié du coût horaire d'un réceptionniste à temps partiel. Une réservation directe confirmée via votre propre numéro évite également la commission de 15 à 20 % prélevée par une plateforme comme Airbnb ou Booking.com.

Sécurité, RGPD et bonnes pratiques

Trois points sont non négociables dans le contexte des hôtes en UE :

Protection de la clé API. La clé Smoobu doit rester dans l'en-tête Famulor et nulle part ailleurs. Famulor héberge la configuration des outils dans l'UE, la clé est chiffrée au repos et n'apparaît jamais dans les transcriptions d'appels. Renouvelez la clé tous les 6 à 12 mois.

Confirmation avant réservation. Intégrez la confirmation explicite dans la logique de conversation. « Dois-je valider cette réservation ? » n'est pas optionnel. Si vous l'omettez, le modèle finira par transformer une simple demande de renseignement en réservation réelle.

RGPD et enregistrement. Les appelants sont informés de l'enregistrement au début de l'appel. Smoobu stocke déjà les données de réservation de manière conforme à l'UE, Famulor fournit un DPA et un hébergement en UE. La configuration combinée répond aux exigences standard sans ingénierie supplémentaire. Le contexte sur la conformité téléphonique se trouve sur la page du glossaire sur le trunking SIP et dans la section conformité de Famulor.

Extensions à envisager plus tard

Une fois l'agent de base opérationnel, trois extensions apportent une valeur ajoutée considérable. Premièrement, les campagnes sortantes pour les demandes qui n'ont pas abouti à une réservation : l'agent rappelle les clients intéressés ayant rempli un formulaire. Deuxièmement, les appels automatiques avant le séjour, trois jours avant l'arrivée, avec les informations d'enregistrement et des propositions de services additionnels. Troisièmement, les appels après le séjour pour recueillir un avis et intégrer les réponses dans le CRM client.

Ces trois extensions réutilisent la même collection d'outils Smoobu avec une logique sortante supplémentaire dans Famulor. Un coup d'œil au répertoire des intégrations Famulor montre comment les outils CRM, mail et calendrier s'intègrent pour compléter la pile technologique.

Conclusion : l'API alliée à l'IA vocale vous offre un véritable collègue disponible 24h/24 et 7j/7

Smoobu gère la propriété. Famulor gère la conversation. Reliez les deux via des outils d'appel et vous obtenez un agent qui répond en temps réel, réserve fermement et maintient les données du PMS cohérentes. La configuration prend environ une heure. Si vos descriptions d'outils et votre prompt système sont propres, le reste se met en place naturellement. Famulor est le premier choix ici car l'hébergement en UE, la tarification transparente à la minute, le constructeur no-code et l'endpoint dédié aux outils d'appel sont natifs, plutôt que d'être assemblés à partir de composants tiers.

FAQ

Quels plans Smoobu prennent en charge l'API ?

L'accès à l'API est disponible sur les plans professionnels de Smoobu. Trouvez la clé API personnelle sous Paramètres → API. OAuth 2 est réservé aux partenaires officiels Smoobu.

Ai-je besoin de compétences en ingénierie pour configurer cela ?

Non. Les outils d'appel sont configurés dans le tableau de bord Famulor via un formulaire, sans code. Vous saisissez l'endpoint, la méthode, les en-têtes et le schéma, et Famulor gère l'appel à l'exécution.

Comment éviter les doubles réservations ?

Smoobu est la source unique de vérité qui synchronise tous les canaux. Tant que chaque agent vocal n'écrit que via Smoobu, les doubles réservations ne peuvent pas se produire. La règle clé : pas d'accès en écriture directe parallèle depuis d'autres systèmes.

L'agent peut-il appliquer des règles de tarification saisonnière ?

Oui. Smoobu renvoie automatiquement les prix et les restrictions lorsque l'endpoint de disponibilité est appelé. L'agent relit exactement ce que Smoobu a calculé pour cette période, y compris les durées minimales de séjour et les contraintes de jour d'arrivée.

Que se passe-t-il si l'API Smoobu subit une brève interruption ?

Les outils d'appel Famulor ont un délai d'expiration configurable (1-30 secondes). Si l'appel échoue, l'agent peut s'excuser, programmer un rappel et consigner la demande sous forme de tâche dans votre CRM ou par email.

Cela fonctionne-t-il aussi pour d'autres gestionnaires de canaux que Smoobu ?

Oui. Le même modèle s'applique à Hostaway, Lodgify, Guesty ou aux systèmes PMS propriétaires tant qu'une API REST existe. L'endpoint des outils d'appel de Famulor est indépendant du fournisseur.

Quelles langues l'agent vocal comprend-il ?

Famulor prend en charge plus de 40 langues avec une détection automatique au début de l'appel. Les hôtes internationaux en bénéficient particulièrement : l'agent répond dans le même registre de langue que l'appelant.

Comment mesurer si l'IA réserve plus qu'un humain ?

Famulor rapporte la transcription par appel, les appels d'outils, les IDs de réservation et les résultats. Vous pouvez comparer la conversion quotidienne des réservations par rapport à votre base de référence pré-IA et voir le delta directement.

Quelle est la limite de requêtes Smoobu pour un agent vocal ?

Smoobu autorise 1 000 requêtes par minute par jeton. Même avec 50 appels simultanés et 4-5 appels d'outils chacun, vous restez bien en dessous du plafond.