INTEGRACIÓN AIRTOP n8n: AUTOMATIZAR AIRTOP CON N8N

Esta acción te permite iniciar una nueva ventana de navegador dentro de una sesión de Airtop existente. Es el punto de partida fundamental para cualquier tarea de navegación automatizada, ya que establece el contexto donde se ejecutarán todas las interacciones posteriores.

Parámetros clave:

• Credential to connect with: Selecciona las credenciales de tu cuenta Airtop desde el menú desplegable. Requerido.
• Resource: Debe configurarse como "Window" para indicar que trabajas con ventanas de navegador. Requerido.
• Session ID: Identificador de la sesión activa donde se creará la ventana. Acepta expresiones para referenciar datos de nodos anteriores. Requerido.
• URL: La dirección web inicial que cargará la ventana (formato: https://ejemplo.com). Requerido.
• Get Live View: Interruptor on/off para habilitar la visualización en tiempo real de la ventana. Opcional.
• Additional Fields: Sección para añadir configuraciones adicionales según necesites.

Casos de uso típicos: Abrir páginas de productos para extraer información de precios, iniciar sesiones en aplicaciones web antes de automatizar interacciones, cargar dashboards para captura de screenshots programados, preparar múltiples ventanas para scraping paralelo.

Esta acción cierra una ventana de navegador específica dentro de tu sesión de Airtop. Es esencial para liberar recursos y mantener tus sesiones organizadas, especialmente en workflows que gestionan múltiples ventanas simultáneamente.

Parámetros clave:

• Credential to connect with: Credenciales de tu cuenta Airtop. Requerido.
• Resource: Configurado como "Window". Requerido.
• Operation: Selecciona "Close Window" para ejecutar el cierre. Requerido.
• Session ID: Expresión JSON que referencia el identificador de sesión ({{ $json["sessionId"] }}). Requerido.
• Window ID: Expresión JSON para identificar la ventana específica a cerrar ({{ $json["windowId"] }}). Requerido.

Casos de uso: Cerrar ventanas después de completar la extracción de datos, limpiar ventanas temporales en workflows de múltiples pasos, gestionar recursos en sesiones de larga duración.

Permite obtener una vista en tiempo real de lo que está ocurriendo en una ventana de navegador activa. Especialmente útil para debugging, monitoreo y verificación visual de automatizaciones.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "Window". Requerido.
• Operation: "Get Live View". Requerido.
• Session ID: Identificador de sesión mediante expresión JSON. Requerido.
• Window ID: Identificador de la ventana a visualizar. Requerido.
• Additional Fields: Configuraciones extra disponibles según necesidad.

Casos de uso: Verificar visualmente que las automatizaciones funcionan correctamente, debugging de workflows de scraping que fallan, monitoreo de procesos de navegación complejos.

Carga una URL específica en una ventana de navegador ya existente. Permite navegar a diferentes páginas sin crear nuevas ventanas, optimizando el uso de recursos.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: "Window". Requerido.
• Operation: "Load URL". Requerido.
• Session ID: Referencia al ID de sesión activa. Requerido.
• Window ID: Identificador de la ventana donde cargar la URL. Requerido.
• URL: Dirección web a cargar (puede ser fija o dinámica via expresiones). Requerido.

Casos de uso: Navegar secuencialmente por múltiples páginas de un sitio, cargar URLs dinámicas generadas en pasos anteriores del workflow, implementar paginación en tareas de scraping.

Captura una imagen de la ventana de navegador actual. Ideal para documentación, verificación visual, auditorías y generación de reportes visuales automatizados.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "Window". Requerido.
• Session ID: Identificador de sesión mediante expresión JSON. Requerido.
• Window ID: Ventana a capturar. Requerido.
• Output Binary Image: Interruptor para determinar si el resultado se devuelve como datos binarios. Opcional.

Casos de uso: Documentar el estado de páginas web en momentos específicos, crear reportes visuales de monitoreo de competencia, generar pruebas visuales para auditorías de compliance, capturar dashboards para envío automático por email.

Obtiene un listado de todas las ventanas activas dentro de una sesión específica. Útil para gestionar múltiples ventanas y orquestar workflows complejos.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: "Window". Requerido.
• Operation: "List Windows". Requerido.
• Session ID: Identificador de la sesión a consultar. Requerido.

Casos de uso: Inventariar ventanas activas antes de ejecutar operaciones, implementar lógica condicional basada en el número de ventanas abiertas, debugging de workflows con múltiples ventanas.

Finaliza completamente una sesión de Airtop, cerrando todas las ventanas asociadas y liberando todos los recursos. Acción crítica para el cierre limpio de workflows.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "Session". Requerido.
• Operation: "Terminate Session". Requerido.
• Session ID: Identificador de la sesión a terminar mediante expresión JSON. Requerido.

Casos de uso: Cerrar sesiones al finalizar workflows de scraping, liberar recursos en casos de error manejado, implementar timeouts de seguridad en automatizaciones.

Guarda el perfil del navegador (cookies, almacenamiento local, etc.) al terminar la sesión. Permite mantener estado entre ejecuciones para sesiones autenticadas.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: "Session". Requerido.
• Operation: "Save Profile on Termination". Requerido.
• Session ID: Identificador de sesión mediante expresión. Requerido.
• Profile Name: Nombre para identificar el perfil guardado. Requerido.

Casos de uso: Mantener sesiones autenticadas entre ejecuciones de workflows, preservar preferencias de navegación para tareas recurrentes, evitar re-autenticación en sitios web.

Inicia una nueva sesión de navegador en Airtop con configuraciones personalizadas. Es la acción inicial obligatoria para cualquier workflow de navegación automatizada.

Parámetros clave:

• Credential to connect with: Credenciales Airtop para autenticación. Requerido.
• Resource: "Session". Requerido.
• Operation: "Create Session". Requerido.
• Profile Name: Nombre opcional para el perfil de sesión (formato: my-x-profile). Opcional.
• Save Profile: Interruptor para guardar el perfil al finalizar. Opcional.
• Record Session: Activar grabación de la sesión. Opcional.
• Idle Timeout: Tiempo en segundos antes de timeout por inactividad (default: 10). Requerido.
• Proxy: Selección de proxy si es necesario (default: None). Opcional.
• Additional Fields: Campos adicionales configurables.

Casos de uso: Iniciar sesiones con perfiles persistentes para sitios autenticados, configurar proxies para scraping geolocalizado, establecer timeouts apropiados según la complejidad del workflow.

Pausa el workflow hasta que se complete una descarga en la sesión activa. Esencial para automatizaciones que involucran descarga de archivos.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "Session". Requerido.
• Operation: "Wait for Download". Requerido.
• Session ID: Identificador de sesión para monitorear. Requerido.
• Additional Fields: Configuraciones adicionales disponibles.

Casos de uso: Automatizar descarga de reportes desde aplicaciones web, sincronizar workflows que dependen de archivos descargados, implementar flujos de exportación de datos.

Permite escribir texto en elementos de la página web, simulando la escritura de un usuario. Fundamental para interacciones con formularios y campos de búsqueda.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: "Interaction". Requerido.
• Session ID: Identificador de sesión. Requerido.
• Window ID: Identificador de la ventana. Requerido.
• Text: Texto a escribir en el elemento. Campo de texto.
• Element Description: Descripción del elemento donde escribir. Opcional.
• Additional Fields: Configuraciones extra disponibles.

Casos de uso: Rellenar campos de búsqueda automáticamente, completar formularios de login, introducir datos en aplicaciones web.

Rellena múltiples campos de un formulario web de una sola vez. Más eficiente que múltiples acciones de escritura individual para formularios complejos.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "Interaction". Requerido.
• Operation: "Fill Form". Requerido.
• Session ID: Identificador de sesión mediante expresión. Requerido.
• Window ID: Identificador de ventana. Requerido.
• Form Data: Datos del formulario en formato estructurado. Acepta expresiones. Requerido.

Casos de uso: Automatizar registro en múltiples plataformas, completar formularios de solicitud con datos de CRM, enviar formularios de contacto automáticamente.

Simula un clic en un elemento específico de la página web. Esencial para navegar por interfaces, activar botones y desencadenar acciones.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: "Interaction". Requerido.
• Operation: "Click an Element". Requerido.
• Session ID: Identificador de sesión. Requerido.
• Window ID: Identificador de ventana. Requerido.
• Element Description: Descripción del elemento a clickear. Opcional.
• Additional Fields: Configuraciones adicionales.

Casos de uso: Hacer clic en botones de "Siguiente página" para paginación, activar menús desplegables, enviar formularios mediante botones de submit, navegar por interfaces de aplicaciones web.

Ejecuta scroll en la página, ya sea automático o hacia elementos específicos. Necesario para cargar contenido dinámico y acceder a elementos fuera del viewport.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "Interaction". Requerido.
• Operation: "Scroll". Requerido.
• Session ID: Identificador de sesión. Requerido.
• Window ID: Identificador de ventana. Requerido.
• Scroll Mode: Modo de scroll (ejemplo: "Automatic"). Requerido.
• Element Description: Descripción del elemento hacia donde hacer scroll. Opcional.
• Additional Fields: Configuraciones extra.

Casos de uso: Cargar contenido de páginas con infinite scroll, navegar a secciones específicas de páginas largas, revelar elementos lazy-loaded antes de interactuar.

Simula el movimiento del ratón sobre un elemento, activando estados hover. Útil para revelar menús desplegables y tooltips.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: "Interaction". Requerido.
• Operation: "Hover on an Element". Requerido.
• Session ID: Identificador de sesión. Requerido.
• Window ID: Identificador de ventana. Requerido.
• Element Description: Descripción del elemento sobre el cual hacer hover. Opcional.

Casos de uso: Revelar menús de navegación ocultos, mostrar tooltips para captura de información, preparar elementos antes de hacer clic.

Elimina un archivo específico almacenado en Airtop. Importante para la gestión de recursos y limpieza de archivos temporales.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "File". Requerido.
• Operation: "Delete". Requerido.
• File ID: Identificador del archivo a eliminar. Acepta expresiones. Requerido.

Casos de uso: Limpiar archivos temporales después del procesamiento, gestionar almacenamiento en workflows de alto volumen, eliminar capturas o descargas obsoletas.

Carga un archivo en el contexto de una ventana de navegador. Permite trabajar con archivos dentro de las automatizaciones de navegación.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: "File". Requerido.
• Operation: "Load". Requerido.
• Session ID: Identificador de sesión. Requerido.
• Window ID: Identificador de ventana. Requerido.
• File ID: Identificador del archivo a cargar. Opcional.
• Include Hidden Elements: Interruptor para incluir elementos ocultos. Opcional.

Casos de uso: Cargar archivos para upload en formularios web, preparar documentos para procesamiento automatizado, trabajar con archivos descargados previamente.

Sube un archivo a Airtop desde una URL externa. Permite integrar archivos de otras fuentes en tus workflows de navegación.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "File". Requerido.
• Operation: "Upload". Requerido.
• Session ID: Identificador de sesión. Requerido.
• Window ID: Identificador de ventana. Requerido.
• File Name: Nombre para el archivo. Opcional.
• File Type: Tipo de archivo (default: "Customer Upload"). Requerido.
• Source: Fuente del archivo (ejemplo: URL). Requerido.
• URL: URL del archivo a subir. Requerido.

Casos de uso: Subir archivos desde Google Drive o almacenamiento en la nube a formularios web, automatizar upload de imágenes o documentos, integrar archivos de fuentes externas en workflows.

Recupera información de un archivo específico almacenado en Airtop, con opción de obtenerlo como datos binarios.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: "File". Requerido.
• Operation: "Get". Requerido.
• File ID: Identificador del archivo a recuperar. Requerido.
• Output Binary File: Interruptor para obtener el archivo como binario. Opcional.

Casos de uso: Obtener archivos descargados para procesamiento posterior, recuperar screenshots capturados, acceder a archivos para envío por email o almacenamiento.

Recupera múltiples archivos de Airtop con soporte para paginación y filtros por sesión.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "File". Requerido.
• Operation: "Get Many". Requerido.
• Return All: Interruptor para retornar todos los registros. Opcional.
• Limit: Número máximo de archivos a recuperar. Opcional.
• Session IDs: IDs de sesión separados por coma para filtrar. Opcional.
• Output Files in Single Item: Combinar archivos en un solo item. Opcional.

Casos de uso: Listar todos los screenshots de una sesión, procesar lotes de archivos descargados, auditar archivos generados por workflows.

Extrae datos estructurados de una página utilizando prompts de IA con soporte para paginación automática. Una de las acciones más potentes para scraping inteligente.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: Tipo de recurso para la operación. Requerido.
• Operation: "Query Page with Pagination". Requerido.
• Session Mode: Modo de sesión (ejemplo: "Use Existing Session"). Requerido.
• Session ID: Identificador de sesión activa. Requerido.
• Window ID: Identificador de la ventana a consultar. Requerido.
• Prompt: Instrucciones para la extracción de datos. Opcional.
• Additional Fields: Campos adicionales configurables.

Casos de uso: Extraer listados de productos con paginación automática, scraping de directorios y resultados de búsqueda, recopilar datos de tablas extensas.

Ejecuta extracción inteligente de datos utilizando el motor de scraping avanzado de Airtop. Ideal para sitios complejos que requieren interpretación contextual.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "Extraction". Requerido.
• Operation: "Smart Scrape". Requerido.
• Session Mode: Configuración de sesión. Requerido.
• Session ID: Identificador de sesión mediante expresión JSON. Requerido.
• Window ID: Identificador de ventana. Requerido.

Casos de uso: Extraer información de páginas con estructura variable, scraping de contenido dinámico generado por JavaScript, recopilar datos de sitios sin estructura HTML predecible.

Extrae datos de una página específica utilizando prompts de IA para guiar la extracción.

Parámetros clave:

• Credential to connect with: Credenciales de autenticación. Requerido.
• Resource: "Extraction". Requerido.
• Operation: "Query Page". Requerido.
• Session Mode: Modo de sesión a utilizar. Requerido.
• Session ID: Identificador de sesión. Requerido.
• Window ID: Identificador de ventana. Requerido.
• Prompt: Instrucciones específicas para la extracción. Opcional.
• Additional Fields: Campos adicionales según necesidad.

Casos de uso: Extraer datos específicos de páginas de detalle de productos, obtener información estructurada de perfiles o fichas, recopilar datos puntuales sin necesidad de paginación.

Ejecuta un agente de IA de Airtop que puede realizar tareas complejas de navegación de forma autónoma.

Parámetros clave:

• Credential to connect with: Credenciales Airtop. Requerido.
• Resource: "Agent". Valor fijo.
• Operation: "Run". Valor fijo.
• Webhook URL: URL para recibir notificaciones de callback. Opcional.
• Parameters: Parámetros personalizados para el agente. Campo de texto.
• Await Agent: Interruptor para esperar la finalización del agente. Opcional (default: off).
• Timeout: Tiempo máximo de espera en segundos (default: 600). Requerido.

Casos de uso: Ejecutar tareas de navegación complejas que requieren toma de decisiones, automatizar procesos de múltiples pasos en aplicaciones web, implementar bots inteligentes que interactúan con interfaces complejas, delegar tareas de investigación web a agentes autónomos.