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'onglet Connecteurs n'est visible que pour les collaborateurs FoxPlan (compte dont l'email ou le login se termine par @fox-plan.com). Il s'agit d'une fonctionnalité en cours de déploiement, pilotée par les équipes FoxPlan pour le compte des clients.
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 |
- 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 flux de notification réagissent aux événements de tâche suivants :
- Changement de statut d'une tâche
- Changement de responsable (affectation)
- Changement d'affectation planning
- Ajout d'un commentaire
Les flux 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 tant que ces options ne sont pas cochées sur les projets concernés.
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.
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.