# Guide Utilisateur Ecosystem

> Documentation complète de la plateforme iPaaS
- [Introduction](/docs/introduction.md): Découvrez Ecosystem, plateforme iPaaS low-code pour orchestrer des flux, connecter vos systèmes SaaS et legacy, et monitorer vos exécutions — puis comment naviguer dans cette documentation.

## Démarrage

- [Concepts](/docs/getting-started/overview.md): Vue d'ensemble d'Ecosystem : flux, déclencheurs, environnements, traces, méthodes d'authentification, dictionnaires et ressources — les concepts clés pour comprendre la plateforme iPaaS avant de créer vos flux.
- [Premiers pas](/docs/getting-started/first-steps.md): Créez votre premier déclencheur et votre premier flux, testez-le et observez sa trace d'exécution — un résultat visible en moins de 10 minutes.
- [Premier workflow](/docs/getting-started/first-workflow.md): Découvrir l'éditeur avec un workflow minimal : générer un client fictif dans un nœud Code, tester son score de fidélité puis répondre selon le résultat.
- [Assistant Chat Ecosystem](/docs/getting-started/assistant-chat-ecosystem.md): Utiliser l'assistant chat d'Ecosystem (chat.ecosystem.apizr.io) : un assistant connecté au contexte de votre organisation, avec quatre assistants spécialisés (générique, traces, code, création de workflow).

## Déclencheurs

- [Créer un déclencheur](/docs/triggers/create-trigger.md): Étapes pour créer un déclencheur dans Ecosystem : prérequis, formulaire et résultat attendu.
- [Gérer les déclencheurs](/docs/triggers/manage-triggers.md): Gestion quotidienne des déclencheurs Ecosystem : liste, recherche, modification, activation, suppression, tags, apps, import et export.
- [Déployer un déclencheur](/docs/triggers/deploy-triggers.md): Déployer un déclencheur dans un environnement Ecosystem : prérequis, étapes, statuts de déploiement, vérification et retrait.

## Flux

