INTEGRACIÓN MONGODB n8n: AUTOMATIZAR MONGODB CON N8N

Esta acción actualiza documentos existentes en una colección MongoDB según una clave de identificación. Es particularmente útil para sincronizaciones bidireccionales entre MongoDB y aplicaciones externas, permitiendo mantener datos actualizados sin sobrescribir documentos completos.

Parámetros clave: Collection (campo de texto donde especificas el nombre exacto de la colección MongoDB a actualizar, requerido), Update Key (campo de texto que define el campo por el cual MongoDB identificará documentos a actualizar, requerido), Fields (campo de texto con nombres de campos separados por comas que serán actualizados), Upsert (interruptor on/off que determina si crear un nuevo documento cuando ningún documento coincide, desactivado por defecto).

Casos de uso típicos: Sincronizar cambios desde un CRM cuando un contacto HubSpot se actualiza, actualizar masivamente campos desde Google Sheets leyendo filas y modificando documentos MongoDB, enriquecer documentos con datos externos después de consultar una API.

Esta acción inserta nuevos documentos en una colección MongoDB especificada. Soporta inserción masiva desde arrays y permite definir exactamente qué campos incluir en cada documento creado.

Parámetros clave: Collection (campo de texto para especificar el nombre de la colección MongoDB donde insertar documentos, requerido), Fields (campo de texto con nombres de campos separados por comas que serán incluidos en los documentos insertados, define la estructura de cada documento nuevo).

Casos de uso típicos: Capturar leads desde formularios donde cada envío Typeform o Google Forms inserta automáticamente un documento en MongoDB, importar datos desde webhooks recibiendo eventos de aplicaciones externas, duplicar registros entre sistemas leyendo documentos desde una API REST y replicándolos en MongoDB.

Esta acción busca un documento específico según una clave de identificación y lo actualiza en una sola operación atómica. Garantiza que la búsqueda y actualización ocurren sin condiciones de carrera, ideal para workflows concurrentes.

Parámetros clave: Collection (campo de texto para especificar la colección MongoDB objetivo, requerido), Update Key (campo de texto que define el campo por el cual identificar el documento a actualizar, requerido), Fields (campos separados por comas a actualizar, define qué propiedades modificar), Upsert (interruptor on/off para crear documento si ninguno coincide, desactivado por defecto).

Casos de uso: Actualizar estado de pedidos buscando pedido por ID y modificando su status cuando un evento externo ocurre, sincronización transaccional garantizando que actualizaciones concurrentes desde múltiples workflows no generen inconsistencias.

Esta acción localiza un documento según una clave y reemplaza completamente su contenido con nuevos valores. A diferencia de Update, sobreescribe todo el documento (excepto _id), no solo campos especificados.

Parámetros clave: Collection (campo de texto para especificar la colección MongoDB, requerido), Update Key (campo de texto que identifica el documento a reemplazar, requerido), Fields (campos separados por comas que conformarán el nuevo contenido del documento, define la estructura completa del documento reemplazado), Upsert (interruptor on/off para insertar si no existe, desactivado por defecto).

Casos de uso: Reimportar configuraciones reemplazando completamente documentos de configuración con nuevas versiones desde archivos externos, reset de documentos sobrescribiendo documentos obsoletos con estructuras actualizadas sin preocuparse por campos legacy.

Esta acción ejecuta queries de búsqueda en colecciones MongoDB, permitiendo filtrar, ordenar y limitar resultados mediante queries JSON complejas. Retorna un array de documentos coincidentes que pueden procesarse por nodos posteriores.

Parámetros clave: Collection (campo de texto para especificar la colección MongoDB a consultar, requerido), Query (JSON Format) (editor JSON donde defines criterios de búsqueda MongoDB, acepta toda la sintaxis de query operators de MongoDB, campo requerido, acepta {} para retornar todos los documentos).

Casos de uso típicos: Buscar registros para procesar consultando documentos con status pending y ejecutar acciones sobre cada uno, generar reportes buscando documentos dentro de rangos de fecha y exportar resultados a Google Sheets, validaciones condicionales buscando si documentos con ciertos criterios existen antes de ejecutar acciones downstream.

Esta acción elimina documentos de una colección MongoDB según una query JSON que define criterios de selección. Soporta eliminación masiva cuando múltiples documentos coinciden con la query.

Parámetros clave: Collection (campo de texto para especificar la colección MongoDB de la cual eliminar documentos, requerido), Delete Query (JSON Format) (área de texto multilínea donde ingresas una query MongoDB en formato JSON que define qué documentos eliminar, requerido, un objeto vacío {} eliminaría TODOS los documentos de la colección, usar con extrema precaución).

