Notificaciones

El servicio de Notificaciones Rápidas envía alertas para una serie de eventos de reserva que te permiten simplificar tus 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. Así, si un agente del centro de llamadas hace un cambio o una propiedad cancela una reserva, se te notificará 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 Rápidas puede informar a tus sistemas con un mensaje para 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.payment_verification.failure`	Alojamiento	Enlace de cambio de pago con tarjeta de crédito	La tarjeta de pago proporcionada por el viajero en el momento de la reserva ha sido marcada como no válida por Expedia después de pre-authorization.
`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`	Alojamiento	Cancelación de las reservas	el alojamiento 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`	Alojamiento	Actualización de reserva	el alojamiento ha actualizado el ID de confirmación 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`	Alojamiento	Actualización de reserva	el alojamiento modifica una reserva existente debido a que el viajero ha llegado con retraso o se ha marchado antes de tiempo.
`itinerary.traveler.noshow`	Alojamiento	No presentados del viajero	El viajero no se presentó, por lo que el alojamiento marcó la reserva como No presentado.
`itinerary.supplier.refund`	Alojamiento	Actualización de reserva	Para las reservas de Expedia Collect, la propiedad proporciona los reembolsos solicitados por el viajero. Es obligación del colaborador asegurarse de que el viajero recibe los reembolsos.
`itinerary.message.received`	Alojamiento	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 sobre la Propiedad

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. Para los eventos de tipo `itinerary.message.received`, contendrá el texto real del mensaje del alojamiento. 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. También tenemos un comprobador de notificaciones que puedes utilizar para probar tu integración con nuestra API de notificaciones.