- [Créer un flux](/docs/workflows/create-workflow.md): Étapes pour créer un flux dans Ecosystem : prérequis, formulaire (nom, description, déclencheur souscrit, projet, tags), résultat et points d'attention.
- [Utiliser l'éditeur de flux](/docs/workflows/editor.md): Créer et modifier un flux dans l'éditeur Ecosystem : canvas, ajout et configuration des nœuds, connexions et test (sauvegarde automatique).
- [Gestion des variables](/docs/workflows/variables.md): Utiliser les variables dans un flux Ecosystem : variables d'entrée (data), variables de contexte et variables de dictionnaire, avec la syntaxe Handlebars.
- [Gestion des versions de flux](/docs/workflows/versions.md): Principale (MAIN) vs versions numérotées (SemVer), immuabilité dès déploiement, seul le niveau de traçage reste modifiable sur une version déployée. Bonnes pratiques Ecosystem.
- [Tester un flux](/docs/workflows/test.md): Tester un flux dans l'éditeur Ecosystem : données de test du déclencheur, exécution pas à pas, visualisation des résultats et débogage.
- [Déployer un flux](/docs/workflows/deploy.md): Déployer un flux Ecosystem sur un environnement : prérequis (déclencheur déployé au préalable), choix de la version et gestion des déploiements.

## Traces

- [Modes de traçage](/docs/traces/tracing-modes.md): Modes Complet, Standard et Performance pour les traces Ecosystem : détail enregistré par nœud, durée du mode Complet (5 min à 4 h), retour automatique en Performance.
- [Visualiser les traces](/docs/traces/view-traces.md): Accéder à la liste des traces depuis le menu ou depuis un flux, consulter le détail d'une exécution et stopper un flux en cours d'exécution.
- [Analyser une exécution](/docs/traces/analyze-execution.md): Comprendre le détail d'une trace : informations générales, étapes par nœud, données d'entrée et de sortie, erreurs et historique.
- [Rejouer une trace](/docs/traces/replay-trace.md): Relancer une exécution depuis une trace : modifier la version du flux, les données d'entrée et le mode de traçage, puis suivre la nouvelle exécution.
- [Télécharger les données](/docs/traces/download.md): Télécharger les données d'une trace au format JSON ou CSV depuis le détail d'une exécution, pour une analyse externe ou un archivage.

## Dictionnaires

- [Créer un dictionnaire](/docs/dictionaries/create-dictionary.md): Créer un dictionnaire et ajouter ses entrées clé–valeur par environnement, dupliquer les valeurs vers un autre environnement et créer une variable depuis un nœud.
- [Gérer les entrées](/docs/dictionaries/entries.md): Ajouter, modifier et supprimer les entrées (clé–valeur) d'un dictionnaire, y compris les valeurs multilignes.

## Méthodes d'authentification

- [Créer une méthode d'authentification](/docs/credentials/create-credential.md): Créer une méthode d'authentification pour stocker les accès à un système tiers et les réutiliser dans les flux.
- [Utiliser les méthodes d'authentification dans les flux](/docs/credentials/use-in-workflows.md): Sélectionner une méthode d'authentification dans un nœud pour qu'Ecosystem applique l'accès au système tiers, et connaître les nœuds qui la supportent.

## Environnements

- [Gérer les environnements](/docs/environments/manage-environments.md): Créer, modifier, ordonner et supprimer les environnements Ecosystem, et connaître l'impact d'une suppression sur les déploiements.

## Ressources

- [Créer une ressource](/docs/resources/create-resource.md): Étapes pour créer une ressource Ecosystem : accéder au module Ressources, renseigner le nom, le type et la configuration, et obtenir une ressource réutilisable dans les flux.
- [Utiliser les ressources dans les flux](/docs/resources/use-in-workflows.md): Ajouter une ressource existante à un flux depuis l'onglet Personnalisés du sélecteur de nœuds : le nœud est créé avec la configuration de la ressource pré-remplie.
- [Apps](/docs/resources/apps.md): Les Apps rattachent déclencheurs, nœuds et ressources à un périmètre métier pour la lisibilité et la cartographie : créer une app et la renseigner.

## Rôles et permissions

- [Rôles disponibles](/docs/roles/available-roles.md): Viewer, Builder, Advanced Builder, Exploitation et Company Owner : périmètre, cas d'usage et différences entre les rôles Ecosystem.

## Administration

- [Gestion des utilisateurs](/docs/administration/users.md): Créer, modifier et supprimer les utilisateurs d'une company Ecosystem, et leur attribuer des rôles.
- [Cartographie](/docs/administration/cartography.md): Visualiser les échanges de données entre vos applications dans Ecosystem : prérequis (apps renseignées) et accès à la cartographie.

## Envoi de fichiers

- [Cas d'usage des Uploads](/docs/uploads/use-cases.md): Quand utiliser le module Envoyer des fichiers : transmettre des documents à vos flux pour analyse, transformation ou envoi.

## Types de déclencheurs

- [Déclencheur Route d'une API](/docs/triggers/types/api-endpoint.md): Configurer un déclencheur Route d'une API dans Ecosystem : méthodes HTTP, path personnalisé, paramètres dynamiques et webhooks entrants.
- [Déclencheur Fichier](/docs/triggers/types/file.md): Configurer un déclencheur Fichier dans Ecosystem : téléversement direct, FTP/SFTP, e-mail, formats de parsing et modes de traitement.
- [Déclencheur Planificateur](/docs/triggers/types/cron.md): Configurer un déclencheur Planificateur dans Ecosystem : expression CRON à cinq champs, fuseau horaire et exemples.
- [Déclencheur Interrogation](/docs/triggers/types/polling.md): Configurer un déclencheur Interrogation dans Ecosystem : URL à interroger, intervalle, mode NEW/ALL et extraction des données.
- [Déclencheur Événement Google Pub/Sub](/docs/triggers/types/google-pubsub.md): Configurer un déclencheur Événement Google Pub/Sub dans Ecosystem : prérequis GCP, souscription, clé de compte de service et gestion des messages.
- [Déclencheur AWS SQS](/docs/triggers/types/aws-sqs.md): Configurer un déclencheur AWS SQS dans Ecosystem : prérequis AWS, file d'attente, mode de traitement et gestion des messages.

## Types de nœuds

- [Nœud Déclencheur](/docs/workflows/nodes/trigger-node.md): Point d'entrée automatique d'un flux : accéder aux données reçues du déclencheur (data, incomingRequest, params, headers).

### Fonctions

- [Nœud Code](/docs/workflows/nodes/code.md): Exécuter du JavaScript personnalisé dans un flux : accès au contexte, librairies (libs), credentials et gestion des erreurs.
- [Nœud Condition](/docs/workflows/nodes/condition.md): Créer des branchements conditionnels dans un flux : expression à évaluer et branches True/False.
- [Nœud Foreach](/docs/workflows/nodes/foreach.md): Exécuter une séquence de nœuds pour chaque élément d'un tableau : variable d'itération et traitement par lots.
- [Nœud While](/docs/workflows/nodes/while.md): Exécuter une séquence de nœuds tant qu'une condition JavaScript est vraie : modes While et Do while.
- [Nœud Switch](/docs/workflows/nodes/switch.md): Router vers plusieurs branches selon la valeur d'une variable : cases et comportement par défaut.
- [Nœud Attente](/docs/workflows/nodes/wait.md): Attendre un délai avant de poursuivre l'exécution d'un flux : retries avec délai et respect des rate limits.
- [Nœud On Error](/docs/workflows/nodes/on-error.md): Gérer les erreurs d'un flux : capturer un échec de nœud, implémenter un fallback et poursuivre ou interrompre l'exécution.
- [Nœud Appeler un flux](/docs/workflows/nodes/workflow-in-workflow.md): Appeler un autre flux (version précise) depuis un flux : factorisation, héritage du contexte et des données trigger.

### Appels et Événements

- [Nœud Requête HTTP(S)](/docs/workflows/nodes/http-request.md): Appeler une API externe depuis un flux : URL, méthode, mode de requête (JSON, GraphQL, Form), headers, authentification et timeout.
- [Nœud Réponse HTTP](/docs/workflows/nodes/http-response.md): Retourner une réponse HTTP au client qui a déclenché le flux : code de statut, headers et corps de réponse.
- [Nœud Envoyer un e-mail](/docs/workflows/nodes/email.md): Envoyer un email depuis un flux : destinataires, sujet et corps avec variables Handlebars.
- [Nœud Envoi Google Pub/Sub](/docs/workflows/nodes/event.md): Publier un message sur un topic Google Cloud Pub/Sub depuis un flux.
- [Nœud Envoi AWS SQS](/docs/workflows/nodes/aws-sqs.md): Envoyer un message dans une file Amazon SQS depuis un flux : région, type de file (Standard/FIFO), corps et délai.

### IA

- [Nœud Agent IA](/docs/workflows/nodes/agent.md): Moteur d'intelligence d'un flux : raisonner sur le contexte, appeler des outils internes ou MCP, produire une sortie structurée et réutilisable.

### Base de données

- [Nœud PostgreSQL](/docs/workflows/nodes/postgresql.md): Exécuter des requêtes SQL sur une base PostgreSQL depuis un flux : binds positionnels, SSL et timeout.
- [Nœud Snowflake](/docs/workflows/nodes/snowflake.md): Exécuter des requêtes SQL sur un entrepôt Snowflake depuis un flux : authentification, binds et résultat.
- [Nœuds FTP](/docs/workflows/nodes/ftp.md): Effectuer des opérations sur des serveurs FTP/SFTP : lister, lire, envoyer, déplacer et supprimer des fichiers.
- [Nœud Note](/docs/workflows/nodes/note.md): Documenter la logique d'un flux avec des notes Markdown visibles uniquement dans l'éditeur.

## Méthodes d'authentification

- [Types de méthodes d'authentification](/docs/credentials/types.md): Référence des types de méthodes d'authentification : Basic Auth, OAuth 2, API Key et Custom, avec leurs champs de configuration et le format de sortie du code Custom.

## Rôles et permissions

- [Droits — Flux et déclencheurs](/docs/roles/permissions-workflows-triggers.md): Matrice RBAC Ecosystem pour les workflows, triggers, versions et exécution manuelle par rôle et par environnement.
- [Droits — Déploiements et traces](/docs/roles/permissions-deployments-traces.md): Matrice RBAC Ecosystem pour les déploiements, la consultation des traces et le rejeu par rôle et par environnement.
- [Droits — Dictionnaires et credentials](/docs/roles/permissions-dictionaries-credentials.md): Matrice RBAC Ecosystem pour la consultation et la modification des dictionnaires et credentials par rôle et par environnement.
- [Droits — Organisation et administration](/docs/roles/permissions-organization.md): Matrice RBAC Ecosystem pour les projets, dossiers, ressources, utilisateurs et environnements.
- [Glossaire](/docs/glossaire.md): Définitions canoniques des termes utilisés dans la documentation Ecosystem : flux, nœud, déclencheur, trace, environnement, dictionnaire, méthode d'authentification, ressource, App.
- [Bonnes pratiques](/docs/best-practices/overview.md): Les arbitrages et réflexes d'utilisation d'Ecosystem : organisation des environnements, structuration des projets, gestion des dictionnaires et des secrets, gestion des erreurs et patterns d'intégration.
- [Gestion des environnements](/docs/best-practices/environment-management.md): Organiser les environnements (DEV, STAGING, PROD) pour un cycle de déploiement sûr : ordre, marquage, combinaison avec les dictionnaires et cas multi-tenant.
- [Organisation par Projets et Tags](/docs/best-practices/project-organization.md): Structurer déclencheurs, flux et ressources avec les Apps et les tags : regroupement par système, nomenclature d'équipe et cartographie des échanges.
- [Gestion des dictionnaires](/docs/best-practices/dictionaries-management.md): Centraliser les variables par environnement : organisation par domaine, nomenclature des clés, masquage des secrets et choix entre dictionnaire et méthode d'authentification.
- [Gestion des méthodes d'authentification](/docs/best-practices/credentials-management.md): Centraliser un schéma d'authentification pour plusieurs nœuds, variabiliser les secrets par environnement et choisir entre méthode d'authentification et dictionnaire.
- [Mapping de données](/docs/best-practices/data-mapping.md): Transformer les données entre systèmes dans Ecosystem : approche chirurgicale, extracteurs JSONPath vs nœud Code, nomenclature des variables et exemples de mapping.
- [Gestion des erreurs](/docs/best-practices/error-management.md): Anticiper, capturer, analyser et résoudre les incidents dans Ecosystem : validation des réponses API, nœud On Error, lecture des traces et rejeu.
- [Patterns d'utilisation](/docs/best-practices/patterns.md): Les patterns d'intégration courants dans Ecosystem — planificateur, import de fichier, événements, exposition d'API — et le critère pour choisir le bon.
- [Exemples et intégrations](/docs/examples/introduction.md): Workflows d'exemple prêts à l'emploi : cas d'usage fréquents, intégrations avec des tiers récurrents et snippets copiables pour l'éditeur de flux.

## E-commerce

- [Commande AWS SQS → persistance et notification](/docs/examples/e-commerce/commande-sqs.md): Enregistrer chaque commande reçue sur une file AWS SQS dans PostgreSQL, puis notifier la direction si le montant dépasse un seuil.
- [Relance de panier abandonné](/docs/examples/e-commerce/panier-abandonne.md): Notifier l'équipe e-commerce d'un panier abandonné non vide et publier la relance sur un topic Google Pub/Sub consommé par le CRM.
- [Gestion d'une demande de retour produit](/docs/examples/e-commerce/retour-produit.md): Valider une demande de retour, générer le bon de retour auprès du transporteur et informer les équipes internes chargées de la relation client.

## Retail

- [Alerte et réapprovisionnement sur stock faible](/docs/examples/retail/stock-faible.md): Surveiller le niveau de stock, alerter l'acheteur et commander automatiquement au fournisseur sous le seuil.
- [Dispatch d'un webhook caisse vers des sous-flux](/docs/examples/retail/dispatch-webhook-caisse.md): Répartir les événements d'un logiciel de caisse (commandes, paiements, remboursements) vers des sous-flux dédiés selon la méthode et la route de la requête.

## Logistique

- [Aiguillage d'une expédition selon son statut](/docs/examples/logistique/expedition-livraison.md): Router chaque mise à jour d'expédition vers la notification client ou l'alerte logistique selon le statut de livraison.
- [Rapprochement bancaire sur relevé SFTP](/docs/examples/logistique/tresorerie-rapprochement.md): Lire un relevé de transactions déposé en SFTP, enrichir chaque ligne (solde courant, montants anormaux), archiver le fichier et notifier la trésorerie.

## IA & automatisation

- [Qualification de lead par IA](/docs/examples/ia/lead-scoring-ia.md): Scorer automatiquement un lead entrant avec un agent IA, puis notifier le commercial assigné par e-mail.
- [Notes de version](/docs/release-notes/introduction.md): Historique des versions de la plateforme Ecosystem : nouveautés, informations générales, améliorations et correctifs.
- [v1.16 — Août 2026](/docs/release-notes/1.16.md): Notes de version Ecosystem 1.16 (août 2026) : chat IA dans le workflow, provider Anthropic, métadonnées métier sur les nœuds, historique de versions comparé, filtres et tris des traces, et correctifs.
- [v1.15 — Juillet 2026](/docs/release-notes/1.15.md): Notes de version Ecosystem 1.15 (juillet 2026) : RBAC, Workflow in Workflow, PostgreSQL, Snowflake, agent IA planner, form-data HTTP, credential API Key et correctifs.
- [v1.14 — Avril 2026](/docs/release-notes/1.14.md): Notes de version Ecosystem 1.14 (avril 2026) : mode de traçage Complet avec durée 5 min à 4 h, correctifs workflows, FTP, trigger SQS, dictionnaires.
- [v1.13 — Mars 2026](/docs/release-notes/1.13.md): Notes de version Ecosystem 1.13 (mars 2026) : IA dans l’éditeur, nœud While, multiédition, synchro workers, trigger FTP, traces et dictionnaires.
- [v1.12 — Décembre 2025](/docs/release-notes/1.12.md): Notes de version Ecosystem 1.12 (décembre 2025) : nœuds Amazon SQS et FTP, mode Performance des traces, rejeu en masse, navigation, Pub/Sub, dictionnaires.
- [v1.11 — Octobre 2025](/docs/release-notes/1.11.md): Notes de version Ecosystem 1.11 (octobre 2025) : trigger Amazon SQS, attributs Pub/Sub, arrêt de workflow, parenté entre flux, traces ForEach et dictionnaires.
- [v1.10 — Août 2025](/docs/release-notes/1.10.md): Notes de version Ecosystem 1.10 (août 2025) : refonte scalabilité, exécution manuelle, trigger fichier Other, navigation, triggers e-mail/FTP/Excel, correctifs workflows.

## Other Pages

- /
- /search