Uso y gestión mediante API

 

Estás integrado con Rentals United como Canal de ventas o Sistema de Gestión de la Propiedad y te gustaría intercambiar automáticamente mensajes con los huéspedes a través de Rentals United Comunicación con los huéspedes REST API. En esta sección describimos las mejores prácticas para la integración de Comunicación con los huéspedes.

 

Una integración eficaz de Comunicación con los huéspedes para un Canal de Ventas se compone de los siguientes pasos:

  • Inicio de un nuevo hilo de conversación para una reserva, solicitud o cliente potencial recién creado

  • Publicar un nuevo mensaje en un hilo ya existente

  • Suscripción a notificaciones webhook sobre nuevos mensajes

  • Extracción de nuevos mensajes

 

Una integración eficaz de Comunicación con los huéspedes para un PMS se compone de los siguientes pasos:

  • Obtención de hilos asociados a reservas, solicitudes o clientes potenciales ya existentes

  • Obtención de mensajes para los hilos

  • Suscripción a notificaciones webhook sobre nuevos mensajes

  • Extracción de nuevos mensajes

  • Publicar un nuevo mensaje en un hilo ya existente

 

También puedes utilizar nuestra función Comunicación con los huéspedes a través de la API. Antes de empezar a implementar los métodos de la API, debes asegurarte de que Comunicación con los huéspedes está configurado correctamente para los canales que te interesan. Sin una configuración adecuada en Rentals United y en los canales, la función no funcionará. Asegúrate primero de seguir estos artículos:

Una vez habilitado Guest Communication, puede proceder a la implementación de la API. Rentals United REST API está documentada aquí. Allí encontrarás todos los métodos y detalles técnicos necesarios.

A continuación puedes leer los ejemplos básicos de uso de esta API, así como los métodos que debes implementar para comunicarte correctamente con tus huéspedes.

La comunicación con los huéspedes se basa en hilos que contienen mensajes. Hay varios hilos disponibles, en función del canal (por ejemplo, el correo electrónico) o de un tipo de comunicación (por ejemplo, las opiniones de los huéspedes). Lo importante es que siempre busques hilos que tengan información específica de "CommunicationChannel". Consulta aquí para obtener más información sobre los elementos "CommunicationChannel" disponibles y cómo utilizarlos correctamente.

Los hilos con los mensajes más recientes de más de 2 años se eliminan automáticamente.

 

Mensajes de Airbnb

Airbnb no te da la posibilidad de iniciar una conversación con tu huésped antes de que se cree un ID de hilo único. Una vez creado el hilo, tú y el huésped podéis escribiros. Los hilos de mensajería siempre son creados por Airbnb ante los siguientes eventos:

  • recibas una reserva instantánea

  • confirmes una solicitud de reserva

  • recibes un lead con un mensaje de invitado

Por lo tanto, si deseas intercambiar mensajes a través del chat Airbnb, debes esperar a que se produzcan las situaciones anteriores.

Puedes seguir comunicándote a través de este hilo, incluso después de que la reserva ya haya pasado.

  1. Recuperar hilos. Utiliza el método GET /api/messaging/threads. En respuesta, busca el hilo que tiene la información de "CommunicationChannel" = "Airbnb".

  2. Recuperar mensajes para el ID de hilo seleccionado. Utiliza el método GET /api/messaging/threads/{id}/messages. En respuesta, recibirás el historial de mensajes.

  3. Enviar un mensaje a la ID de hilo seleccionada. Utiliza el POST /api/messaging/threads/{id}/messages. Utiliza el formato de solicitud requerido para un mensaje.

Encontrará más información sobre Comunicación con los huéspedes aquí Airbnb. Asegúrese de leerlos antes de seguir adelante.

 

Mensajes de Booking.com

La comunicación de Booking.com se basa en hilos. Rentals United crea hilos cuando se recibe una nueva reserva de Booking.com. Tanto el huésped como el anfitrión pueden iniciar la conversación en primer lugar.

Puedes intercambiar mensajes con el huésped desde el momento de la reserva hasta 7 días después de que el huésped realice la salida o cancele la reserva. Cuando el huésped responde al mensaje, la ventana de conversación se amplía 14 días más. No es posible comunicarse una vez transcurridos 80 días desde la salida o cancelación.

  1. Recuperar hilos. Utiliza el método GET /api/messaging/threads. En respuesta, busca el hilo que tiene la información de "CommunicationChannel" = "BookingCom".

  2. Recuperar mensajes para el ID de hilo seleccionado. Utiliza el método GET /api/messaging/threads/{id}/messages. En respuesta, recibirás el historial de mensajes.

  3. Enviar un mensaje a la ID de hilo seleccionada. Utiliza el POST /api/messaging/threads/{id}/messages. Utiliza el formato de solicitud requerido para un mensaje.

