Intégrations PMS (Beds24 et Hostfully)
Si votre entreprise gère déjà ses villas dans un autre système de gestion immobilière (PMS), vous pouvez le connecter à Argonautas au lieu de tout ressaisir manuellement. Argonautas prend en charge Beds24 et Hostfully. Une fois connecté, vos propriétés, réservations, tarifs et disponibilités, ainsi que les messages des clients proviennent du PMS vers Argonautas et restent à jour automatiquement.
Votre PMS reste responsable des données qu'il envoie. Argonautas les lit, et vous ne pouvez pas les modifier dans Argonautas. Effectuez les modifications dans le PMS et elles seront transmises lors de la prochaine synchronisation.
Qui peut voir ceci
L'intégration PMS est activée pour chaque entreprise par le support Argonautas. La carte Système de gestion immobilière n'apparaît sous Paramètres > Intégrations qu'une fois que le support l'a activée pour votre entreprise. Si vous utilisez Beds24 ou Hostfully et que vous ne voyez pas la carte, contactez le support.
Les administrateurs et les gestionnaires de propriétés peuvent connecter, consulter et importer. Chaque entreprise peut connecter un PMS.
Connecter votre PMS
Ouvrez Paramètres > Intégrations et trouvez la carte Système de gestion immobilière. Sous Quel système ?, choisissez Beds24 ou Hostfully.
Beds24
Beds24 se connecte avec un code d'invitation à usage unique que vous générez dans Beds24. La carte liste les étapes sous Avant de commencer :
- Dans Beds24, allez dans Paramètres → Marketplace → API et générez un code d'invitation.
- Lors de la génération, accordez toutes les portées listées sous Autorisations à accorder :
read:bookings,read:bookings-personal,read:bookings-financial,read:properties,read:inventory,write:inventoryetwrite:properties. - Collez le code dans Code d'invitation et cliquez sur Connecter.
Le code expire 24 heures après sa génération et ne fonctionne qu'une seule fois. Si la connexion échoue, générez un nouveau code dans Beds24 et collez-le. Réessayer avec le même code ne fonctionnera pas.
Accordez toutes les portées dès la première fois. Beds24 fixe les portées au moment de la création du code, et elles ne peuvent pas être ajoutées ultérieurement. Si vous en oubliez une, la seule solution est de vous déconnecter et de vous reconnecter avec un nouveau code. Sans read:bookings-personal, les séjours importés affichent un client fictif au lieu des vrais noms, e-mails et numéros de téléphone. Sans read:bookings-financial, les prix des réservations et les commissions ne peuvent pas être lus. Sans write:inventory, vous ne pouvez pas définir le prix d'une villa Beds24 depuis Argonautas (voir Définir un prix Beds24 depuis le calendrier).
Hostfully
Hostfully se connecte avec les identifiants API de votre compte :
- Dans Hostfully, ouvrez Paramètres → API et copiez votre clé API et votre UID d'agence.
- Saisissez-les dans Clé API et UID d'agence sur la carte.
- Cliquez sur Connecter.
Argonautas vérifie les identifiants auprès de Hostfully avant d'enregistrer quoi que ce soit. S'ils sont rejetés, la carte affiche l'erreur sur place. Vérifiez les deux valeurs dans Hostfully et réessayez.
Ce qui se passe juste après la connexion
Dès que vous vous connectez, Argonautas recherche les unités louables dans votre PMS. Rien n'est encore importé. Il ne fait que trouver les unités et vous demande ce qu'elles sont (voir la section suivante).
Examiner les unités découvertes
Chaque unité trouvée dans votre PMS nécessite une décision avant que ses réservations ne soient importées. Lorsque des unités sont en attente, la carte affiche une bannière jaune ({count} unité(s) nécessitent une décision) et le statut passe à Nécessite une révision. Cliquez sur Examiner les unités pour ouvrir Examiner les unités découvertes.
Pour chaque unité, choisissez l'une des options sous Qu'est-ce que c'est ? et cliquez sur Appliquer :
| Option | Ce qu'elle fait |
|---|---|
| Créer une nouvelle propriété | Argonautas crée une nouvelle propriété pour cette unité lors de la prochaine importation. |
| C'est ma « … » existante | Relie l'unité à une propriété que vous avez déjà dans Argonautas. La propriété conserve sa description, ses photos et ses équipements. À partir de ce moment, votre PMS contrôle sa disponibilité, ses dates et son statut de réservation. |
| Ne pas importer celle-ci | Laisse l'unité de côté. Aucune de ses réservations n'est importée. |
Argonautas peut suggérer une correspondance possible pour une unité. Cette suggestion ne compare que les noms, alors vérifiez-la avant de choisir.
Importer les réservations
Lorsque chaque unité a une décision, cliquez sur Importer les réservations. L'importation s'exécute en arrière-plan, et la date de Dernière importation de la carte se met à jour lorsqu'elle se termine. Vous ne pouvez pas lancer une importation tant que des unités sont encore en attente. La carte affiche « Terminez l'examen des unités ci-dessus avant d'importer. »
La rangée de chiffres sur la carte indique combien d'unités sont Mappées, En attente de révision et Ignorées, ainsi que la date de la Dernière importation.
Autres boutons sur la carte :
- Actualiser les unités vérifie à nouveau votre PMS pour de nouvelles unités. Les nouvelles apparaissent dans la liste de révision.
- Tester la connexion confirme qu'Argonautas peut toujours atteindre votre PMS.
- Déconnecter arrête toutes les importations futures et supprime l'identifiant stocké. Vos propriétés et décisions de mappage sont conservées. Pour reconnecter un compte Beds24, vous aurez besoin d'un nouveau code d'invitation.
Maintenir les réservations synchronisées
Après la première importation, Argonautas se tient à jour avec votre PMS de trois façons :
- Interrogation des réservations : environ toutes les 5 minutes, Argonautas demande à votre PMS les réservations nouvelles, modifiées ou annulées.
- Réconciliation nocturne : une passe complète chaque nuit rattrape tout ce que l'interrogation a manqué.
- Alertes de réservation instantanées (webhooks) : votre PMS informe Argonautas dès qu'une réservation est faite ou annulée.
Les alertes instantanées sont importantes car les villas importées peuvent encore être réservées directement via Argonautas. Plus vite Argonautas est informé d'une vente dans votre PMS, plus la fenêtre pendant laquelle les mêmes nuits pourraient être vendues deux fois est réduite. Configurez-les dès que vous vous connectez.
Alertes de réservation instantanées pour Beds24
Beds24 n'a aucun moyen de configurer cela à distance, vous devez donc l'ajouter manuellement. Le panneau Alertes de réservation instantanées de la carte affiche une URL de webhook et une seconde valeur (un nom d'en-tête et sa valeur), chacune avec un bouton de copie. Dans Beds24, allez dans Paramètres → Propriétés → Accès → Webhook de réservation, collez les deux valeurs et choisissez version 2 (avec données personnelles).
Faites cela une fois par propriété Beds24, c'est-à-dire le conteneur qui regroupe vos types de chambres, et non une fois par villa.
Alertes de réservation instantanées pour Hostfully
Hostfully peut être configuré depuis Argonautas. Dans le panneau Alertes de réservation instantanées de la carte, cliquez sur Enregistrer les webhooks. En cas de succès, le bouton devient Webhooks enregistrés. et vous n'avez plus besoin de cliquer dessus.
Ce qui se synchronise depuis votre PMS
| Donnée | Beds24 | Hostfully | Remarques |
|---|---|---|---|
| Propriétés (nom, chambres, salles de bain, nombres de clients, adresse, emplacement sur la carte) | Oui | Oui | Maintenues en phase avec le PMS. Ces champs ne peuvent pas être modifiés dans Argonautas. |
| Réservations (dates, statut, client) | Oui | Oui | En lecture seule dans Argonautas. |
| Tarifs par nuit et dates bloquées | Oui | Oui | Actualisés à chaque importation et lors de la réconciliation nocturne. C'est ce à partir de quoi votre site de réservation directe établit ses devis. |
| Photos et descriptions | — | Oui | Récupérées lorsqu'une importation crée une nouvelle propriété. Les photos sont copiées dans Argonautas, non liées. Une description ne remplit qu'un champ vide et n'écrase jamais le texte que vous avez rédigé. |
| Équipements | — | Oui | Les équipements correspondants sont ajoutés aux nouvelles propriétés. Les équipements que vous avez définis ne sont jamais supprimés. |
| Messages des clients et des hôtes | Oui | Oui | Une copie en lecture seule dans votre boîte de réception. Voir Messages provenant de votre PMS. Pour Beds24, cela nécessite la portée read:bookings-personal. |
Comment les réservations sont étiquetées
Chaque réservation importée conserve le canal d'où elle provient (Airbnb, Booking.com, VRBO, etc.) comme source, afin que vos rapports montrent l'origine de votre activité. Deux détails :
- Les réservations Airbnb qu'Airbnb a déjà payées apparaissent comme Payées. Elles sont enregistrées comme payées en dehors d'Argonautas, elles n'affichent donc jamais de solde impayé.
- Les réservations VRBO qui parviennent à Beds24 via un flux iCal sont étiquetées VRBO, et non « Autre ». Un flux iCal ne contient que des dates, ces réservations n'ont donc pas de prix dans Argonautas.
Comment se comportent les propriétés importées
Les propriétés importées sont des propriétés Directes ordinaires. Ce ne sont pas des propriétés partenaires :
- Elles appartiennent à votre entreprise. Une nouvelle propriété importée est attribuée à un enregistrement de propriétaire portant le nom de votre entreprise, et ses réservations apparaissent dans vos rapports financiers. Aucun accès au portail propriétaire n'est créé avec elle.
- Elles sont réservables directement. Votre site de réservation directe lit leurs tarifs et disponibilités depuis Argonautas.
- Pas de channel manager. Votre PMS distribue déjà ces villas aux OTA, Argonautas ne transmet donc jamais leurs tarifs ou disponibilités vers l'extérieur. Sur l'onglet Canaux de la propriété, le channel manager est remplacé par une carte Distribution qui indique Les canaux sont gérés par Beds24 (ou Hostfully). Gérez leurs annonces OTA dans votre PMS.
- Tarification en lecture seule. Sur l'onglet Tarification, la liste des saisons et le calendrier tarifaire sont en lecture seule. Définissez les tarifs dans votre PMS. Pour une villa Beds24, vous pouvez aussi définir son prix par nuit depuis le calendrier (voir Définir un prix Beds24 depuis le calendrier). Les tarifs Hostfully ne se modifient que dans Hostfully.
- Les champs gérés par le PMS sont verrouillés. La modification d'un champ contrôlé par le PMS, comme le nom, le nombre de chambres ou l'adresse, est rejetée avec « Ces champs sont gérés par l'importation PMS externe et ne peuvent pas être modifiés ici ». Les réservations importées sont également en lecture seule. Modifiez-les dans votre PMS.
- Pas de messages clients automatisés. Argonautas n'envoie pas de confirmations de réservation, de messages de cycle de vie ou d'autres e-mails clients automatisés pour les réservations importées. Votre PMS gère déjà cette relation.
Définir un prix Beds24 depuis le calendrier
Si votre code d'invitation Beds24 accorde write:inventory, un gestionnaire de propriétés peut définir le prix par nuit d'une villa Beds24 depuis Argonautas sans ouvrir Beds24. Les villas Hostfully n'ont pas cette option : leurs tarifs sont en lecture seule dans Argonautas.
- Ouvrez Calendrier, passez en Vue Matricielle et vérifiez que la ligne des tarifs est affichée (le bouton Tarifs à côté de la légende). Voir Vue matrice.
- Cliquez sur le tarif d'une nuit d'une villa Beds24. La boîte de dialogue Définir le prix dans Beds24 s'ouvre sur cette nuit.
- Ajustez Du et Au (dernière nuit) si vous voulez une plage, puis saisissez le Nouveau prix par nuit. Prix actuel indique le prix qu'Argonautas a lu en dernier dans Beds24 pour ces nuits.
- Cliquez sur Enregistrer.
Beds24 conserve un seul prix par nuit : une plage met donc toutes ses nuits au même prix, y compris les prix de week-end ou d'événement définis dans Beds24. Quand plus d'une nuit est concernée, la boîte de dialogue vous prévient d'abord : « Les {count} nuits passeront à {price} dans Beds24. »
Vous pouvez définir jusqu'à 62 nuits à la fois. Les nuits passées ne peuvent pas être modifiées, et les nuits à plus d'un an environ sont refusées (« Trop loin pour être confirmé par Beds24. »).
Après l'enregistrement, Argonautas relit le prix dans Beds24 et vous indique le résultat :
| Message | Ce que cela signifie |
|---|---|
| Enregistré dans Beds24. | Beds24 a le nouveau prix. La boîte de dialogue se ferme. |
| Beds24 a accepté la modification mais indique … pour ces nuits (vous avez demandé …). | Une règle de prix Beds24 la remplace peut-être. Vérifiez la configuration des prix dans Beds24. |
| Enregistré dans Beds24. Relecture impossible pour l'instant ; le calendrier se met à jour à la prochaine synchronisation. | La modification est passée, mais pas la relecture. Rien à faire. |
| Beds24 n'a pas répondu à temps. L'enregistrement a peut-être eu lieu ; vérifiez le calendrier. | Revérifiez la nuit avant de réessayer. |
Si une synchronisation du calendrier est déjà en cours, vous verrez « A calendar sync is running; try again in a minute. » (ce message s'affiche en anglais).
Quand la connexion ne peut pas écrire les prix, cliquer sur le tarif d'une villa Beds24 l'affiche en lecture seule avec la raison, par exemple « Beds24 connection lacks rate access. » si le code d'invitation n'incluait pas write:inventory. On ne peut pas ajouter de portées à une connexion existante : déconnectez-vous et reconnectez-vous avec un nouveau code d'invitation qui accorde toutes les portées.
Messages provenant de votre PMS
Les messages des clients et des hôtes provenant de votre PMS apparaissent dans la Boîte de réception sous forme de copie en lecture seule, vérifiée environ toutes les 15 minutes. Chaque fil est rattaché à sa réservation et affiche le nom du client, avec le canal de la réservation (par exemple Airbnb) comme canal.
Ces fils sont là pour le contexte. Répondez au client depuis votre PMS ou l'OTA. Une réponse saisie dans Argonautas n'atteindra pas le client.
Questions fréquentes
Je ne vois pas la carte Système de gestion immobilière. Le support Argonautas active l'intégration pour chaque entreprise. Contactez le support pour qu'elle soit activée.
Mon code d'invitation Beds24 a été rejeté. Les codes d'invitation fonctionnent une seule fois et expirent 24 heures après leur création. Générez un nouveau code dans Beds24 (Paramètres → Marketplace → API) et collez-le.
La carte indique « Cette connexion manque de permissions. » Le code d'invitation Beds24 a été généré sans l'une des portées listées sur la carte. Vous ne pouvez pas modifier les portées d'une connexion existante. Déconnectez-vous, générez un nouveau code d'invitation avec toutes les portées cochées, et reconnectez-vous.
Pourquoi certaines réservations ne sont-elles pas importées ? Les réservations ne sont importées que pour les unités Mappées. Les unités En attente de révision ou Ignorées ne sont pas importées. Ouvrez Examiner les unités et prenez une décision pour chacune.
Puis-je renommer une propriété importée ? Le nom provient de votre PMS et est actualisé à chaque synchronisation. Renommez l'unité dans votre PMS. Si vous avez besoin d'un nom d'affichage différent dans Argonautas que dans votre PMS, contactez le support.
Puis-je connecter une propriété importée à Airbnb ou Booking.com depuis Argonautas ? Non. Votre PMS la liste déjà sur les OTA, et la connecter deux fois risquerait de créer des doubles réservations. L'onglet Canaux vous indique quel PMS la gère.
D'où viennent les avis Airbnb pour les propriétés importées ? Voir Avis clients.
Associé
- Guide des paramètres : la section Intégrations où se trouve cette carte.
- Avis clients : comment les avis des propriétés importées parviennent à Argonautas.
- Guide de messagerie : la boîte de réception unifiée où apparaissent les messages du PMS.
- Intégration des canaux : la distribution pour les propriétés qu'Argonautas gère lui-même.
- Propriétés gérées par des partenaires : en quoi les propriétés partenaires diffèrent des propriétés importées.