API de notificaciones

Envía mensajes automáticos para reservar eventos y así simplificar tus operaciones y crecer de forma eficaz

La API de notificaciones te permite integrarte con Rapid API más estrechamente que nunca. Cuando se produzcan cambios en las reservas que puedan afectar a tu negocio o a tus operaciones, la API de notificaciones enviará los detalles del cambio directamente a todas las partes afectadas. Los mensajes pueden ser enviados por los agentes, los proveedores y el propio « Rapid API ». Eso significa que, si un agente del centro de atención al cliente hace algún cambio o un proveedor cancela una reserva, te lo notificarán. Del mismo modo, si la API crea correctamente una nueva reserva, recibirás una notificación que podrás usar para mantener la sincronización con tus sistemas internos.

Nota: En la API de alojamiento, ya admitimos mensajes de agentes, proveedores y el Rapid API. En las API de «Car» y «Activities», ahora mismo admitimos cambios en las reservas realizadas a través de agent-initiated, y pronto admitiremos también los cambios iniciados en Rapid API y por parte de nuestros proveedores.

La API de notificaciones permite una integración perfecta con tu negocio y complementa otros servicios de atención al cliente y a los socios. A medida que vayamos añadiendo características y funcionalidades a Rapid API,, también iremos incorporando nuevos tipos de eventos de notificación para mejorar tu experiencia.

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` », aquí aparecerá 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`. Esta será una lista de etiquetas que, según nuestro análisis, podrían aparecer en el texto del mensaje. >> Más información sobre las etiquetas de los mensajes de propiedad
`line_of_business`	El sector al que pertenece el evento. Valores posibles: `cars`, `flights`, `activities` y `packages` (`properties` estará disponible próximamente). Este campo no se aplica a todos los tipos de eventos. Nota: Este campo está disponible actualmente en las API de Rapid Car, Flight y Activities; la API de Rapid Lodging aún no lo ha incorporado.
`file_name`	El campo « file_name » permite al interlocutor comprobar que se ha adjuntado el archivo correcto a la conversación. Nota: Este campo solo se aplica a los archivos adjuntos enviados a través de la API de Conversation.

Cada notificación es una solicitud de tipo « HTTPS POST » con un cuerpo de mensaje en formato JSON.

Nota:. Tendrás que activar cada tipo de evento por separado para poder recibir ese tipo de notificaciones. Si quieres habilitar un nuevo tipo de evento de notificaciones, contacta con el servicio de asistencia.

Tipos de eventos admitidos

El servicio de notificaciones rápidas envía mensajes proactivos ante los siguientes eventos. Los eventos compatibles varían según las líneas de negocio de Rapid.

API de alojamiento

Eventos compatibles con la API de alojamiento

