Connecter votre logiciel de réservation (PMS) et relier vos annonces

Connecter votre PMS

Une fois votre logiciel de réservation (PMS) connecté, vos logements et les réservations de vos voyageurs arrivent dans l'application sans aucune saisie.

1. Ajouter la connexion

1. Ouvrez Paramètres › Flux et intégrations, onglet Intégrations (réservé aux administrateurs).
2. Tapez le nom de votre logiciel dans « Rechercher une intégration… ». Sur sa carte, cliquez sur Ajouter un compte, remplissez les accès demandés, puis cliquez sur Connecter.
3. Sur la carte de la connexion, cliquez sur Actualiser et importer pour faire venir vos annonces. Au départ, les logements importés arrivent inactifs : activez dans Logements ceux que vous gérez.
4. Vous avez plusieurs connexions ? Renommez-les : cliquez sur le crayon, puis, dans « Renommer la connexion », saisissez un « Nom affiché ».

2. Relier chaque annonce à un logement

Chaque annonce de votre PMS est associée à un seul logement de l'application.

1. En haut de la page Intégrations, cliquez sur Relier une connexion à un appartement, puis choisissez le compte concerné. (Sur la carte d'une connexion, Modifier les connexions ouvre la même fenêtre.)
2. Dans la fenêtre « Relier les appartements », validez les correspondances trouvées par le nom (Valider les N suggestions, ou Valider une par une), ou choisissez le logement à la main dans « Choisir un appartement… ».
3. Cochez « Créer un appartement pour chaque annonce non reliée » si vous voulez créer d'un coup les logements manquants.
4. Terminez par Enregistrer N liens.

3. Vérifier ou changer un lien

Dans la fiche du logement, l'onglet Connexion, carte « Annonce reliée », affiche le nom de l'annonce côté API, le numéro relié, l'état du lien et la dernière synchronisation. Vous pouvez y cliquer sur Relier à une autre annonce API ou sur Dissocier la connexion.

Quand vous reliez une annonce déjà reliée à un autre logement, l'application vous guide : que faire des réservations à venir, des ménages déjà planifiés et de l'ancien logement en double (« Mettre en corbeille », « Désactiver » ou « Laisser actif sans liaison »). Un récapitulatif s'affiche avant Confirmer.

Bon à savoir : en reliant un logement à une autre annonce, vous pouvez cocher « Supprimer l'ancienne annonce de l'application et ignorer ses futures synchronisations ». Rien n'est modifié sur la plateforme externe.

Sans PMS : les liens iCal

Chaque logement peut recevoir un ou plusieurs liens iCal : dans sa fiche, onglet Connexion, carte « Calendriers iCal », ou dans la colonne « iCal » du fichier d'import Excel. Les réservations sont alors lues depuis le calendrier partagé par votre plateforme de location. Voir [Connectez un calendrier iCal](/aide/integrations/connecter-un-calendrier-ical).

Votre propre outil : la « Source personnalisée (API) »

Si votre logiciel n'est pas dans la liste, ou si vous avez un outil maison, votre développeur peut envoyer vos logements, réservations et missions, puis relire le travail fait sur le terrain (statut, agents, heures de début et de fin, validation, lien du rapport). Tout se trouve en bas de la page Intégrations, partie Développeurs : la carte « Source personnalisée (API) » et la carte Accès développeurs.

Créer un jeton par outil

1. Dans la carte Accès développeurs, cliquez sur Nouveau jeton. 2. Donnez-lui un « Nom » (par exemple « Tableau de bord interne ») et cochez ses autorisations : - Lecture : relire missions, logements et réservations ; - Écriture : créer ou modifier une mission ; - Import : envoyer logements, réservations et missions en lot. 3. Cliquez sur Créer le jeton, puis copiez-le immédiatement : il ne sera plus jamais affiché.

Chaque jeton se révoque à tout moment (Révoquer), sans toucher aux autres. La mention « Dernier usage » vous aide à repérer un jeton oublié.

Être prévenu quand une mission change (notifications)

Plutôt que d'interroger l'API en boucle, votre outil peut recevoir une notification signée à chaque événement : mission créée, assignée, démarrée, terminée ou validée par un responsable.

1. Dans la carte Accès développeurs, cliquez sur Ajouter une adresse et saisissez l'adresse HTTPS de votre outil.
2. Cochez les événements souhaités, cliquez sur Ajouter, puis copiez le secret de signature affiché une seule fois : il permet à votre outil de vérifier que la notification vient bien de The Big One.
3. Envoyer un test vérifie tout de suite que l'adresse répond. Vous pouvez mettre une adresse en pause avec son interrupteur, demander un Nouveau secret ou la Supprimer.

Les « Derniers envois » (Envoyé, En attente, Abandonné) s'affichent sous la liste. En cas d'échec, l'envoi est retenté avant d'être abandonné.

Bon à savoir : la documentation technique s'ouvre avec le lien « Documentation de l'API » de la carte Accès développeurs. Un jeton donne accès aux données de votre société : ne le partagez qu'avec un prestataire de confiance et révoquez-le dès que la collaboration s'arrête. Pour aller plus loin : [Connectez votre logiciel de gestion](/aide/integrations/connecter-votre-logiciel-de-gestion) et [Connectez votre outil par l'API](/aide/integrations/connecter-votre-outil-par-l-api).