Aller au contenu principal

Middlewares iPaaS (Zapier, Make, n8n, Power Automate, Workato)

Les plateformes d'intégration no-code (iPaaS) relient FoxPlan à vos autres outils (ERP, CRM, ticketing, messagerie, tableurs…) sans développement. FoxPlan livre cinq connecteurs en standard, sur toutes les instances : ils apparaissent dans Paramètres → Connecteurs pour vos administrateurs d'espace de travail ou d'entreprise, sans demande d'ouverture préalable.

ConnecteurÉditeurDéclencheur webhook à utiliser dans l'outil
ZapierZapierWebhooks by Zapier › Catch Hook
MakeCelonis (Make.com)module Webhooks › Custom webhook
n8nn8nnœud Webhook (méthode POST, URL de production)
Microsoft Power AutomateMicrosoftdéclencheur Lors de la réception d'une requête HTTP
WorkatoWorkatodéclencheur Webhooks › New event via webhook

Les cinq connecteurs fonctionnent exactement de la même façon, dans les deux sens :

SensMécanismeOù le configurer
FoxPlan → middleware (sortant)FoxPlan envoie un événement JSON structuré à l'URL de webhook de votre scénarioOnglet Configuration de la fiche, puis onglet Flux
Middleware → FoxPlan (entrant)Le scénario appelle l'API REST FoxPlan avec un compte d'APIOnglet API de la fiche

Mise en place, connecteur par connecteur​

Dans tous les cas, la démarche est la même : créer le déclencheur webhook dans l'outil, coller son URL dans FoxPlan, tester, puis activer les flux.

Zapier​

  1. Créez un Zap et choisissez le déclencheur Webhooks by Zapier › Catch Hook. Zapier affiche une URL de la forme https://hooks.zapier.com/hooks/catch/….
  2. Dans FoxPlan, ouvrez Paramètres → Connecteurs → Zapier, collez l'URL dans URL de webhook Zapier, renseignez éventuellement un jeton partagé, puis Enregistrer.
  3. Cliquez sur Tester : Zapier reçoit un événement connection.test et vous propose de l'utiliser comme exemple (« Find new records »).
  4. Onglet Flux : activez Événements de tâches et/ou Commentaires de tâches.
  5. Poursuivez votre Zap avec les actions de votre choix ; pour agir sur FoxPlan, utilisez Webhooks by Zapier › Custom Request vers l'API REST (voir plus bas).