La API de Rapid Lodging admite todos los eventos siguientes:

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.api.create`	Rapid API	Itinerario creado a través de la API	Una llamada a `Rapid API` ha creado correctamente una nueva reserva. Nota: Realizar llamadas a través de la API te ayuda a mantener una única fuente de información fiable en todos los sistemas, lo que reduce problemas como las «reservas fantasma».
`itinerary.api.create_failed`	Rapid API	No se ha podido crear el itinerario a través de AP	Rapid API: el intento de crear una reserva ha fallado definitivamente.
`itinerary.api.change`	Rapid API	Actualización del itinerario a través de la API	Una llamada al servicio « Rapid API » modificó una reserva ya existente, ya fuera un cambio sustancial (como la habitación, las fechas o el pago) o un cambio menor (como los datos de los huéspedes).
`itinerary.api.cancel`	Rapid API	Itinerario cancelado a través de la API	Una llamada de « Rapid API » canceló 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.payment_verification.failure`	Alojamiento	Enlace para cambiar la forma de pago con tarjeta de crédito	Expedia ha marcado como no válida la tarjeta de pago que el viajero facilitó al hacer la reserva, tras pre-authorization. >> Más información sobre la función «Recaptura de tarjetas de crédito»
`itinerary.supplier.cancel`	Alojamiento	Cancelación de las reservas	El alojamiento ha cancelado una reserva que ya estaba hecha. 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 número de confirmación de la reserva.
`itinerary.supplier.change`	Alojamiento	Actualización de reserva	el alojamiento modifica una reserva ya realizada debido a que el viajero llega más tarde o se marcha antes de lo previsto.
`itinerary.supplier.refund`	Alojamiento	Actualización de reserva	En el caso de « Expedia », el alojamiento está tramitando los reembolsos solicitados por los viajeros. Es obligación del colaborador asegurarse de que el viajero recibe los reembolsos.
`itinerary.traveler.noshow`	Alojamiento	No presentados del viajero	El viajero no apareció; por eso, el alojamiento marcó la reserva como «No show».
`itinerary.traveler.checked_in`	Alojamiento	El viajero se registra en el alojamiento	El viajero se registró en el alojamiento, tal y como lo ha registrado el proveedor.
`itinerary.unspecified.cancel`	Expedia	Reserva cancelada por alguien que no se ha identificado	Esta notificación se envía cuando se cancela una reserva, pero el sistema no puede determinar si la cancelación la ha iniciado el viajero, el alojamiento o el anfitrión, o un agente. Se usa sobre todo para reservas de Vrbo en Rapid API en las que no se puede identificar a la persona que ha cancelado, así como para cancelaciones de itinerarios de vuelo en las que se desconoce quién las ha realizado. Como no está claro quién ha cancelado la reserva, los socios no pueden saber quién la ha cancelado solo con la notificación.
`itinerary.unspecified.change`	Expedia	La reserva la ha modificado alguien sin especificar	Esta notificación se envía cuando se modifica una reserva ya existente (un «cambio definitivo»), pero el sistema no puede determinar si el cambio lo ha iniciado el viajero, el alojamiento o el anfitrión, o bien un agente. Se usa sobre todo para las reservas de Vrbo en Rapid API. Al recibir esta notificación, los socios deben realizar una llamada de «Booking Retrieve» para averiguar qué se ha modificado y consultar los detalles actualizados de la reserva.
`itinerary.message.received`	Alojamiento	Se ha enviado un nuevo mensaje	La propiedad ha enviado un nuevo mensaje a través del Centro de mensajes del alojamiento (PMC) o de la API de conversación. >> Más información sobre nuestras soluciones de conversación
`itinerary.message.rejected`	Socio de demanda / Viajero	Se ha detectado un caso de fraude o phishing	Se bloquea un mensaje enviado por un viajero o por un agente de un socio de demanda porque se ha identificado como fraudulento o de phishing. El mensaje está bloqueado y no se ha enviado.
`itinerary.conversation.attachment.success`	Socio de demanda / Viajero	Se ha subido el archivo adjunto correctamente	Se ha subido correctamente un archivo adjunto enviado por un viajero o un agente de Demand Partner como parte de una conversación, y se ha añadido a la conversación.
`itinerary.conversation.attachment.failure`	Socio de demanda / Viajero	No se ha podido subir el archivo adjunto	Se ha subido un archivo adjunto enviado por un viajero o un agente de Demand Partner como parte de una conversación al bucket de S3, pero no se ha podido subir a la conversación.

Ejemplo de "itinerary.agent.create"

{
     "event_id": "dbacce6c-afcb-4b23-ae66-48050757551c",
     "event_type": "itinerary.agent.create",
     "event_time": "2026-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": "2027-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": "2027-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"
}

Car API

Eventos compatibles con la API de Car

Por ahora, la API de Rapid Car solo admite un tipo de notificación: la cancelación de una reserva. Se están añadiendo más eventos. Los pondremos aquí en cuanto estén disponibles.

Valor event_type	Origen	Evento	Detalles
`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.

Activities API

Eventos compatibles con la API de actividades

Por ahora, la API de Rapid Activities admite dos eventos de notificación. Se están añadiendo más eventos. Los pondremos aquí en cuanto estén disponibles.

Valor event_type	Origen	Evento	Detalles
`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`	Proveedor	Cancelación de las reservas	El proveedor ha cancelado una reserva que ya estaba hecha. El cliente debe ponerse en contacto con el servicio de atención al cliente de tu empresa.

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 una herramienta de prueba de notificaciones que puedes usar para probar tu integración con nuestra API de notificaciones.