Notificaciones
El servicio de notificaciones de Rapid envía alertas sobre una serie de eventos de reserva para ayudarte a simplificar las operaciones y escalar eficazmente.
El servicio de notificaciones de Rapid te permite integrarte más que nunca con la aplicación. Cuando se produzcan cambios en reservas que puedan causar algún impacto en tu negocio o tus operaciones, la API de notificaciones volcará los detalles del cambio directamente en tus sistemas mediante mensajes POST estándar. Con estas notificaciones, podrás estar al día, simplificar las operaciones y aumentar tu volumen de negocio.
Actualmente admitimos notificaciones de todos los eventos de reservas que tengan lugar fuera de nuestra API. De esta manera, si un agente del centro de llamadas realiza un cambio o un hotel cancela una reserva, recibirás una notificación inmediatamente.
A medida que añadimos características y funcionalidades a Rapid API, solemos incluir también nuevos tipos de eventos de notificación para mejorar tu experiencia.
Mediante una integración fluida con tu empresa, estas notificaciones sirven para complementar Rapid API, Affiliate Voyager y otros servicios de atención al cliente y al colaborador.
Tipos de eventos admitidos
El servicio de notificaciones de Rapid puede informar a tus sistemas mediante un mensaje relacionado con los siguientes eventos:
| Valor event_type | Origen | Evento | Detalles |
|---|---|---|---|
itinerary.agent.create | Agente de atención al cliente o Affiliate Voyager | Creación de reserva | Un agente de atención al cliente de Rapid o Affiliate Voyager ha creado una reserva. |
itinerary.agent.change | Agente de atención al cliente o Affiliate Voyager | Actualización de reserva | Un agente de atención al cliente de Rapid o Affiliate Voyager ha actualizado una reserva existente. |
itinerary.agent.cancel | Agente de atención al cliente o Affiliate Voyager | Cancelación de las reservas | Un agente de atención al cliente de Rapid o Affiliate Voyager ha cancelado una reserva existente. |
itinerary.supplier.cancel | Hotel | Cancelación de las reservas | El hotel ha cancelado una reserva existente. El cliente debe ponerse en contacto con el servicio de atención al cliente de tu empresa. |
itinerary.supplier.confirm | Hotel | Actualización de reserva | El hotel ha actualizado el ID de confirmación del alojamiento de la reserva. |
itinerary.fraud.cancel | Expedia | Cancelación de las reservas | Expedia ha cancelado una reserva existente porque no cumplía los términos y condiciones aplicables a la transacción. El cliente tendrá que ponerse en contacto con transactionprocessing@travelscape.com para comunicar su número de teléfono y la mejor hora para hablar sobre la cancelación. |
itinerary.supplier.change | Proveedor | Actualización de reserva | El hotel modifica una reserva existente por un retraso en la llegada o la salida anticipada del viajero. |
itinerary.traveler.noshow | Proveedor | No presentados del viajero | El viajero no se ha presentado y el proveedor ha marcado la reserva como No presentado. |
itinerary.supplier.refund | Proveedor | Actualización de reserva | Para las reservas de Expedia Collect, el hotel proporciona los reembolsos que solicitan los viajeros. Es obligación del colaborador asegurarse de que el viajero recibe los reembolsos. |
itinerary.message.received | Hotel | Nuevo mensaje a través del centro de mensajes del alojamiento | El alojamiento ha enviado un mensaje nuevo a través del centro de mensajes del alojamiento. Este evento incluirá el texto completo del mensaje del alojamiento, así como los temas generales del mensaje. Será posible acceder a los mensajes desde la notificación, el correo electrónico y el centro de mensajes del alojamiento. Nota: Necesitas tener integrado el centro de mensajes del alojamiento para recibir este tipo de notificaciones. Más información sobre el centro de mensajes del alojamiento aquí |
Esquema y detalles del evento
Todos los eventos de notificación POST se ajustan al esquema que se describe a continuación. Es posible que el esquema varíe a medida que se añadan nuevos tipos de eventos diferentes.
| Objeto | Descripción |
|---|---|
event_id | Identificador único para cada evento. |
event_type | Una indicación sobre qué evento ha generado la notificación. Este valor se puede utilizar para gestionar y enrutar los mensajes. Consulta la lista de tipos de eventos para obtener más información. |
event_time | Marca de hora de la notificación del evento en UTC. |
itinerary_id | El ID del itinerario de la reserva afectada. |
email | La dirección de correo electrónico del cliente que esté asociada al itinerario afectado. |
message | Información sobre el evento de notificación. En el caso de los eventos de tipo itinerary.message.received, incluirá el texto real del mensaje del proveedor. En los demás tipos de eventos, será una descripción estática del evento en inglés y fácil de entender. |
affiliate_reference_id | El número de referencia del afiliado de la reserva afectada. |
topic_tags | Las etiquetas temáticas del evento. Solo se proporcionarán en eventos de tipo itinerary.message.received. Se tratará de una lista de etiquetas que nuestro análisis ha determinado que pueden estar presentes en el texto del mensaje. |
Cada notificación es una solicitud POST HTTPS con un cuerpo de mensaje JSON.
Importante: Para poder recibir estos tipos de notificaciones, debes tener habilitado cada tipo de evento de forma individual. Si quieres habilitar un nuevo tipo de evento de notificaciones, contacta con el servicio de asistencia.
Ejemplo de "itinerary.agent.create"
{
"event_id": "dbacce6c-afcb-4b23-ae66-48050757551c",
"event_type": "itinerary.agent.create",
"event_time": "2017-08-09T16:47:32.039Z",
"itinerary_id": "8091234567890",
"email": "customer@example.com",
"message": "An agent created a new itinerary.",
"affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
}Ejemplo de "itinerary.supplier.confirm"
{
"event_id": "e02d6f41-4708-476f-915d-8a7032942e94",
"event_type": "itinerary.supplier.confirm",
"event_time": "2018-04-28T20:31:03.423Z",
"itinerary_id": "8999989898988",
"email": "alice@example.com",
"message": "The supplier confirmed one or more rooms on this itinerary.",
"affiliate_reference_id": "R194193582",
"rooms": [
{
"confirmation_id": {
"expedia": "926784314",
"property": "BEF23123AA"
}
},
{
"confirmation_id": {
"expedia": "926784315"
}
}
]
}Ejemplo de "itinerary.message.received"
{
"event_id": "1aed5641-7285-4c42-b079-f5f2f139d148",
"event_type": "itinerary.message.received",
"event_time": "2023-11-14T02:33:18.860105363Z",
"itinerary_id": "9025254271673",
"email": "john@email.com",
"message": " We accept your request for a river view room. You will be able to check in at 11:00 AM. Please also note that the pool will be closed for scheduled maintenance on the day of your arrival, it will be open normal hours (9 AM to 10 PM) for the remainder of your stay. Looking forward to your visit.",
"topic_tags": "Check-in, Property/Amenity Closure",
"affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac"
}Detalles de la API
Explora las definiciones de los puntos de conexión relacionados con las notificaciones en esta página y usa API Explorer u otro software de pruebas para ver la diferencia entre los ejemplos y las definiciones de esquemas, y el resultado real.
Pasos siguientes
Ponte en contacto con tu representante de Expedia Group hoy mismo para iniciar la integración del servicio de notificaciones.
Explora las definiciones de los puntos de conexión relacionados con las notificaciones en esta página y usa API Explorer u otro software de pruebas para ver la diferencia entre los ejemplos y las definiciones de esquemas, y el resultado real.