# Guide Utilisateur Ecosystem

> Documentation complète de la plateforme iPaaS
- [Introduction to Ecosystem](/en/docs/introduction.md): Discover Ecosystem, a low-code iPaaS platform for orchestrating workflows, connecting your SaaS and legacy systems, and monitoring your executions — then how to navigate this documentation.

## Getting started

- [Concepts](/en/docs/getting-started/overview.md): Ecosystem overview: workflows, triggers, environments, traces, authentication methods, dictionaries and resources — the key concepts to understand the iPaaS platform before creating your workflows.
- [First steps](/en/docs/getting-started/first-steps.md): Create your first trigger and your first workflow, test it and watch its execution trace — a visible result in under 10 minutes.
- [First workflow](/en/docs/getting-started/first-workflow.md): Discover the editor with a minimal workflow: generate a fictitious customer in a Code node, test its loyalty score, then respond according to the result.
- [Chat Ecosystem Assistant](/en/docs/getting-started/assistant-chat-ecosystem.md): Use the Ecosystem chat assistant (chat.ecosystem.apizr.io): an assistant connected to your organization's context, with four specialized assistants (generic, traces, code, workflow creation).

## Triggers

- [Create a trigger](/en/docs/triggers/create-trigger.md): Steps to create a trigger in Ecosystem: prerequisites, form and expected result.
- [Manage triggers](/en/docs/triggers/manage-triggers.md): Daily management of Ecosystem triggers: list, search, edit, activation, deletion, tags, apps, import and export.
- [Deploy a trigger](/en/docs/triggers/deploy-triggers.md): Deploy a trigger in an Ecosystem environment: prerequisites, steps, deployment statuses, verification and removal.

## Workflows

- [Create a workflow](/en/docs/workflows/create-workflow.md): Steps to create a workflow in Ecosystem: prerequisites, form (name, description, subscribed trigger, project, tags), result and points of attention.
- [Use the workflow editor](/en/docs/workflows/editor.md): Create and edit a workflow in the Ecosystem editor: canvas, node addition and configuration, connections and test (automatic save).
- [Variable management](/en/docs/workflows/variables.md): Use variables in an Ecosystem workflow: input variables (data), context variables and dictionary variables, with the Handlebars syntax.
- [Workflow version management](/en/docs/workflows/versions.md): Main (MAIN) vs numbered versions (SemVer), immutability once deployed, only the tracing level remains modifiable on a deployed version. Ecosystem best practices.
- [Test a workflow](/en/docs/workflows/test.md): Test a workflow in the Ecosystem editor: trigger test data, step-by-step execution, result visualization and debugging.
- [Deploy a workflow](/en/docs/workflows/deploy.md): Deploy an Ecosystem workflow to an environment: prerequisites (trigger deployed beforehand), version choice and deployment management.

## Traces

- [Tracing modes](/en/docs/traces/tracing-modes.md): Complete, Standard and Performance modes for Ecosystem traces: detail recorded per node, Complete mode duration (5 min to 4 h), automatic fallback to Performance.
- [View traces](/en/docs/traces/view-traces.md): Access the trace list from the menu or from a workflow, view the detail of an execution and stop a running workflow.
- [Analyze an execution](/en/docs/traces/analyze-execution.md): Understand a trace's details: general information, per-node steps, input and output data, errors and history.
- [Replay a trace](/en/docs/traces/replay-trace.md): Rerun an execution from a trace: change the workflow version, the input data and the tracing mode, then follow the new execution.
- [Download the data](/en/docs/traces/download.md): Download a trace's data as JSON or CSV from an execution detail, for external analysis or archiving.

## Dictionaries

- [Create a dictionary](/en/docs/dictionaries/create-dictionary.md): Create a dictionary and add its key–value entries per environment, duplicate values to another environment and create a variable from a node.
- [Manage entries](/en/docs/dictionaries/entries.md): Add, edit and delete the entries (key–value) of a dictionary, including multiline values.

## Authentication methods

