Utilisation et gestion via l'API

 

Vous êtes intégré à Rentals United en tant que Canal de vente ou système de gestion de propriétés et vous souhaitez échanger des messages automatiquement avec les voyageurs via Rentals United Guest Communication REST API. Dans cette section, nous décrivons les meilleures pratiques pour l'intégration de Guest Communication.

 

Une intégration efficace de Guest Communication pour un canal de vente se déroule selon les étapes suivantes:

  • Démarrer un nouveau fil de discussion pour une réservation, une demande ou un nouveau lead

  • Poster un nouveau message dans un fil de discussion déjà existant

  • S'abonner aux notifications webhook concernant les nouveaux messages

  • Récupérer les nouveaux messages

 

Une intégration efficace de Guest Communication pour un PMS se déroule selon les étapes suivantes:

  • Récupérer de threads liés à des réservations, des demandes ou des lead déjà existants

  • Récupérer des messages pour les fils de discussion

  • S'abonner aux notifications webhook concernant les nouveaux messages

  • Récupérer les nouveaux messages

  • Poster un nouveau message dans un fil de discussion déjà existant

 

Vous pouvez également utiliser notre fonction Guest Communication via l'API. Avant de commencer à mettre en œuvre les méthodes API, vous devez vous assurer que le site Guest Communication est correctement configuré pour les canaux qui vous intéressent. Si la configuration de Rentals United et des canaux n'est pas correcte, la fonctionnalité ne fonctionnera pas. Veillez à lire d'abord les articles suivants:

Une fois que vous avez activé Guest Communication, vous pouvez procéder à la mise en œuvre de l'API. L'API REST de Rentals United est détaillée ici. Vous y trouverez toutes les méthodes et les informations techniques nécessaires.

Vous trouverez ci-dessous des exemples de base de l'utilisation de cette API ainsi que des méthodes à mettre en œuvre pour communiquer avec succès avec les voyageurs.

La communication avec les voyageurs.est basée sur des fils de discussion qui contiennent des messages. Plusieurs fils de discussion sont disponibles, en fonction du canal (par exemple, le courrier électronique) ou du type de communication (par exemple, les commentaires des clients). L'important est de toujours rechercher les fils de discussion qui contiennent des informations spécifiques sur "CommunicationChannel". Voir ici pour en savoir plus sur les éléments "CommunicationChannel" disponibles et sur la manière de les utiliser correctement.

Les fils de discussion dont les messages les plus récents datent de plus de deux ans sont automatiquement supprimés.

 

Les messages Airbnb

Airbnb ne vous donne pas la possibilité d'entamer une conversation avec le voyageur avant qu'un identifiant de discussion unique ne soit créé. Une fois le fil de discussion créé, vous et le voyageur pouvez échanger. Les fils de discussion sont toujours créés par Airbnb lors des événements suivants :

  • vous recevez une réservation immédiate

  • vous confirmez une demande de réservation

  • vous recevez une piste avec un message d'invité

Par conséquent, si vous souhaitez échanger des messages via le chat Airbnb, vous devez être dans l’une des situations mentionnées ci-dessus.

Vous pouvez continuer à communiquer via ce fil de discussion, même lorsque la réservation est passée.

  1. Récupérer les threads. Utilisez la méthode GET /api/messaging/threads. En réponse, vous devez rechercher le fil de discussion qui contient l'information "CommunicationChannel" = "Airbnb".

  2. Récupérer les messages pour l'identifiant de fil de discussion sélectionné. Utilisez la méthode GET /api/messaging/threads/{id}/messages. En réponse, vous recevrez l'historique des messages.

  3. Envoyer un message à l'ID de la discussion sélectionnée. Utilisez la méthode POST /api/messaging/threads/{id}/messages. Utiliser le format de demande requis pour un message.

D'autres détails concernant Guest Communication pour Airbnb sont disponibles ici. Veillez à les lire avant de poursuivre.

 

Les messages Booking.com

La communication Booking.com est basée sur des fils / threads. Rentals United crée des threads lorsqu'une nouvelle réservation est reçue de Booking.com. L'invité et l'hôte peuvent tous deux entamer la conversation.

Vous pouvez échanger des messages avec le client à partir du moment de la réservation jusqu'à 7 jours après le départ du client ou l'annulation de la réservation. Lorsque l'invité répond au message, la fenêtre de conversation est prolongée de 14 jours. Il n'est pas possible de communiquer après un délai de 80 jours à compter du départ ou de l'annulation.

  1. Récupérer les fils. Utilisez la méthode GET /api/messaging/threads. En réponse, vous devez rechercher le fil de discussion qui contient l'information "CommunicationChannel" = "BookingCom".

  2. Récupérer les messages pour l'identifiant de fil de discussion sélectionné. Utilisez la méthode GET /api/messaging/threads/{id}/messages. En réponse, vous recevrez l'historique des messages.

  3. Envoyer un message à l'ID de la discussion sélectionnée. Utilisez la méthode POST /api/messaging/threads/{id}/messages. Utiliser le format de demande requis pour un message.

