TripAdvisor Api Toolkit

El TripAdvisor Api Toolkit permite a los usuarios de Nappai acceder a varias funcionalidades de la API de TripAdvisor, como buscar hoteles, restaurantes, atracciones, fotos y reseñas, o obtener detalles de una ubicación. El componente crea un conjunto de herramientas (tools) que pueden ser usadas en flujos de trabajo de automatización.

¿Cómo funciona?

Cuando configuras el componente, Nappai crea un cliente de la API de TripAdvisor con la clave que hayas guardado en la credencial “TripAdvisor API”.
El usuario elige:

1. Moneda y idioma por defecto – estos valores se usan en todas las llamadas a la API.
2. Herramientas a incluir – el componente añade solo las herramientas seleccionadas al toolkit que devuelve.

El resultado es un objeto BaseToolkit que contiene las herramientas configuradas. Este toolkit puede ser pasado a otros componentes que acepten un toolkit, permitiendo que el flujo de trabajo realice búsquedas o recupere información de TripAdvisor sin escribir código adicional.

Entradas

Nota: Este componente necesita una credencial TripAdvisor API.

1. Configura la credencial en la sección de credenciales de Nappai.
2. Selecciona esa credencial en el campo Credential del componente (este campo no aparece en la lista de entradas).

Campos de Entrada

• Default Currency: Selecciona la moneda que se usará en las respuestas de la API.
• Default Language: Selecciona el idioma que se usará en las respuestas de la API.
• Selected Tools: Elige las herramientas que quieres incluir en el toolkit (por ejemplo, “Hotel Search”, “Restaurant Search”, etc.).

Salidas

• BaseToolkit: Un objeto BaseToolkit que contiene las herramientas seleccionadas.
  Este objeto puede ser usado como entrada en otros componentes que requieran un toolkit, como los que ejecutan búsquedas o recuperan datos de TripAdvisor.

Ejemplo de Uso

1. Configura la credencial
   • Ve a Credenciales → Agregar credencial → TripAdvisor API y pega tu clave.
2. Añade el componente
   • Arrastra “TripAdvisor Api Toolkit” al flujo.
   • Selecciona la credencial creada.
   • En Default Currency elige “EUR”.
   • En Default Language elige “en”.
   • En Selected Tools marca “Hotel Search” y “Review tools”.
3. Conecta la salida
   • Conecta la salida BaseToolkit a un componente que ejecute una búsqueda de hoteles, por ejemplo, “Execute Tool”.
4. Ejecuta el flujo
   • El flujo llamará a la API de TripAdvisor y devolverá los hoteles y sus reseñas en euros y en inglés.

Componentes Relacionados

• TripadvisorHotelSearchTool – Busca hoteles por ubicación y criterios.
• TripadvisorReviewsTool – Recupera reseñas de un lugar.
• TripadvisorLocationDetailsTool – Obtiene información detallada de una ubicación.

Consejos y Mejores Prácticas

• Selecciona solo las herramientas que necesites: incluir demasiadas puede hacer que el toolkit sea más pesado y lento.
• Revisa la cuota de la API: la API de TripAdvisor tiene límites de llamadas; usa la herramienta “Geo Search” primero para limitar la zona de búsqueda.
• Mantén la credencial segura: no compartas la clave de API y revísala periódicamente.

Consideraciones de Seguridad

• La clave de API se almacena en la sección de credenciales de Nappai, que está protegida por autenticación y permisos de usuario.
• Asegúrate de que solo los usuarios autorizados tengan acceso a la credencial “TripAdvisor API”.
• Evita exponer la salida del toolkit en logs públicos; la información puede contener datos sensibles de la API.