INTÉGRATION MONGODB n8n : AUTOMATISER MONGODB AVEC N8N

L'action "Aggregate documents" vous permet d'exécuter des pipelines d'agrégation MongoDB directement depuis n8n. C'est la fonctionnalité la plus puissante pour transformer, grouper et analyser vos données en une seule opération.

Paramètres de configuration : Credential to connect with (menu déroulant requis), Resource (défini sur "Document"), Operation (défini sur "Aggregate"), Collection (champ texte requis pour spécifier la collection cible), Query (éditeur de code pour votre pipeline d'agrégation en syntaxe MongoDB, accepte un tableau de stages).

Cas d'usage typiques : Calculer des statistiques (somme des ventes par mois, moyenne des scores par catégorie), grouper des données par critères multiples pour des rapports, transformer des structures de documents complexes avant export, créer des vues agrégées pour alimenter des dashboards.

Quand l'utiliser : Privilégiez cette action dès que vous avez besoin de traiter des données en masse avec des transformations complexes — regroupements, calculs, filtres avancés — plutôt que de récupérer des documents individuels.

L'action "Find documents" est votre outil de recherche principal. Elle vous permet de récupérer des documents depuis une collection MongoDB selon des critères que vous définissez en JSON.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Document"), Operation (défini sur "Find"), Collection (champ texte requis), Query (JSON Format) (éditeur JSON pour définir vos critères de recherche, un objet vide {} retourne tous les documents), Options (section extensible pour paramètres optionnels comme limite, tri, projection).

Cas d'usage typiques : Récupérer tous les clients d'une région spécifique pour un mailing ciblé, extraire les commandes en attente pour déclencher des relances automatiques, synchroniser des données MongoDB vers Google Sheets ou Airtable, alimenter des notifications personnalisées basées sur des critères précis.

Quand l'utiliser : C'est l'action de base pour toute lecture de données. Utilisez-la en début de workflow pour récupérer les informations à traiter, ou pour vérifier l'existence de documents avant d'autres opérations.

L'action "Insert documents" vous permet d'ajouter de nouveaux documents dans une collection MongoDB. Parfait pour alimenter votre base de données depuis n'importe quelle source connectée à n8n.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Document"), Operation (défini sur "Insert"), Collection (champ texte requis), Fields (liste des champs à insérer séparés par virgules, ex: "name,description,email", extraits des données entrantes du workflow), Options (paramètres optionnels supplémentaires).

Cas d'usage typiques : Créer automatiquement un document client depuis un formulaire Typeform, archiver des données de webhooks entrants, dupliquer des enregistrements d'une autre base vers MongoDB, logger des événements système pour analyse ultérieure.

Quand l'utiliser : Dès que vous avez besoin de créer de nouvelles entrées dans votre base. Combine particulièrement bien avec les triggers d'autres applications (nouveau lead, nouvelle commande, nouveau message...).

L'action "Update documents" modifie plusieurs documents existants qui correspondent à vos critères. Idéale pour les mises à jour en masse.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Document"), Operation (défini sur "Update"), Collection (requis), Update Key (champ utilisé pour identifier les documents, ex: "id"), Fields (liste des champs à mettre à jour séparés par virgules), Upsert (interrupteur on/off, crée un nouveau document si aucun correspondant n'est trouvé, désactivé par défaut), Options (paramètres additionnels optionnels).

Cas d'usage typiques : Mettre à jour le statut de toutes les commandes d'un client, synchroniser des modifications depuis votre CRM comme HubSpot vers MongoDB, actualiser des données de prix en masse depuis un fichier Excel, marquer des documents comme "traités" après une opération.

Quand l'utiliser : Quand vous devez modifier plusieurs documents simultanément selon un critère commun. Pour des mises à jour unitaires plus ciblées, préférez "Find and update document".

L'action "Find and update document" recherche UN document spécifique et le met à jour. Plus précise que "Update documents", elle garantit une modification ciblée.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Document"), Operation (défini sur "Find And Update"), Collection (requis), Update Key (champ d'identification du document requis, ex: "id"), Fields (champs à mettre à jour séparés par virgules), Upsert (si activé, crée le document s'il n'existe pas), Options (paramètres supplémentaires).

Cas d'usage typiques : Mettre à jour le profil d'un utilisateur spécifique après une action, modifier une commande précise suite à un changement de statut, actualiser un document de configuration unique, incrémenter un compteur sur un document identifié.

Quand l'utiliser : Privilégiez cette action pour les opérations de mise à jour unitaires où vous connaissez l'identifiant exact du document. Plus sécurisée que "Update documents" car elle ne risque pas de modifier accidentellement plusieurs enregistrements.