D'autres détails concernant Guest Communication pour Booking.com sont disponibles ici. Veillez à les lire avant de poursuivre.

 

Les messages Expedia

La communication Expedia est basée sur des fils / threads. Rentals United crée des fils de discussion lorsqu'une nouvelle réservation, une demande de réservation ou un lead est reçu de Expedia. Le voyageur et l'hôte peuvent tous deux entamer la conversation.

  1. Récupérer les fils. Utilisez la méthode GET /api/messaging/threads. En réponse, vous devez rechercher le fil de discussion qui contient l'information "CommunicationChannel" = "Expedia".

  2. Récupérer les messages pour l'identifiant de fil de discussion sélectionné. Utilisez la méthode GET /api/messaging/threads/{id}/messages. En réponse, vous recevrez l'historique des messages.

  3. Envoyer un message à l'ID de la discussion sélectionnée. Utilisez la méthode POST /api/messaging/threads/{id}/messages. Utiliser le format de demande requis pour un message.

 

Les messages Vrbo

La communication Vrbo est basée sur des fils / threads. Rentals United crée des fils de discussion lorsqu'une nouvelle réservation, une demande de réservation ou un lead est reçu de Vrbo. L'invité et l'hôte peuvent tous deux entamer la conversation.

  1. Récupérer les threads. Utilisez la méthode GET /api/messaging/threads. En réponse, vous devez rechercher le fil de discussion qui contient l'information "CommunicationChannel" = "Vrbo".

  2. Récupérer les messages pour l'identifiant de fil de discussion sélectionné. Utilisez la méthode GET /api/messaging/threads/{id}/messages. En réponse, vous recevrez l'historique des messages.

  3. Envoyer un message à l'ID de la discussion sélectionnée. Utilisez la méthode POST /api/messaging/threads/{id}/messages. Utiliser le format de demande requis pour un message.

D'autres détails concernant Guest Communication pour Vrbo sont disponibles ici. Veillez à les lire avant de poursuivre.

 

Messages électroniques

La messagerie électronique est également basée sur des fils de discussion et peut être utilisée pour les autres canaux de vente. Les fils de discussion sont créés par Rentals United à la réception d'un message du voyageur, mais vous pouvez également les créer si vous souhaitez entamer la conversation en premier.

  1. Créez d'abord le fil de discussion. Utilisez la méthode POST /api/messaging/threads.

  2. Envoyer un message à l'ID de la discussion sélectionnée. Utilisez la méthode POST /api/messaging/threads/{id}/messages. Utiliser le format de demande requis pour un message.

  3. Récupérer les fils. Utilisez la méthode GET /api/messaging/threads. En réponse, vous devez rechercher le fil de discussion dont l'information "CommunicationChannel" = "Email".

 

Pièces jointes

Les pièces jointes sont prises en charge pour tous les sites "CommunicationChannel", y compris les messages :

  • Email

  • Airbnb

  • BookingCom

  • Vrbo

Les méthodes de base à mettre en œuvre pour commencer à envoyer et à recevoir des pièces jointes sont les suivantes :

Si vous avez implémenté le mécanisme de webhook du LNM(PUT /api/messaging/notifications/subscribe), vous serez informé de tous les nouveaux messages. Toutefois, en raison des limites de taille des pièces jointes, le contenu de la pièce jointe ne sera pas inclus dans ces notifications. Les pièces jointes peuvent être extraites à l'aide de la commande GET /api/messagerie/messages.

Cliquez sur les liens et vous serez redirigé vers la documentation de l'API où vous pourrez lire en détail ces méthodes et d'autres encore.

L'envoi de pièces jointes peut être soumis à des exigences de format et de taille en raison des limitations imposées par les canaux de vente. Notez que les canaux sont entièrement libres et que Rentals United ne peut rien y faire. Dans ce cas, vous recevrez une notification par l'intermédiaire de l'API. Vous pouvez consulter les limites de taille et de format ici.

D'autres détails sur les pièces jointes sont disponibles ici. Veillez à les lire avant de poursuivre.

Les avis Airbnb