- [Create an authentication method](/en/docs/credentials/create-credential.md): Create an authentication method to store access to a third-party system and reuse it across workflows.
- [Use authentication methods in workflows](/en/docs/credentials/use-in-workflows.md): Select an authentication method in a node so Ecosystem applies access to the third-party system, and learn which nodes support it.

## Environments

- [Manage environments](/en/docs/environments/manage-environments.md): Create, edit, reorder and delete Ecosystem environments, and understand the impact of a deletion on deployments.

## Resources

- [Create a resource](/en/docs/resources/create-resource.md): Steps to create an Ecosystem resource: open the Resources module, fill in the name, type and configuration, and get a resource reusable in workflows.
- [Use resources in workflows](/en/docs/resources/use-in-workflows.md): Add an existing resource to a workflow from the Custom tab of the node picker: the node is created with the resource configuration pre-filled.
- [Apps](/en/docs/resources/apps.md): Apps attach triggers, nodes and resources to a business scope for readability and cartography: create an app and fill it in.

## Roles and permissions

- [Available roles](/en/docs/roles/available-roles.md): Viewer, Builder, Advanced Builder, Exploitation and Company Owner: scope, use cases and differences between Ecosystem roles.

## Administration

- [User management](/en/docs/administration/users.md): Create, edit and delete users of an Ecosystem company, and assign them roles.
- [Cartography](/en/docs/administration/cartography.md): Visualize the data exchanges between your applications in Ecosystem: prerequisites (apps filled in) and access to the cartography.

## Envoi de fichiers

- [Uploads use cases](/en/docs/uploads/use-cases.md): When to use the Send files module: send documents to your workflows for analysis, transformation or sending.

## Trigger types

- [API route trigger](/en/docs/triggers/types/api-endpoint.md): Configure an API route trigger in Ecosystem: HTTP methods, custom path, dynamic parameters and incoming webhooks.
- [File trigger](/en/docs/triggers/types/file.md): Configure a File trigger in Ecosystem: direct upload, FTP/SFTP, email, parsing formats and processing modes.
- [Scheduler trigger](/en/docs/triggers/types/cron.md): Configure a Scheduler trigger in Ecosystem: five-field CRON expression, time zone and examples.
- [Polling trigger](/en/docs/triggers/types/polling.md): Configure a Polling trigger in Ecosystem: URL to poll, interval, NEW/ALL mode and data extraction.
- [Google Pub/Sub event trigger](/en/docs/triggers/types/google-pubsub.md): Configure a Google Pub/Sub event trigger in Ecosystem: GCP prerequisites, subscription, service account key and message management.
- [AWS SQS trigger](/en/docs/triggers/types/aws-sqs.md): Configure an AWS SQS trigger in Ecosystem: AWS prerequisites, queue, processing mode and message management.

## Node types

- [Trigger node](/en/docs/workflows/nodes/trigger-node.md): Automatic entry point of a workflow: access the data received from the trigger (data, incomingRequest, params, headers).

### Fonctions

- [Code node](/en/docs/workflows/nodes/code.md): Execute custom JavaScript in a workflow: context access, libraries (libs), credentials and error management.
- [Condition node](/en/docs/workflows/nodes/condition.md): Create conditional branches in a workflow: expression to evaluate and True/False branches.
- [ForEach node](/en/docs/workflows/nodes/foreach.md): Execute a sequence of nodes for each element of an array: iteration variable and batch processing.
- [While node](/en/docs/workflows/nodes/while.md): Execute a sequence of nodes as long as a JavaScript condition is true: While and Do while modes.
- [Switch node](/en/docs/workflows/nodes/switch.md): Route to several branches according to the value of a variable: cases and default behavior.
- [Wait node](/en/docs/workflows/nodes/wait.md): Wait for a delay before continuing the execution of a workflow: retries with delay and respect of rate limits.
- [On Error node](/en/docs/workflows/nodes/on-error.md): Handle workflow errors: capture a node failure, implement a fallback and continue or interrupt the execution.
- [Call a workflow node](/en/docs/workflows/nodes/workflow-in-workflow.md): Call another workflow (precise version) from a workflow: factorization, context and trigger data inheritance.