L'action "Find And Replace" localise un document et le remplace entièrement par les nouvelles données. Contrairement à "Update" qui modifie des champs, celle-ci substitue tout le document.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Document"), Operation (défini sur "Find And Replace"), Collection (requis), Update Key (champ pour identifier le document à remplacer requis, ex: "id"), Fields (champs du nouveau document séparés par virgules), Upsert (crée le document si non trouvé, désactivé par défaut), Options (paramètres additionnels).

Cas d'usage typiques : Remplacer complètement une fiche produit avec de nouvelles données, écraser un document de cache avec des informations fraîches, substituer une configuration système entière, réinitialiser un document à son état par défaut.

Quand l'utiliser : Réservez cette action aux cas où vous voulez remplacer TOUT le contenu d'un document. Pour modifier seulement certains champs en conservant les autres, utilisez plutôt "Update" ou "Find and update".

L'action "Delete documents" supprime des documents de votre collection selon une requête JSON. Puissante mais à utiliser avec précaution.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Document"), Operation (défini sur "Delete"), Collection (requis), Delete Query (JSON Format) (requête JSON définissant les documents à supprimer, requis, attention : un objet vide {} supprime TOUS les documents).

Cas d'usage typiques : Purger les logs de plus de 30 jours automatiquement, supprimer les documents marqués "à effacer", nettoyer les données de test après validation, archiver puis supprimer les anciennes commandes.

Quand l'utiliser : Pour les opérations de maintenance et nettoyage de données. Testez toujours votre requête avec "Find documents" avant de l'utiliser dans "Delete" pour vérifier quels documents seront affectés.

L'action "Create Search Index" crée un nouvel index de recherche sur une collection MongoDB. Essentiel pour optimiser les performances de recherche et activer les fonctionnalités de recherche vectorielle.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Search Index"), Operation (défini sur "Create"), Collection (collection sur laquelle créer l'index, requis), Index Name (nom unique pour identifier l'index, requis), Index Definition (définition JSON de l'index avec champs indexés, analyseurs, format objet JSON), Index Type (type d'index à créer, options incluant "Vector Search" pour applications IA).

Cas d'usage typiques : Créer un index de recherche full-text sur des descriptions produits, configurer un index vectoriel pour la recherche sémantique avec OpenAI, optimiser les requêtes fréquentes avec des index ciblés, préparer une collection pour des fonctionnalités de recherche avancée.

Quand l'utiliser : Lors de la mise en place initiale de votre infrastructure de recherche, ou quand vous ajoutez de nouvelles fonctionnalités nécessitant des index spécifiques. À utiliser généralement une seule fois par index.

L'action "List Search Indexes" récupère la liste des index de recherche existants sur une collection. Utile pour l'audit et la maintenance.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Search Index"), Operation (défini sur "List"), Collection (collection dont vous voulez lister les index, requis), Index Name (optionnel, si renseigné filtre pour un index spécifique).

Cas d'usage typiques : Auditer les index existants avant d'en créer de nouveaux, vérifier que tous les index nécessaires sont en place, documenter automatiquement la structure de votre base, diagnostiquer des problèmes de performance liés aux index.

Quand l'utiliser : Pour les tâches d'administration et de monitoring. Intégrez-la dans des workflows de vérification périodique de votre infrastructure MongoDB.

L'action "Update Search Index" modifie la définition d'un index de recherche existant sans avoir à le supprimer et le recréer.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Search Index"), Operation (défini sur "Update"), Collection (collection contenant l'index, requis), Index Name (nom de l'index à modifier, requis), Index Definition (nouvelle définition JSON de l'index, requis).

Cas d'usage typiques : Ajouter de nouveaux champs à un index existant, modifier les analyseurs de texte pour améliorer la pertinence, ajuster les paramètres d'un index vectoriel, optimiser un index suite à des changements de structure de données.

Quand l'utiliser : Quand vous devez faire évoluer un index sans temps d'arrêt. Plus pratique que de supprimer puis recréer, mais vérifiez la compatibilité de vos modifications avec les données existantes.

L'action "Drop Search Index" supprime définitivement un index de recherche d'une collection MongoDB.

Paramètres de configuration : Credential to connect with (requis), Resource (défini sur "Search Index"), Operation (défini sur "Drop"), Collection (collection contenant l'index à supprimer, requis), Index Name (nom exact de l'index à supprimer, requis).

Cas d'usage typiques : Nettoyer les index inutilisés pour libérer des ressources, supprimer un index avant d'en recréer un avec une nouvelle structure, retirer des index de développement/test, simplifier une configuration de recherche devenue trop complexe.

Quand l'utiliser : Pour la maintenance et le nettoyage. Attention : la suppression est irréversible et impactera immédiatement les fonctionnalités de recherche qui dépendaient de cet index.