Connecteurs (Place de marché)
La place de marché de connecteurs centralise les intégrations entre FoxPlan et vos outils externes (messagerie, CRM, ERP, ITSM, RH). Chaque connecteur s'installe sur un espace de travail, se configure une fois, puis réagit automatiquement aux événements métier de FoxPlan (changement de statut, affectation, commentaire…).
Paramètres → Connecteurs
L'écran Connecteurs est réservé aux administrateurs d'espace de travail ou d'entreprise, comme le reste du menu Paramètres. Il comporte deux onglets : la Place de marché (connecteurs sortants) et l'API (comptes d'API, documentation Swagger, journal des appels). La place de marché est une fonctionnalité en cours de déploiement : FoxPlan ouvre tout le catalogue ou seulement certains connecteurs à votre instance, et vous ne voyez que ceux qui vous ont été ouverts — tant qu'aucun ne l'est, l'onglet le dit. Pour en demander l'accès, contactez votre interlocuteur FoxPlan.
Catalogue
| Connecteur | Éditeur | Catégories | Maturité |
|---|---|---|---|
| Slack | Slack | Communication, Notifications | Stable |
| Microsoft Teams | Microsoft | Communication, Notifications | Stable |
| Google Chat | Communication, Notifications | Stable | |
| Jira Cloud | Atlassian | ITSM, Gestion de projet | Bêta |
| HubSpot | HubSpot, Inc. | CRM, Marketing | Alpha |
| Odoo | Odoo S.A. | ERP, Open Source | Alpha |
| Pennylane | Pennylane | Finance, Comptabilité | Alpha |
| Sage Business Cloud Accounting | Sage Group plc | Finance, Comptabilité | Alpha |
| Cegid | Cegid | ERP, Finance, RH | Alpha |
| HiBob | Hibob | RH, People | Alpha |
| Infor M3 | Infor | ERP, Industrie | Alpha |
| SAP S/4HANA Cloud (Public) | SAP SE | ERP, Finance | Alpha |
| Zapier | Zapier | Middleware, iPaaS, Automatisation | Bêta — standard |
| Make | Celonis (Make.com) | Middleware, iPaaS, Automatisation | Bêta — standard |
| n8n | n8n | Middleware, iPaaS, Automatisation | Bêta — standard |
| Microsoft Power Automate | Microsoft | Middleware, iPaaS, Automatisation | Bêta — standard |
| Workato | Workato | Middleware, iPaaS, Automatisation | Bêta — standard |
- Standard : livré sur toutes les instances, sans ouverture préalable (famille iPaaS).
- Stable : prêt pour la production.
- Bêta : fonctionnel, périmètre encore susceptible d'évoluer.
- Alpha : connecteur d'amorçage (test de connexion + un flux). À réserver à l'évaluation.
Installer un connecteur
- Ouvrez Paramètres → Connecteurs.
- Cliquez sur la carte du connecteur souhaité pour ouvrir sa fiche.
- Onglet Configuration : renseignez les champs requis (URL, jetons, identifiants…).
- Cliquez sur Enregistrer. Le connecteur est alors installé sur l'espace de travail.
- Utilisez Tester pour vérifier la connexion avant d'activer les flux.
Le commutateur en haut de la fiche permet d'activer / désactiver globalement l'installation sans perdre sa configuration.
Champs de configuration
Les fiches utilisent des champs typés : texte, URL, nombre, bool éen, liste, zone de texte, mot de passe et secret. Les champs marqués comme secrets (jetons d'API, URLs de webhook signées…) sont chiffrés au repos et ne sont jamais réaffichés en clair — un masque (••••) indique qu'une valeur est déjà enregistrée.
L'authentification dépend du connecteur : URL de webhook entrant (chat), jeton d'API, Bearer, Basic ou OAuth selon l'outil cible.
Flux et déclencheurs
Un connecteur expose un ou plusieurs flux. Chaque flux s'active indépendamment dans l'onglet Flux de la fiche.
Les connecteurs de messagerie (Slack, Teams, Google Chat) et les middlewares iPaaS proposent six flux, qui réagissent aux événements suivants :
| Flux | Événements |
|---|---|
| Notifications de tâches | changement de statut, de responsable (affectation), d'affectation planning |
| Notifications de commentaires | commentaire ajouté à une tâche |
| Avancement des tâches | changement du pourcentage d'avancement d'une tâche |
| Objets projet | création, modification ou suppression d'un risque, d'une décision, d'une exigence, d'un changement, d'un fichier ou d'une météo projet |
| Tickets Support | création d'un ticket Support et changement de statut |
| Commentaires sur les objets | commentaire ajouté à un objet projet ou à un ticket Support |
Les deux premiers flux (tâches et commentaires de tâches) ne se déclenchent que si les options de notification du projet correspondantes sont activées (Notifier au changement de statut, Notifier sur affectation, Notifier sur commentaire…), définies dans Définition du projet. Un connecteur fraîchement installé reste donc silencieux sur ces deux flux tant que ces options ne sont pas cochées sur les projets concernés.
Les quatre autres flux (avancement, objets projet, tickets Support, commentaires sur les objets) ne dépendent d'aucune option de projet : activer le flux dans le connecteur suffit.
Déclenchement manuel
Les flux « à la demande » (par exemple une synchronisation) peuvent être lancés manuellement via le bouton Exécuter de l'onglet Flux. Le résultat (succès / échec, code HTTP) est renvoyé immédiatement.
Middlewares iPaaS (Zapier, Make, n8n, Power Automate, Workato)
Cinq connecteurs vers les plateformes d'automatisation no-code sont livrés en standard sur toutes les instances : ils apparaissent dans Paramètres → Connecteurs pour vos administrateurs, sans demande d'ouverture. Ils fonctionnent dans les deux sens — événements JSON sortants par webhook, actions entrantes via l'API REST (onglet API de la fiche) — et ne peuvent agir que sur l'instance à laquelle ils sont rattachés.
La mise en place, outil par outil, le format de l'événement envoyé et le catalogue d'API sont décrits dans la page dédiée : Middlewares iPaaS.
Suivi et journaux
L'onglet Journaux de chaque connecteur liste les dernières exécutions : date, flux, type d'événement, statut, code HTTP, durée et message.
- L'envoi vers les outils externes est asynchrone : il n'impacte jamais l'enregistrement de la tâche dans FoxPlan. En cas d'échec d'un connecteur, l'action FoxPlan aboutit normalement et l'erreur est journalisée.
- Les journaux sont purgés automatiquement après une période de rétention (60 jours par défaut), gérée par un index TTL MongoDB.
Les URLs de webhook Slack / Teams / Google Chat saisies directement sur la fiche projet continuent de fonctionner comme avant, en parallèle des connecteurs. Les connecteurs de la place de marché ne les remplacent pas : ils offrent une configuration centralisée à l'échelle de l'espace de travail.
Sécurité
- Tous les secrets de connecteurs sont chiffrés (AES-GCM) avec une clé dédiée (
CONNECTOR_SECRETS_ENCRYPTION_KEY). - Les données de connecteurs (installations, configuration de flux, journaux) sont cloisonnées par espace de travail (tenant).
- L'accès à l'écran est restreint aux comptes FoxPlan, et les appels d'API correspondants sont protégés côté serveur.