Fonctionnalité Premium

Les intégrations sont une fonctionnalité disponible uniquement pour les utilisateurs des forfaits Premium et Business Pro.

 

À quoi sert l'intégration ?


Hostaway est un logiciel de gestion immobilière pour les locations de vacances et Airbnb. L'utilisation de l'intégration Hostaway avec Keycafe permet de créer et d'envoyer automatiquement des codes d'accès et des instructions à vos voyageurs lorsqu'une réservation est créée dans Hostaway.

 

Comment configurer l'intégration


1. Générer une clé API Hostaway

  1. Suivez les étapes d'Hostaway pour créer une clé API.

  2. Prenez note de l'Account ID et de l'API Key.

API secret key generated successfully.png

2. Associer vos comptes

  1. Dans votre tableau de bord Keycafe, sélectionnez +Ajouter → Intégration → Hostaway.

  2. Saisissez votre Hostaway Account ID, et votre clé API Hostaway, puis cliquez sur Soumettre

Ajouter un webhook à Hostaway


Une fois la configuration de l'intégration terminée, vous recevrez un e-mail contenant une URL de webhook.

  1. Copiez l'URL.

  2. Dans votre tableau de bord Hostaway, sélectionnez Settings → Integrations, puis faites défiler jusqu'à Unified webhooks.

  3. Sous Add Webhook, collez l'URL et assurez-vous que Is enbaled est défini sur Yes, puis cliquez sur +Add.

 

Associer une clé Keycafe à votre annonce Hostaway


Ajouter le tag Keycafe à l'annonce dans Hostaway

Pour chaque annonce Hostaway que vous souhaitez inclure dans l'intégration Keycafe, un tag « Keycafe » doit être ajouté dans les détails de l'annonce. Les annonces sans ce tag ne feront pas l'objet de réservations créées automatiquement dans Keycafe.

  1. Dans votre tableau de bord Hostaway, sélectionnez Listings → Details → Edit.

  2. Dans le champ Tags, saisissez le tag "Keycafe".

image.jpg

 

Tags utiles supplémentaires

Le tag « Keycafe » peut être modifié pour inclure des paramètres supplémentaires pour votre intégration :

  • -sn (Désactiver les notifications) : Si vous préférez envoyer l'e-mail contenant le code d'accès à la clé et les instructions à votre voyageur uniquement via Hostaway, vous pouvez désactiver l'e-mail automatique de Keycafe en ajoutant « -sn » au tag. Le tag complet devient alors « Keycafe-sn ».

  • -dc (Code de porte) : Si vous souhaitez enregistrer automatiquement le code de réservation Keycafe de la clé dans le champ Door Code de la réservation Hostaway, ajoutez « -dc » au tag. Le tag complet devient alors « Keycafe-dc ». Notez que si ce tag est ajouté et que vous saisissez manuellement un code de porte lors de la création d'une réservation Hostaway, il sera écrasé par le code de réservation Keycafe.

Ajouter les deux tags

Si vous souhaitez à la fois désactiver les notifications et enregistrer automatiquement le code de réservation dans le champ du code de porte, vous pouvez utiliser le tag « Keycafe-sn-dc » ou « Keycafe-dc-sn ».

 

Ajouter le numéro de Listing ID à la clé dans Keycafe

Votre Listing ID Hostaway est utilisé pour identifier la clé associée dans Keycafe. Si vous avez plusieurs annonces et plusieurs clés, cette opération doit être effectuée pour chaque paire.

  1. Dans votre tableau de bord Hostaway, sélectionnez Listings, puis copiez le Listing ID Number.

Screenshot 2024-12-13 at 3.44.09 PM.png
  1. Dans votre tableau de bord Keycafe, sélectionnez Clés, puis la clé correspondant à l'annonce. Si vous n'avez pas encore créé la clé pour l'annonce, consultez Ajouter une clé pour le faire.

  2. Sélectionnez À propos de la clé → Modifier, puis saisissez le Listing ID Number de l'étape 1 dans le champ Notes internes et cliquez sur Enregistrer.

Screenshot 2025-01-27 at 5.19.24 PM.jpg

 

Utiliser l'intégration


Dès qu'une réservation voyageur est créée dans Hostaway, une réservation ponctuelle Keycafe pour la clé associée est automatiquement générée avec les mêmes date et heure de début et de fin que la réservation. Toute modification de la réservation dans Hostaway sera répercutée sur la réservation Keycafe, y compris une annulation. Veuillez prévoir un délai de 1 à 2 minutes pour que les nouvelles réservations et les modifications apparaissent dans la réservation Keycafe.

Le code de réservation permettant d'accéder à la clé à votre SmartBox est ensuite automatiquement envoyé au voyageur par e-mail.

Emplacement de la SmartBox

Veuillez noter que l'e-mail ne précise pas où se trouve votre SmartBox ; vous devrez donc indiquer séparément son emplacement à votre voyageur.

 

Déconnecter votre compte Hostaway


  1. Dans votre tableau de bord Keycafe, sélectionnez Intégrations → Hostaway → À propos de l'intégration → Déconnecter.

  2. Cliquez sur Déconnecter pour confirmer.

 

Assistance supplémentaire


Vous avez des questions sur l'intégration ou des suggestions d'amélioration ? Envoyez-nous un e-mail à support@keycafe.com.