Make​

  1. Dans un scénario, ajoutez le module Webhooks › Custom webhook, créez un webhook et copiez son adresse (https://hook.eu1.make.com/…).
  2. Dans FoxPlan, ouvrez la fiche Make, collez l'URL, enregistrez puis Tester : Make détermine automatiquement la structure des données reçues.
  3. Activez les flux souhaités dans l'onglet Flux.
  4. Pour écrire dans FoxPlan, ajoutez un module HTTP › Make a request avec l'en-tête Authorization: Bearer … (voir la section API).

n8n​

  1. Dans un workflow, ajoutez un nœud Webhook, méthode POST, et copiez l'URL de production.
  2. Dans FoxPlan, fiche n8n : collez l'URL, enregistrez, puis Tester avec le nœud en écoute (« Listen for test event ») pour récupérer un exemple.
  3. Activez les flux dans l'onglet Flux.
  4. Pour appeler FoxPlan, utilisez un nœud HTTP Request avec une identification Header Auth (Authorization / Bearer …).

Microsoft Power Automate​

  1. Créez un flux avec le déclencheur Lors de la réception d'une requête HTTP (When an HTTP request is received). L'URL n'apparaît qu'après le premier enregistrement du flux.
  2. Collez l'exemple de JSON ci-dessous dans « Utiliser un exemple de charge utile pour générer le schéma » pour disposer des champs dans les étapes suivantes.
  3. Dans FoxPlan, fiche Microsoft Power Automate : collez l'URL, enregistrez, Tester, puis activez les flux.
  4. Pour agir sur FoxPlan, ajoutez une action HTTP avec l'en-tête Authorization.
Licence Power Automate

Le déclencheur HTTP et l'action HTTP sont des connecteurs Premium chez Microsoft.

Workato​

  1. Dans une recette, choisissez le déclencheur Webhooks › New event via webhook et copiez l'URL du webhook.
  2. Dans FoxPlan, fiche Workato : collez l'URL, enregistrez, Tester, puis activez les flux.
  3. Pour écrire dans FoxPlan, utilisez le connecteur HTTP de Workato avec une authentification Header (Authorization: Bearer …).

Sens sortant : l'événement JSON​

Le bouton Tester envoie immédiatement un événement connection.test. Les flux Événements de tâches (task.status-changed, task.owner-changed, task.planning-assignment-changed) et Commentaires de tâches (task.comment-added) envoient ensuite, à chaque événement, un JSON de la forme :

{
  "schemaVersion": "1",
  "source": "foxplan",
  "event": "task.status-changed",
  "occurredAt": "2026-09-08T16:05:12.345Z",
  "environmentId": "…",
  "actor": { "id": "…", "name": "Jane Doe", "email": "jane@exemple.com" },
  "project": { "id": "…", "name": "Projet Alpha", "code": "ALP" },
  "task": { "id": "…", "projectId": "…", "name": "…", "status": "…", "owner": "…", "priority": 1, "startDate": "…", "endDate": "…", "percentComplete": 40, "description": "…", "lastModifiedDate": "…" },
  "previous": { "…": "état de la tâche avant le changement" },
  "comment": { "author": "…", "text": "…" }
}

Deux en-têtes HTTP accompagnent chaque appel : X-Foxplan-Event (type d'événement) et, si un jeton partagé est renseigné dans la configuration, X-Foxplan-Token. Vérifiez ce jeton dans votre scénario pour n'accepter que les appels provenant de FoxPlan.

Couplage avec les notifications projet

Comme pour les connecteurs de chat, ces flux ne se déclenchent que si les options de notification du projet correspondantes sont activées dans Définition du projet.

Sens entrant : appeler l'API FoxPlan depuis le scénario​

L'onglet API de chaque fiche liste les opérations de l'API REST recommandées pour un scénario d'automatisation, regroupées par domaine (authentification, projets, tâches, commentaires, ressources, portefeuilles) : lister ou créer des tâches, changer un statut, commenter, lire un projet, créer une affectation… Il rappelle l'URL de base à utiliser et donne accès à la documentation Swagger complète.

Authentification, en trois étapes :

  1. Créez un compte d'API dans Paramètres → Connecteurs → onglet API et attribuez-lui un rôle (par exemple Gestionnaire d'espace de travail).
  2. Appelez POST /api/auth en authentification Basic (Auth ID:Auth Token encodés en base64) : la réponse contient un id_token.
  3. Passez l'en-tête Authorization: Bearer <id_token> sur chaque appel.

La procédure détaillée est décrite dans le guide d'utilisation de l'API.

Importer la spécification OpenAPI dans l'outil​

L'onglet API propose aussi le document OpenAPI (3.x) à télécharger : il reprend exactement le périmètre de la liste affichée, avec l'adresse de votre instance comme serveur, et exclut les services internes de FoxPlan. Make (Custom apps › Import OpenAPI), Zapier (Platform UI › Import an OpenAPI spec) et Workato (Connector SDK › Import OpenAPI) en font un connecteur personnalisé en quelques clics. n8n n'importe pas OpenAPI : le fichier sert de référence pour les nœuds HTTP Request. Power Automate n'accepte aujourd'hui que la version 2.0 : le fichier est fourni en 3.x, à convertir en attendant leur prise en charge.

Cloisonnement par instance​

Un middleware ne peut agir que sur l'instance (le tenant) à laquelle il est rattaché, dans les deux sens :

  • Sortant : le connecteur est installé sur un espace de travail ; il ne reçoit que les événements de cet espace, et le contexte de l'instance émettrice est conservé jusqu'à l'envoi du webhook.
  • Entrant : le compte d'API appartient à une entreprise ; le jeton qu'il obtient porte cette entreprise et c'est elle, et elle seule, qui détermine les données accessibles. Un en-tête forgé dans le scénario ne permet pas d'en changer, et les droits du compte (rôle sur les projets) s'appliquent comme pour un utilisateur.