Les threads d’avis Airbnb deviennent disponibles après la fin de la réservation. Il est possible pour les deux parties, le voyageur et vous-même de rédiger le premier commentaire. Le fil de discussion accepte jusqu'à quatre messages : 1 avis voyageur, 1 avis de l’hôte, 1 réponse du voyageur et 1 réponse de l'hôte. Vous ne pouvez utiliser ce fil de discussion que pendant une période limitée (14 jours après le check-out pour soumettre l'évaluation et 30 jours pour y répondre). Si vous échangez tous les messages disponibles pour ce fil de discussion ou si la période de révision est écoulée, le fil de discussion devient indisponible et n'accepte plus aucun message. Pour en savoir plus sur Guest Reviews, cliquez ici.

Recommandation pour le flux des avis Airbnb

  • avis de l’hôte

  • avis du voyageur

  • réponse de l'hôte

  • réponse de l'invité

Notez qu’il est également possible sur Airbnb que ce soit le voyageur qui soumette son avis en premier. Si tel est le cas, n'hésitez pas à modifier l'ordre des étapes.

  1. Obtenir les détails du thread. Fournir un identifiant de réservation et recevoir les détails du fil de réservation (y compris l'identifiant du fil de réservation) dans la réponse. Il n'y aura qu'un seul fil. Si la réponse est vide, cela signifie que cette réservation n'a pas (encore) de fil de discussion.

    GET /api/reviews/thread/{reservationId}

  2. Fournissez votre propre évaluation de d'hôte.

    POST /api/reviews/airbnb/review

  3. Récupérer tous les messages pour cet identifiant de fil de discussion et rechercher les commentaires soumis par l'invité. Vous devez rechercher les paramètres suivants : " \"Mode\":\"review\" et "Creator\":\"guest\". Si la réponse est vide, cela signifie qu'aucun commentaire ou réponse n'a été soumis pour ce fil de discussion.

    GET /api/reviews/thread/{id}/messages

  4. Fournir une réponse à l'évaluation de l'invité.

    POST /api/reviews/airbnb/review-reply

  5. Récupérer tous les messages pour cet identifiant de fil de discussion et rechercher les réponses soumises par le voyageur. Vous devez rechercher le paramètre suivant : " \"Mode\":\"reply\".

    GET /api/reviews/thread/{id}/messages

D'autres détails concernant Guest Reviews pour Airbnb sont disponibles ici. Veillez à les lire avant de poursuivre.

Si vous avez mis en œuvre les Guest Reviews (avis voyageurs) avant le 2024-01-25, votre flux peut être comme décrit ci-dessous. Notez que ce flux (concernant uniquement les avis) sera obsolète d'ici la fin avril 2024, et que tous les utilisateurs de Rentals United devront passer au Recommandation pour le flux des avis Airbnb. Vous pourrez toujours utiliser ces méthodes pour récupérer et envoyer des messages réguliers de Guest Communication.

  1. Récupérer les fils. Utilisez la méthode GET /api/messaging/threads. En réponse, vous devez rechercher le fil de discussion qui contient l'information "CommunicationChannel" = "AirbnbGuestReview".

  2. Récupérer les messages pour l'identifiant de fil de discussion sélectionné. Utilisez la méthode GET /api/messaging/threads/{id}/messages. En réponse, vous recevrez l'historique des messages.

  3. Envoyer un message à l'ID de la discussion sélectionnée. Utilisez la méthode POST /api/messaging/threads/{id}/messages. Utilisez le format de demande requis pour un examen ou une réponse.

 

Booking.com revues

Booking.com les fils de révision deviennent disponibles après la fin de la réservation. Le fil de discussion accepte jusqu'à deux messages : 1 x commentaire d'invité, 1 x réponse d'hôte. C'est toujours l'invité qui rédige l'avis en premier et l'hôte ne peut qu'y répondre. Cet ordre ne peut être modifié. Notez que l'hôte ne peut répondre à l'évaluation que par des commentaires. Si l'invité ne fournit que l'évaluation, il n'est pas possible de répondre à cet avis. Si vous échangez tous les messages disponibles pour ce fil de discussion ou si la période de révision est écoulée, le fil de discussion devient indisponible et n'accepte plus aucun message. Pour en savoir plus sur Guest Reviews, cliquez ici.

Recommandation pour le flux des avis Booking.com

  1. Obtenir les détails du thread. Fournir un identifiant de réservation et recevoir les détails du fil de réservation (y compris l'identifiant du fil de réservation) dans la réponse. Il n'y aura qu'un seul fil. Si la réponse est vide, cela signifie que cette réservation n'a pas (encore) de fil de discussion.

    GET /api/reviews/thread/{reservationId}

  2. Récupérer tous les messages pour cet identifiant de fil de discussion et rechercher les commentaires soumis par l'invité. Si la réponse est vide, cela signifie qu'aucun commentaire ou réponse n'a été soumis pour ce fil de discussion.

    GET /api/reviews/thread/{id}/messages

  3. Répondre à l'avis de le voyageur.

    POST /api/reviews/bcom/review-reply

D'autres détails concernant Guest Reviews pour Booking.com sont disponibles ici. Veillez à les lire avant de poursuivre.

Si vous avez mis en œuvre les Guest Reviews (avis voyageurs) avant le 2024-01-25, votre flux peut être comme décrit ci-dessous. Notez que ce flux (concernant uniquement les avis) sera obsolète d'ici la fin avril 2024, et que tous les utilisateurs de Rentals United devront passer au Recommandation pour le flux des avis Booking.com. Vous pourrez toujours utiliser ces méthodes pour récupérer et envoyer des messages réguliers de Guest Communication.

  1. Récupérer les fils. Utilisez la méthode GET /api/messaging/threads. En réponse, vous devez rechercher le fil de discussion qui contient l'information "CommunicationChannel" = "GuestReview".

  2. Récupérer les messages pour l'identifiant de fil de discussion sélectionné. Utilisez la méthode GET /api/messaging/threads/{id}/messages. En réponse, vous recevrez l'historique des messages.

  3. Envoyer un message à l'ID de la discussion sélectionnée. Utilisez la méthode POST /api/messaging/threads/{id}/messages. Utiliser le format de demande requis pour un message.

 

Les avis Vrbo

Le fil de discussion Vrbo accepte trois types de messages :

  • 1 x avis d'invité - un avis d'invité comprenant un texte, un classement par étoiles et un classement par catégorie

  • 1 x note - une note sous forme d'étoiles attribuée par l'hôte

  • 1 x réponse de l'hôte - une réponse de l'hôte à l'avis de l'invité, comprenant uniquement du texte

Vrbo devient disponible après la fin de la réservation, ce qui signifie que vous et votre invité pouvez revoir le séjour à partir du jour du départ. Vrbo accepte que l'hôte et l'invité puissent d'abord examiner le séjour. Plus important encore, le premier évaluateur dispose d'un délai de 365 jours après la date de sortie pour entamer le processus d'évaluation. Le second réviseur n'a que 14 jours pour répondre. Si la période d'examen est dépassée, le deuxième examinateur ne sera plus autorisé à soumettre sa réponse.

D'autres détails concernant Guest Reviews pour Vrbo sont disponibles ici. Veillez à les lire avant de poursuivre.

Recommandation pour le flux des avis Vrbo

  1. Obtenir les détails du thread. Fournir un identifiant de réservation et recevoir les détails du fil de réservation (y compris l'identifiant du fil de réservation) dans la réponse. Il n'y aura qu'un seul fil. Si la réponse est vide, cela signifie que cette réservation n'a pas (encore) de fil de discussion.

    GET /api/reviews/thread/{reservationId}

  2. En tant qu'hôte, donnez votre évaluation dès que l'identifiant du fil de discussion est disponible.

    POST api/reviews/vrbo/rate-guest

  3. Récupérez régulièrement tous les messages correspondant à cet identifiant de fil de discussion et recherchez l'avis de l'invité. Vous trouverez ci-dessous les paramètres indiquant les différents types de messages acceptés par Vrbo. Si la réponse est vide, cela signifie qu'aucun message n'a été envoyé à ce fil de discussion.

    • commentaire d'un invité :

    • évaluation :

    • réponse de l'hôte :

    GET /api/reviews/thread/{id}/messages

  4. Une fois que l'avis de l'invité est présent, vous pouvez fournir la réponse de l'hôte, si nécessaire.

    POST api/reviews/vrbo/review-reply

  5. Vrbo vérifie le contenu de la réponse de l'hôte. Vous pourrez voir l'état de la réponse de l'hôte dans le paramètre .

    • Vrbo - la réponse de l'hôte attend l'approbation de

    • La réponse de l'hôte a été rejetée par Vrbo, vous pouvez soumettre une autre réponse de l'hôte.

    • Vrbo, a accepté la réponse de l'hôte

Airbnb pré-approbations

ici en savoir plus sur les pré-approbations et leur fonctionnement .

  1. Envoyez une pré-approbation en utilisant la méthode POST /api/airbnb/specialOffers.

  2. Retirer l'autorisation préalable à l'aide de la méthode PUT /api/airbnb/specialOffers.

  3. Récupérer des informations sur les préapprobations pour un fil spécifique à l'aide de la commande GET /api/airbnb/specialOffers.