Amadeus API

Amadeus API busca información de viajes en Amadeus: las fechas más baratas para volar entre dos ciudades, hoteles de una ciudad, lugares a partir de un nombre y actividades cerca de un punto del mapa. Le pasas uno o varios elementos con los datos de búsqueda y el componente te los devuelve con los resultados añadidos.

Úsalo en flujos de agencias de viajes, organización de eventos o viajes de empresa, cuando un agente o un proceso necesita datos reales de viaje para responder o preparar una propuesta.

Cuándo usarlo

• Un asistente de una agencia de viajes que propone las fechas más baratas para volar de Madrid a Roma.
• Preparar una lista de hoteles de una ciudad para el viaje de un equipo comercial.
• Completar el código de una ciudad o de un aeropuerto a partir del nombre que escribió el cliente.
• Sugerir actividades cerca del hotel donde se aloja un cliente.

Configuración

Necesitas una credencial Amadeus Travel API con el identificador y la clave de tu cuenta de desarrollador de Amadeus. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Amadeus Travel API.
Input	Los datos de cada búsqueda. Puedes conectar uno o varios elementos: el componente hace una búsqueda por cada uno. Más abajo tienes qué datos necesita cada tipo de búsqueda.
Api Selection (obligatorio)	Qué quieres buscar: Flight Offers Search (vuelos), Hotel Search (hoteles), Location Search (lugares) o Activity Search (actividades).
Default Currency	La moneda de los precios. Por defecto, EUR.
Default Language	El idioma de los resultados. Por defecto, en-US.

Datos de cada búsqueda

Cada elemento que llega a Input debe llevar estos datos, con estos nombres:

Búsqueda	Datos
Flight Offers Search	origin y destination, los códigos de las ciudades (por ejemplo MAD y ROM), y depart_date, la fecha de salida en formato AAAA-MM-DD.
Hotel Search	city_code, el código de la ciudad. Opcionales: rating, las estrellas (por defecto 2), y radius_km, la distancia al centro en kilómetros (por defecto 10).
Location Search	keyword, el nombre que buscas; subtype, el tipo de lugar (por ejemplo CITY o AIRPORT), y countryCode, el código del país (por ejemplo ES).
Activity Search	latitude y longitude del punto, y radius, la distancia en kilómetros.

Resultado

La salida Data devuelve los mismos elementos que recibió, cada uno con un campo nuevo que contiene la lista de resultados:

• flights en la búsqueda de vuelos: fechas de salida con su precio.
• hotels en la búsqueda de hoteles.
• locations en la búsqueda de lugares.
• activities en la búsqueda de actividades, con un máximo de 10 por elemento.

Si Amadeus no encuentra nada o la búsqueda no es válida, la lista llega vacía. Puedes pasar el resultado a un agente para que lo explique al cliente o a un componente que lo convierta en texto.

Ejemplo

Una agencia quiere responder por chat a clientes que preguntan cuándo es más barato volar.

1. Un agente extrae del mensaje del cliente el origen, el destino y la fecha, con los nombres origin, destination y depart_date.
2. Conecta ese resultado a Input de Amadeus API.
3. En Api Selection elige Flight Offers Search y deja Default Currency en EUR.
4. Conecta la salida Data a un agente que redacta la respuesta con las tres fechas más baratas.

Buenas prácticas

• Usa Location Search antes de buscar vuelos u hoteles si tus clientes escriben nombres de ciudades: así obtienes el código que piden las otras búsquedas.
• En Location Search y Activity Search envía todos los datos de la tabla: estas búsquedas no tienen valores por defecto.
• Si una lista llega vacía, revisa que los códigos y la fecha tengan el formato indicado.