Logo Boond Manager
Plan Pro — pensé pour les ESN

Intégration Boond Manager

Arrêtez la double saisie entre votre outil commercial et votre ERP ESN. Chaque contact créé, chaque appel journalisé, chaque note prise dans Forge remonte automatiquement vers Boond Manager. La synchronisation est asynchrone avec file de retry, ce qui signifie que votre équipe commerciale ne subit jamais la latence de Boond, et qu'aucune action n'est perdue même si l'API est indisponible pendant plusieurs heures.

Ce qui remonte vers Boond, automatiquement

Contacts

Nom, prénom, email, téléphone, société, poste, LinkedIn. Déduplication par email côté Boond avec stockage du boondContactId en retour.

Actions commerciales

Chaque Activity CALL / EMAIL / MEETING / TASK / DEADLINE devient une action Boond typée avec date, contenu, contact et société rattachés.

Notes

Les notes privées Forge deviennent des commentaires rattachés au contact côté Boond. Stockage du boondNoteId pour édition ultérieure idempotente.

Sociétés rattachées

Les sociétés créées dans Forge sont mappées sur les sociétés Boond via findOrCreate, avec stockage de l'identifiant côté Forge pour idempotence.

Identité ressource

Votre user token Boond est résolu en boondResourceId + boondAgencyId dès la première sync, pour que chaque action soit correctement attribuée.

Idempotence garantie

Les IDs Boond sont persistés côté Forge (boondContactId, boondActionId, boondCompanyId). Une re-sync ne crée jamais de doublon — elle met à jour.

Architecture de la synchronisation

  1. 1

    Configuration côté SUPER_ADMIN

    Dans /admin onglet Clients, un SUPER_ADMIN renseigne pour chaque client les credentials Boond : URL de l'instance (par défaut https://ui.boondmanager.com/api), client token et client key fournis par Boond. Ces valeurs sont chiffrées avant persistance dans ClientConfig.

  2. 2

    Connexion individuelle par utilisateur

    Chaque utilisateur Forge colle son user token Boond dans /settings onglet Intégrations. La première requête API résout automatiquement son boondResourceId et boondAgencyId par email et les persiste — plus besoin de reconfigurer ensuite.

  3. 3

    Sync fire-and-forget sur chaque mutation

    Dès qu'une Person, Activity ou Note est créée ou modifiée dans Forge, une sync asynchrone est déclenchée via syncContactToBoond / syncActivityToBoond / syncNoteToBoond. Le code d'appel n'attend pas le résultat — l'UX reste instantanée, même si Boond est lent.

  4. 4

    Retry queue en cas d'échec

    Si la sync échoue (réseau, rate limit, auth invalide), l'opération est enregistrée dans BoondSyncQueue avec type, entityId et retries = 0. Chaque entrée est rejouée avec backoff exponentiel jusqu'à succès ou 5 tentatives, puis marquée en erreur définitive.

Résilience et observabilité

  • Fire-and-forget asynchrone : la création d'une Person, d'une Activity ou d'une Note ne bloque jamais l'UX sur la latence Boond. Si l'appel échoue, l'utilisateur voit quand même sa fiche créée immédiatement.
  • BoondSyncQueue : table dédiée qui stocke chaque sync en échec avec type, entityId, retries et nextRetry.
  • Backoff exponentiel : chaque entrée de la queue est rejouée avec une attente croissante (30 s → 60 s → 2 min → 5 min → 10 min). Le champ nextRetry pilote la prochaine tentative.
  • Plafond de 5 retries : au-delà, l'entrée est marquée en échec définitif et remontée dans l'onglet Admin Boond avec le dernier message d'erreur de l'API pour intervention manuelle.
  • Badge bleu « Boond » : dans la fiche contact Forge, un indicateur visuel confirme que la synchronisation est passée. Les activités synchronisées affichent un petit « B » en coin.

Questions fréquentes

Quelle authentification utilise Forge pour se connecter à Boond Manager ?

JWT signé HS256 avec la paire client token / client key fournie par Boond, plus un user token individuel par utilisateur Forge. Les trois valeurs sont stockées chiffrées en base. Chaque requête API Boond est signée à la volée avec une expiration courte — nous ne stockons jamais de session réutilisable côté client.

Quelles données Forge écrit-il dans Boond Manager ?

Trois types : contacts (Person côté Forge → contact Boond avec nom, prénom, email, téléphone, société, poste), activités (Activity CALL/EMAIL/MEETING/TASK → action Boond avec type mappé, date, contenu) et notes (Note → commentaire attaché au contact). Les identifiants Boond (boondContactId, boondActionId, boondCompanyId) sont conservés côté Forge pour assurer l'idempotence — pas de doublons lors de re-sync.

Comment Forge gère-t-il les entreprises côté Boond ?

Trois niveaux de résolution : si la Person a déjà un identifiant société Boond c'est lui ; sinon on regarde celui de l'Organization associée ; sinon on appelle findOrCreateCompany sur Boond avec le nom d'entreprise. L'ID retourné est persisté côté Organization ET Person pour les sync ultérieures — pas de doublons.

Que se passe-t-il si l'API Boond est indisponible ou rate-limitée ?

L'appel échoue, mais la sync ne disparaît pas : elle est automatiquement placée dans la table BoondSyncQueue avec un compteur de retries et un nextRetry. Chaque entrée est rejouée avec un backoff exponentiel (30 s → 60 s → 2 min → 5 min) jusqu'à 5 tentatives. Au-delà, elle est marquée en erreur et remontée dans l'onglet Admin pour intervention manuelle.

Est-ce que je peux choisir quels types d'activités se synchronisent ?

Oui, via la configuration client (section Intégration Boond dans /admin pour les SUPER_ADMIN, ou /settings pour l'utilisateur). Vous pouvez désactiver individuellement la sync des CALL, EMAIL, MEETING, TASK ou DEADLINE. Les notes se synchronisent de façon indépendante. Les templates d'action Boond (commercial, recrutement, interne) sont mappés sur les types Forge via une matrice configurable.

La synchronisation est-elle bidirectionnelle ?

Actuellement la sync est sortante (Forge → Boond). Les modifications faites côté Boond ne remontent pas automatiquement dans Forge. Cette décision vient d'un retour terrain : la double saisie perçue était le plus souvent Forge → Boond, et un pull Boond → Forge aurait introduit des conflits difficiles à résoudre (qui gagne si la même fiche est éditée des deux côtés ?). Une sync bidirectionnelle reste sur la roadmap — contactez-nous si c'est bloquant pour votre équipe.

Mon ressource Boond n'est pas reconnue quand je connecte mon compte, pourquoi ?

Forge cherche votre ressource Boond par email à la première sync. Si votre email Forge ne correspond pas exactement à l'email de votre ressource Boond (casse, alias, domaine différent), la résolution échoue. Deux solutions : saisir manuellement votre boondResourceId et boondAgencyId dans /settings onglet Intégrations, ou aligner l'email Forge avec l'email Boond. L'ID ressource est visible dans l'URL de votre profil Boond.

Complémentaire avec

Boond Manager se combine particulièrement bien avec les intégrations email Microsoft Outlook et Gmail — chaque email envoyé peut devenir une action Boond attachée au bon contact. Voir toutes les intégrations.

Votre ESN mérite mieux que la double saisie

Tester l'intégration Boond en conditions réelles prend 5 minutes. Plan Pro, sans engagement.

Démarrer un essai