Encontrará más información sobre Comunicación con los huéspedes aquí Booking.com. Asegúrese de leerlos antes de seguir adelante.

 

Mensajes de Expedia

La comunicación de Expedia se basa en hilos. Rentals United crea hilos cuando se recibe una nueva reserva, una solicitud de reserva o un lead de Expedia. Tanto el huésped como el anfitrión pueden iniciar la conversación en primer lugar.

  1. Recuperar hilos. Utiliza el método GET /api/messaging/threads. En respuesta, busca el hilo que tiene la información de "CommunicationChannel" = "Expedia".

  2. Recupera mensajes para el ID de hilo seleccionado. Utiliza el método GET /api/messaging/threads/{id}/messages. En respuesta, recibirás el historial de mensajes.

  3. Enviar un mensaje a la ID de hilo seleccionada. Utiliza el POST /api/messaging/threads/{id}/messages. Utiliza el formato de solicitud requerido para un mensaje.

 

Mensajes de Vrbo

La comunicación de Vrbo se basa en hilos. Rentals United crea hilos cuando se recibe una nueva reserva, una solicitud de reserva o un lead de Vrbo. Tanto el huésped como el anfitrión pueden iniciar la conversación en primer lugar.

  1. Recuperar hilos. Utiliza el método GET /api/messaging/threads. En respuesta, busca el hilo que tiene la información de "CommunicationChannel" = "Vrbo".

  2. Recuperar mensajes para el ID de hilo seleccionado. Utiliza el método GET /api/messaging/threads/{id}/messages. En respuesta, recibirás el historial de mensajes.

  3. Envía un mensaje a la ID de hilo seleccionada. Utiliza el POST /api/messaging/threads/{id}/messages. Utiliza el formato de solicitud requerido para un mensaje.

Encontrará más información sobre Comunicación con los huéspedes aquí Vrbo. Asegúrese de leerlos antes de seguir adelante.

 

Mensajes de correo electrónico

La mensajería por correo electrónico también se basa en hilos y puede utilizarse para el resto de canales de venta. Los hilos son creados por Rentals United al recibir un mensaje del huésped, pero opcionalmente tú también puedes crearlos, si quieres iniciar la conversación primero.

  1. Crear el hilo primero. Utiliza el método POST /api/messaging/threads.

  2. Envía un mensaje a la ID de hilo seleccionada. Utiliza el POST /api/messaging/threads/{id}/messages. Utiliza el formato de solicitud requerido para un mensaje.

  3. Recuperar hilos. Utiliza el método GET /api/messaging/threads. En respuesta, busca el hilo que tiene la información de "CommunicationChannel" = "Email".

 

Archivos adjuntos

Se admiten archivos adjuntos para todos los "CommunicationChannel" que incluyen mensajes:

  • Email

  • Airbnb

  • BookingCom

  • Vrbo

Los métodos básicos que necesitas implementar para empezar a enviar y recibir archivos adjuntos son los siguientes:

Si ha implementado el mecanismo webhook de LNM(PUT /api/messaging/notifications/subscribe) recibirá notificaciones sobre todos los mensajes nuevos. Sin embargo, debido a los límites de tamaño de los archivos adjuntos, el contenido adjunto no se incluirá en estas notificaciones. Los archivos adjuntos pueden extraerse mediante el comando GET /api/messaging/messages.

Haz clic en los enlaces y serás redirigido a la documentación de la API, donde podrás leer en detalle estos y otros métodos.

Puede haber algunos requisitos de formato y tamaño al enviar archivos adjuntos debido a las limitaciones de los canales de venta. Ten en cuenta que depende exclusivamente de los canales y que Rentals United no puede hacer nada al respecto. En tal caso, recibirás una notificación pertinente a través de la API. Puedes ver los límites de tamaño y formato aquí.

Encontrará más información sobre los anexos aquí. Asegúrese de leerlos antes de seguir adelante.

Reseñas de Airbnb

