Des agents branchés pour de vrai : HubSpot / Salesforce, open data, Bugzilla et interface de validation humaine
Brancher un même agent sur des systèmes réels sans réécrire la logique métier : contrat de provider CRM, enrichissement open data, tracker Bugzilla, puis API et front avec validation humaine.
Objectif pédagogique
À l’issue de la journée, les participants savent placer un contrat de provider entre l’agent et le CRM (sandbox → HubSpot → Salesforce), enrichir un compte avec des sources open data fiables, relier des tickets support à des bugs Bugzilla, et exposer le pipeline à des humains via une API et un front de validation (HITL), en mock puis en live.
Pour qui ?
- Développeurs et intégrateurs qui connectent des agents au SI
- Équipes sales ops / support tooling propriétaires d’un CRM ou d’un tracker
- Product builders qui veulent une interface de validation humaine
- Architectes préparant un passage mock → production
Prérequis
- Formation N1 + Python (venv, JSON, HTTP)
- Formation Expert recommandée (pipeline multi-agents)
- Optionnel : un portail HubSpot de test ou une org Salesforce Developer Edition pour le mode live
Programme — matin (théorie ~2h30)
| Module | Contenu | Durée |
|---|---|---|
| I1 | Contrat de provider : modèle normalisé (Account / Ticket / Note), mapping des vocabulaires, erreurs typées | 35 min |
| I2 | HubSpot CRM API v3 et Salesforce REST / SOQL : auth (Private App, OAuth), scopes minimaux, sandbox vs prod, quotas | 45 min |
| I3 | Open data FR pour le SI : BAN, SIRENE, geo.api.gouv.fr — licence, qualité, cache hors-ligne, cas limites | 30 min |
| I4 | Trackers : REST Bugzilla, triage assisté, lien ticket ↔ bug, écriture contrôlée | 20 min |
| I5 | Front pour agents : événements SSE, timeline d’outils, décision humaine, sécurité navigateur | 20 min |
Programme — après-midi (labs ~4h)
| Module | Contenu | Durée |
|---|---|---|
| TP1 | Même agent, trois CRM : sandbox → HubSpot (mock puis live) → Salesforce | 60 min |
| TP2 | Enrichir un compte avec l’open data (BAN, commune, SIRENE) et documenter les limites | 50 min |
| TP3 | Triage Bugzilla : mock, instance publique Mozilla, instance locale Docker ; lier ticket ↔ bug | 60 min |
| TP4 | API FastAPI + front HITL : lancer, suivre en SSE, approuver / rejeter, publier une note (dry-run) | 70 min |
Systèmes couverts
- HubSpot CRM API v3 (companies, tickets, notes, associations)
- Salesforce REST API + SOQL (Account, Case, Task) avec échappement sécurisé
- Base Adresse Nationale, Annuaire des entreprises (SIRENE), Découpage administratif — Licence Ouverte 2.0
- Bugzilla REST API (mock, bugzilla.mozilla.org en lecture, instance Docker locale)
- FastAPI + Server-Sent Events + front HTML/JS natif, portable en React / Next.js
Mock d’abord, live ensuite
Toutes les fixtures reprennent les formats des API réelles. Le passage en live est une variable d’environnement et un token de portail de test — jamais un compte de production. Les écritures restent en dry-run tant qu’un humain n’a pas approuvé.
Livrables participants
- Provider CRM : scénario HubSpot ou Salesforce PASS en mock (+ option : 1 appel live documenté)
- Rapport enrichi open data avec avertissements et attribution
- Triage : bugs liés + commentaire de liaison en dry-run
- Front : timeline SSE + décision HITL journalisée ; architecture mise à jour