Casos de uso: Limpieza automática de datos obsoletos eliminando documentos con timestamps antiguos cada noche mediante workflows programados, gestión de datos temporales borrando registros de sesiones o caches expirados, sincronización de eliminaciones cuando un registro se elimina en una aplicación externa eliminando automáticamente su documento correspondiente en MongoDB.

Esta acción ejecuta pipelines de agregación MongoDB, permitiendo transformaciones complejas, agrupaciones, cálculos estadísticos y joins sobre documentos. Es la herramienta más poderosa para análisis de datos directamente desde n8n.

Parámetros clave: Collection (campo de texto para especificar la colección MongoDB sobre la cual ejecutar la agregación, requerido), Query (editor de código donde escribes el pipeline de agregación en formato array de stages MongoDB, acepta sintaxis completa de aggregation framework, requerido, debe ser un array válido de stages).

Casos de uso: Generar reportes automatizados ejecutando agregaciones cada noche para calcular KPIs, análisis en tiempo real combinando con triggers programados para ejecutar agregaciones recurrentes y exportar resultados a dashboards, transformaciones ETL procesando documentos brutos y aplicando cálculos complejos.

Esta acción actualiza la definición de un índice de búsqueda existente en MongoDB Atlas Search, permitiendo modificar mappings de campos, configuraciones de analizadores y propiedades de índices vectoriales sin recrearlos.

Parámetros clave: Collection (campo de texto para especificar la colección que contiene el índice a actualizar, requerido), Index Name (campo de texto con el nombre exacto del índice de búsqueda existente a modificar, requerido), Index Definition (editor JSON donde defines la nueva estructura del índice, acepta formato completo de Atlas Search index definition, requerido).

Casos de uso: Ajustar índices dinámicamente modificando mappings cuando el esquema de documentos evoluciona sin interrumpir búsquedas en producción, optimizar configuraciones actualizando analizadores, tokenizers o filtros para mejorar relevancia de resultados de búsqueda.

Esta acción lista todos los índices de búsqueda Atlas configurados en una colección MongoDB, retornando nombres, definiciones y estado de cada índice. Útil para auditorías y monitoreo de configuraciones.

Parámetros clave: Collection (campo de texto para especificar la colección cuyo(s) índice(s) de búsqueda listar, requerido), Index Name (opcional, campo de texto para filtrar por un nombre de índice específico, si se deja vacío lista todos los índices de la colección).

Casos de uso: Auditoría de configuraciones verificando periódicamente qué índices están activos y sus definiciones para documentación o compliance, monitoreo automatizado combinando con notificaciones para alertar cuando índices esperados no existen o configuraciones cambian inesperadamente.

Esta acción elimina permanentemente un índice de búsqueda Atlas de una colección MongoDB. Operación irreversible que libera recursos pero desactiva capacidades de búsqueda asociadas al índice eliminado.

Parámetros clave: Collection (campo de texto para especificar la colección de la cual eliminar el índice, requerido), Index Name (campo de texto con el nombre exacto del índice a eliminar, requerido para identificar el índice correcto sin ambigüedad).

Casos de uso: Limpieza de infraestructura eliminando índices obsoletos o no utilizados para reducir costos de almacenamiento y mantenimiento en Atlas, migración de configuraciones eliminando índices antiguos antes de recrearlos con nuevas definiciones optimizadas.

Esta acción crea un nuevo índice de búsqueda Atlas en una colección MongoDB, habilitando capacidades de búsqueda full-text, búsqueda vectorial o búsquedas facetadas según la definición proporcionada.

Parámetros clave: Collection (campo de texto para especificar la colección en la cual crear el índice, requerido), Index Name (campo de texto para asignar un nombre único al índice nuevo, requerido), Index Definition (editor JSON donde defines la estructura completa del índice, acepta formato Atlas Search index definition, por defecto muestra {} pero requiere definición válida), Index Type (menú desplegable para seleccionar el tipo de índice a crear, opciones incluyen Vector Search y Search, determina capacidades del índice).

Casos de uso: Habilitar búsquedas inteligentes creando índices full-text para permitir búsquedas con autocompletado y fuzzy matching, implementar búsqueda vectorial configurando índices para búsquedas de similitud semántica sobre embeddings, automatizar aprovisionamiento de infraestructura con workflows que crean índices automáticamente al configurar nuevas colecciones o entornos.