Los hilos de reseñas de Airbnbestarán disponibles una vez finalizada la reserva. Tanto tú como tu huésped podéis escribir la primera opinión. El hilo de reseñas acepta hasta cuatro mensajes: 1 x reseña del huésped, 1 x reseña del anfitrión, 1 x respuesta del huésped y 1 x respuesta del anfitrión. Puedes utilizar este hilo solo durante un tiempo limitado (14 días después de la salida para enviar la reseña y 30 días para responder). Si intercambias todos los mensajes disponibles para este hilo o pasa el periodo de reseña, el hilo deja de estar disponible y no aceptará más mensajes. Puedes leer más sobre Reseñas de huéspedes aquí.

Flujo de reseñas de Airbnb recomendado

  • reseña del anfitrión

  • reseña del huésped

  • respuesta del anfitrión

  • respuesta del huésped

Ten en cuenta que en Airbnb también es posible que sea el huésped quien envíe primero la reseña. Si este es el caso, no dudes en cambiar el orden de los pasos.

  1. Obtén los detalles del hilo de reseñas. Proporciona un ID de reserva y recibe los detalles del hilo de reserva (incluido el ID del hilo de reserva) en la respuesta. Solo habrá un hilo. Si la respuesta está vacía, significa que esta reserva no tiene hilo (todavía).

    GET /api/reviews/thread/{reservationId}

  2. Proporciona tu propia reseña de anfitrión.

    POST /api/reviews/airbnb/review

  3. Recupera todos los mensajes para este ID de hilo y busca las reseñas enviadas por el huésped. Debes buscar los siguientes parámetros:  \"Mode\":\"review\" y "Creator\":\"guest\". Si la respuesta está vacía, significa que no se han enviado reseñas ni respuestas a este hilo.

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

  4. Proporciona una respuesta a la reseña del huésped.

    POST /api/reviews/airbnb/review-reply

  5. Recupera todos los mensajes de esta ID de hilo y busca las respuestas enviadas por el huésped. Debes buscar el siguiente parámetro:  \"Mode\":\"reply\".

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

Encontrará más información sobre Reseñas de huéspedes aquí Airbnb. Asegúrese de leerlos antes de seguir adelante.

Si implementaste las Reseñas de huéspedes antes del 25/01/2024, tu flujo puede ser el descrito a continuación. Ten en cuenta que este flujo (solo en lo que respecta a las reseñas) quedará obsoleto a finales de abril de 2024, y todos los usuarios de Rentals United deberán cambiar al Flujo de reseñas de Airbnb recomendado. Podrás seguir utilizando estos métodos para recuperar y enviar mensajes normales a Comunicación con los huéspedes.

  1. Recuperar hilos. Utiliza el método GET /api/messaging/threads. En respuesta, busca el hilo que tiene la información de "CommunicationChannel" = "AirbnbGuestReview".

  2. Recuperar mensajes para el ID de hilo seleccionado. Utiliza el método GET /api/messaging/threads/{id}/messages. En respuesta, recibirás el historial de mensajes.

  3. Enviar un mensaje a la ID de hilo seleccionada. Utiliza el POST /api/messaging/threads/{id}/messages. Utiliza el formato de solicitud requerido para una reseña o respuesta.

 

Reseñas de Booking.com

Los hilos de reseñas de Booking.comestarán disponibles una vez finalizada la reserva. El hilo de reseñas acepta hasta dos mensajes: 1 x reseña del huésped, 1 x respuesta del anfitrión. Siempre es el huésped quien escribe primero la reseña y el anfitrión solo puede enviar la respuesta. Este orden no puede modificarse. Ten en cuenta que el anfitrión solo puede responder a las reseñas con comentarios. En caso de que el huésped solo proporcione la valoración, no es posible responder a dicha reseña. Si intercambias todos los mensajes disponibles para este hilo o pasa el periodo de reseña, el hilo deja de estar disponible y no aceptará más mensajes. Puedes leer más sobre Reseñas de huéspedes aquí.

Flujo de reseñas de Booking.com recomendado

  1. Obtén los detalles del hilo de reseñas. Proporciona un ID de reserva y recibe los detalles del hilo de reserva (incluido el ID del hilo de reserva) en la respuesta. Solo habrá un hilo. Si la respuesta está vacía, significa que esta reserva no tiene hilo (todavía).

    GET /api/reviews/thread/{reservationId}

  2. Recupera todos los mensajes para este ID de hilo y busca las reseñas enviadas por el huésped. Si la respuesta está vacía, significa que no se han enviado reseñas ni respuestas a este hilo.

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

  3. Responde a la reseña del huésped.

    POST /api/reviews/bcom/review-reply