### Appels et Événements

- [HTTP(S) Request node](/en/docs/workflows/nodes/http-request.md): Call an external API from a workflow: URL, method, request mode (JSON, GraphQL, Form), headers, authentication and timeout.
- [HTTP Response node](/en/docs/workflows/nodes/http-response.md): Return an HTTP response to the client that triggered the workflow: status code, headers and response body.
- [Send an email node](/en/docs/workflows/nodes/email.md): Send an email from a workflow: recipients, subject and body with Handlebars variables.
- [Send Google Pub/Sub node](/en/docs/workflows/nodes/event.md): Publish a message on a Google Cloud Pub/Sub topic from a workflow.
- [Send AWS SQS node](/en/docs/workflows/nodes/aws-sqs.md): Send a message in an Amazon SQS queue from a workflow: region, queue type (Standard/FIFO), body and delay.

### IA

- [AI Agent node](/en/docs/workflows/nodes/agent.md): Intelligence engine of a workflow: reason on the context, call internal or MCP tools, produce a structured and reusable output.

### Base de données

- [PostgreSQL node](/en/docs/workflows/nodes/postgresql.md): Execute SQL queries on a PostgreSQL database from a workflow: positional binds, SSL and timeout.
- [Snowflake node](/en/docs/workflows/nodes/snowflake.md): Execute SQL queries on a Snowflake warehouse from a workflow: authentication, binds and result.
- [FTP nodes](/en/docs/workflows/nodes/ftp.md): Perform operations on FTP/SFTP servers: list, read, send, move and delete files.
- [Note node](/en/docs/workflows/nodes/note.md): Document the logic of a workflow with Markdown notes visible only in the editor.

## Authentication methods

- [Authentication method types](/en/docs/credentials/types.md): Reference for authentication method types: Basic Auth, OAuth 2, API Key and Custom, with their configuration fields and the output format of Custom code.

## Roles and permissions

- [Permissions — Workflows and triggers](/en/docs/roles/permissions-workflows-triggers.md): Ecosystem RBAC matrix for workflows, triggers, versions and manual execution by role and by environment.
- [Permissions — Deployments and traces](/en/docs/roles/permissions-deployments-traces.md): Ecosystem RBAC matrix for deployments, trace viewing and replay by role and by environment.
- [Permissions — Dictionaries and credentials](/en/docs/roles/permissions-dictionaries-credentials.md): Ecosystem RBAC matrix for viewing and editing dictionaries and credentials by role and by environment.
- [Permissions — Organization and administration](/en/docs/roles/permissions-organization.md): Ecosystem RBAC matrix for projects, folders, resources, users and environments.
- [Glossary](/en/docs/glossaire.md): Canonical definitions of the terms used in the Ecosystem documentation: workflow, node, trigger, trace, environment, dictionary, authentication method, resource, App.
- [Best practices](/en/docs/best-practices/overview.md): The trade-offs and reflexes for using Ecosystem: environment organization, project structure, dictionary and secret management, error management and integration patterns.
- [Environment management](/en/docs/best-practices/environment-management.md): Organizing environments (DEV, STAGING, PROD) for a safe deployment cycle: order, marking, combination with dictionaries and the multi-tenant case.
- [Organization with Apps and Tags](/en/docs/best-practices/project-organization.md): Structuring triggers, workflows and resources with Apps and tags: grouping by system, team naming conventions and the data exchange map.
- [Dictionary management](/en/docs/best-practices/dictionaries-management.md): Centralizing per-environment variables: organization by domain, key naming, secret masking and choosing between dictionary and authentication method.
- [Authentication method management](/en/docs/best-practices/credentials-management.md): Centralizing an authentication scheme for several nodes, varying secrets per environment and choosing between authentication method and dictionary.
- [Data mapping](/en/docs/best-practices/data-mapping.md): Transform data between systems in Ecosystem: surgical approach, JSONPath extractors vs Code node, variable naming and mapping examples.
- [Error management](/en/docs/best-practices/error-management.md): Anticipate, capture, analyze, and resolve incidents in Ecosystem: API response validation, On Error node, trace analysis, and replay.
- [Usage patterns](/en/docs/best-practices/patterns.md): The common integration patterns in Ecosystem — scheduler, file import, events, API exposure — and the criterion for choosing the right one.
- [Examples and integrations](/en/docs/examples/introduction.md): Ready-to-use example workflows: common use cases, recurring third-party integrations and copy-paste snippets for the workflow editor.

