APIs externes (prévues)
Vue d’ensemble
Section intitulée « Vue d’ensemble »L’architecture cible introduit trois nouvelles intégrations d’APIs externes (en plus du géocodage BAN et de HubSpot Forms existants) :
| Service | Statut | Fonction |
|---|---|---|
| BAN (Base Adresse Nationale) | Actif | Géocodage d’adresses |
| HubSpot Forms API | Actif | Soumission de formulaires (actuel) |
| Symphonics API | Prévu | Recherche de PDL et données contractuelles |
| Enedis API | Prévu | Enrichissement de données énergétiques |
| HubSpot CRM API | Prévu | Gestion étendue des Contacts + Deals |
Symphonics API
Section intitulée « Symphonics API »Fonction
Section intitulée « Fonction »L’API Symphonics donne accès aux données PDL (Point de Livraison) — les références des points de livraison d’électricité en France. Elle permet :
- Recherche de PDL par adresse — Trouver les points de raccordement électrique à proximité d’une adresse donnée
- Profils contractuels — Récupérer le type de contrat, la puissance souscrite et les détails du fournisseur
- Données de consommation — Accéder aux profils historiques de consommation électrique
Point d’intégration
Section intitulée « Point d’intégration »L’orchestrateur Node.js appellera l’API Symphonics lors de l’étape “recherche PDL” du pipeline de traitement des prospects. Les résultats sont stockés dans SQLite pour les étapes de traitement suivantes.
Documentation de référence
Section intitulée « Documentation de référence »La documentation complète de l’API est disponible dans le dépôt du plugin :
docs/process_update/symphonics_api/documentation.md
Enedis API
Section intitulée « Enedis API »Fonction
Section intitulée « Fonction »L’API Enedis fournit un enrichissement détaillé des données énergétiques :
- Profils de consommation électrique
- Détails de raccordement au réseau
- Données de comptage
Point d’intégration
Section intitulée « Point d’intégration »Appelée lors de l’étape “enrichissement de données” du pipeline de traitement des prospects, après l’identification du PDL via Symphonics.
HubSpot CRM API (étendu)
Section intitulée « HubSpot CRM API (étendu) »Intégration actuelle
Section intitulée « Intégration actuelle »Le plugin Irisolaris Map existant utilise la HubSpot Forms API pour des soumissions de formulaires unidirectionnelles :
POST /submissions/v3/integration/submit/{portalId}/{formId}- 21 champs (7 client + 14 enrichis côté serveur)
- Le suivi du statut des soumissions et des enregistrements CRM est géré par l’extension prévue de l’orchestrateur
Extension prévue
Section intitulée « Extension prévue »L’orchestrateur utilisera la HubSpot CRM API complète pour des interactions plus riches :
| Opération | Fonction |
|---|---|
| Create Contact | Nouvel enregistrement de prospect dans le CRM HubSpot |
| Update Contact | Enrichissement avec les données Symphonics/Enedis |
| Create Deal | Suivi du pipeline pour les contrats ACC |
| Update Deal | Progression à travers les étapes contractuelles |
| Associate Contact ↔ Deal | Liaison du prospect à son deal ACC |
Cela permet :
- La synchronisation bidirectionnelle (WordPress ↔ HubSpot)
- Le suivi des étapes du pipeline
- La progression automatique des deals basée sur les résultats d’enrichissement des données
- Le reporting sur les taux de conversion et la santé du pipeline
Plan de migration
Section intitulée « Plan de migration »La transition des intégrations API actuelles vers les intégrations cibles :
- Phase 1 (actuelle) : HubSpot Forms API uniquement — soumissions de formulaires unidirectionnelles
- Phase 2 (prévue) : L’orchestrateur gère la soumission de formulaire → recherche PDL → enrichissement → synchronisation CRM
- Phase 3 (prévue) : Automatisation complète du pipeline avec monitoring et alertes
La soumission de formulaire Irisolaris Map existante continuera à fonctionner pendant la transition. L’intégration CRM de l’orchestrateur remplacera à terme la soumission directe via la Forms API.