Encontrará más información sobre Reseñas de huéspedes aquí Booking.com. Asegúrese de leerlos antes de seguir adelante.

Si implementaste las Reseñas de huéspedes antes del 25/01/2024, tu flujo puede ser el descrito a continuación. Ten en cuenta que este flujo (solo en lo que respecta a las reseñas) quedará obsoleto a finales de abril de 2024, y todos los usuarios de Rentals United deberán cambiar al Flujo de reseñas de Booking.com recomendado. Podrás seguir utilizando estos métodos para recuperar y enviar mensajes normales a Comunicación con los huéspedes.

  1. Recuperar hilos. Utiliza el método GET /api/messaging/threads. En respuesta, busca el hilo que tiene la información de "CommunicationChannel" = "GuestReview".

  2. Recuperar mensajes para el ID de hilo seleccionado. Utiliza el método GET /api/messaging/threads/{id}/messages. En respuesta, recibirás el historial de mensajes.

  3. Enviar mensaje a la ID de hilo seleccionada. Utiliza el POST /api/messaging/threads/{id}/messages. Utiliza el formato de solicitud requerido para un mensaje.

 

Reseñas de Vrbo

El hilo de revisión Vrbo acepta tres tipos de mensajes:

  • 1 opinión de un invitado: opinión del invitado con texto, valoración por estrellas y valoración por categorías.

  • 1 x valoración - una valoración por estrellas del anfitrión

  • 1 x respuesta del anfitrión: una respuesta del anfitrión a la reseña del huésped que incluye sólo texto

Vrbo El hilo de revisión está disponible una vez finalizada la reserva, lo que significa que usted y su invitado pueden revisar la estancia a partir del día de la salida. Vrbo acepta que tanto el anfitrión como el huésped puedan revisar primero la estancia. Y lo que es más importante, el primer revisor tiene hasta 365 días después del día de salida para iniciar el proceso de revisión. El segundo revisor sólo tiene 14 días para responder. Si transcurre el plazo de revisión, el segundo revisor ya no podrá presentar la respuesta.

Encontrará más información sobre Reseñas de huéspedes aquí Vrbo. Asegúrese de leerlos antes de seguir adelante.

Flujo de reseñas de Vrbo recomendado

  1. Obtén los detalles del hilo de reseñas. Proporciona un ID de reserva y recibe los detalles del hilo de reserva (incluido el ID del hilo de reserva) en la respuesta. Solo habrá un hilo. Si la respuesta está vacía, significa que esta reserva no tiene un hilo de revisión (todavía).

    GET /api/reviews/thread/{reservationId}

  2. Como anfitrión, proporcione su valoración tan pronto como el ID del hilo de revisión esté disponible.

    POST api/reviews/vrbo/rate-guest

  3. Recupere periódicamente todos los mensajes para este ID de hilo y busque la reseña del invitado. Compruebe a continuación qué parámetros indican los diferentes tipos de mensajes aceptados por Vrbo. Si la respuesta está vacía, significa que no se ha enviado ningún mensaje a este hilo.

    • revisión de invitados: "type":"GuestReview"

    • valoración: "type":"GuestRating"

    • respuesta del anfitrión: "type":"GuestReviewReply"

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

  4. Una vez presente la reseña del invitado, puede proporcionar la respuesta del anfitrión, si es necesario.

    POST api/reviews/vrbo/review-reply

  5. Vrbo comprueba el contenido de la respuesta del host. Podrás ver el estado de la respuesta del host en el parámetro "status".

    • "status":"submitted" - la respuesta del anfitrión espera la aprobación de Vrbo

    • "status":"rejected" la respuesta del host fue rechazada por Vrbo, puede enviar otra respuesta del host

    • "status":"approved", Vrbo aceptó la respuesta del anfitrión

Preautorizaciones de Airbnb

Lee más sobre qué son las preautorizaciones y cómo funcionan aquí.

  1. Envía una preautorización utilizando el método POST /api/airbnb/specialOffers.

  2. Retira la preautorización utilizando el método PUT /api/airbnb/specialOffers.

  3. Recupera información sobre preautorizaciones para un hilo específico utilizando el comando GET /api/airbnb/specialOffers.