## E-commerce

- [AWS SQS order → persistence and notification](/en/docs/examples/e-commerce/commande-sqs.md): Record each order received on an AWS SQS queue in PostgreSQL, then notify management if the amount exceeds a threshold.
- [Abandoned cart reminder](/en/docs/examples/e-commerce/panier-abandonne.md): Notify the e-commerce team of a non-empty abandoned cart and publish the follow-up on a Google Pub/Sub topic consumed by the CRM.
- [Managing a product return request](/en/docs/examples/e-commerce/retour-produit.md): Validate a return request, generate the return label with the carrier and inform the internal teams in charge of customer relations.

## Retail

- [Low stock alert and restocking](/en/docs/examples/retail/stock-faible.md): Monitor the stock level, alert the buyer and automatically place an order with the supplier below the threshold.
- [Dispatch a POS webhook to sub-workflows](/en/docs/examples/retail/dispatch-webhook-caisse.md): Route events from a point-of-sale software (orders, payments, refunds) to dedicated sub-workflows based on the request method and route.

## Logistique

- [Routing a shipment according to its status](/en/docs/examples/logistique/expedition-livraison.md): Route each shipment update to the customer notification or the logistics alert depending on the delivery status.
- [Bank reconciliation on SFTP statement](/en/docs/examples/logistique/tresorerie-rapprochement.md): Read a transaction statement dropped on SFTP, enrich each line (running balance, abnormal amounts), archive the file and notify the treasury team.

## IA & automatisation

- [AI lead qualification](/en/docs/examples/ia/lead-scoring-ia.md): Automatically score an incoming lead with an AI agent, then notify the assigned salesperson by email.
- [Release notes](/en/docs/release-notes/introduction.md): Release history of the Ecosystem platform: new features, general information, improvements and fixes.
- [v1.16 — August 2026](/en/docs/release-notes/1.16.md): Ecosystem 1.16 release notes (August 2026): AI chat in the workflow, Anthropic provider, business metadata on nodes, version history comparison, trace filters and sorting, and fixes.
- [v1.15 — July 2026](/en/docs/release-notes/1.15.md): Ecosystem 1.15 release notes (July 2026): RBAC, Call a workflow node, PostgreSQL, Snowflake, AI planner agent, HTTP form-data, API Key credential and fixes.
- [v1.14 — April 2026](/en/docs/release-notes/1.14.md): Ecosystem 1.14 release notes (April 2026): Complete tracing mode with 5-minute to 4-hour duration, workflow fixes, FTP, SQS trigger, dictionaries.
- [v1.13 — March 2026](/en/docs/release-notes/1.13.md): Ecosystem 1.13 release notes (March 2026): AI in the editor, While node, multi-edit, worker sync, FTP trigger, traces and dictionaries.
- [v1.12 — December 2025](/en/docs/release-notes/1.12.md): Ecosystem 1.12 release notes (December 2025): Amazon SQS and FTP nodes, Performance trace mode, bulk replay, navigation, Pub/Sub, dictionaries.
- [v1.11 — October 2025](/en/docs/release-notes/1.11.md): Ecosystem 1.11 release notes (October 2025): Amazon SQS trigger, Pub/Sub attributes, workflow stop, workflow parentage, ForEach traces and dictionaries.
- [v1.10 — August 2025](/en/docs/release-notes/1.10.md): Ecosystem 1.10 release notes (August 2025): scalability overhaul, manual run, Other file trigger, navigation, email/FTP/Excel triggers, workflow fixes.

## Other Pages

- /en/
- /en/search