PSR - Plateforme API Centralisee de Leads Partenaires

Plateforme API centralisee recevant et routant les leads immobiliers de 9+ portails partenaires externes vers le CRM Hermes via Adobe Campaign - chaque intégration partenaire supervisée de bout en bout, de la spécification API au monitoring en production.

Février 2021 - 2024

~3 ans

Project Manager / Product Owner - Responsable Plateforme API

REST APIMicrosoft APIMAdobe Campaign v7Dynamics 365AWS EKSKubernetesDockerGitLab CISOFT MonitorJira

PSR - Plateforme API Centralisee de Leads Partenaires

Février 2021 - 2024

~3 ans

Project Manager / Product Owner - Responsable Plateforme API

REST APIMicrosoft APIMAdobe Campaign v7Dynamics 365AWS EKSKubernetesDockerGitLab CISOFT MonitorJira

API Partenaires

Integrees et maintenues

Volume de Leads

~43K/day

~1 lead toutes les 2 secondes en pic

Taux de Perte

~0%

Zero incident majeur de perte

Délai d'Intégration

weeks -> days

Reduit de semaines à jours

Présentation

Définition et périmètre du projet

Le PSR (Pichet Services Repository) est la plateforme API centralisee du Groupe Pichet pour la reception et le routage des leads immobiliers provenant des portails partenaires externes. Chaque portail immobilier ou partenaire marketing générant des prospects pour Pichet se connecté au PSR via un endpoint API dedie, qui normalise les données et les transmet au CRM Hermes (Dynamics 365) via Adobe Campaign (Neolane) et le Microsoft API Manager (APIM).

En tant que Lead Developer et responsable de la plateforme API, j'ai supervisé l'intégration de chaque nouvelle API partenaire et les évolutions fonctionnelles de la plateforme, en coordination avec les équipes marketing et les prestataires techniques externes. Le PSR est un système critique pour le business : chaque lead perdu ou mal route se traduit directement en une opportunité commerciale manquée dans un marché immobilier très competitif.

Nature

Plateforme API REST centralisee pour la reception, normalisation et routage multi-partenaires de leads

Domaine

Immobilier / PropTech - Lead Management (B2B interne + B2B partenaires externes)

Périmètre Fonctionnel

Exposer des API REST standardisées pour chaque partenaire générateur de leads
Normaliser les données leads (nom, email, telephone, programme, source) quel que soit le format partenaire
Router les leads vers le CRM Hermes via Adobe Campaign (Neolane) pour le suivi commercial
Detecter les anomalies : leads bloques, doublons, erreurs de format
Gerer les credentials et les accès API via Microsoft API Manager (APIM)
Superviser la qualité des leads avec les alertes SOFT Monitor et notifications email

Architecture Système

PSR - System Architecture Overview

Décisions Architecturales Clés

Microsoft APIM comme API Gateway

Choisi plutôt qu'un reverse proxy custom pour centraliser la gestion des credentials, le throttling et le contrôle d'accès pour 9+ partenaires externes. APIM fournissait nativement OAuth, le rate limiting et l'analytique par partenaire - le développer en interne aurait pris des mois et introduit des risques de sécurité.

Adobe Campaign comme intermédiaire de routage (pas d'injection CRM directe)

Les leads transitent par Adobe Campaign (Neolane) avant d'atteindre le CRM pour profiter de ses capacités d'enrichissement et de déduplication. L'injection directe CRM était plus rapide mais aurait contourne le workflow commercial existant et supprime la couche d'enrichissement dont l'équipe marketing dependait.

Un endpoint dédié par partenaire (pas un endpoint générique)

Chaque partenaire à des formats de données, des champs obligatoires et des règles de validation uniques. Un endpoint générique aurait nécessité une configuration complexe à l'exécution et rendu le debug des problèmes spécifiques à un partenaire plus difficile. Les endpoints dédiés gardent la logique de normalisation isolée et testable par partenaire.

Objectifs, Contexte, Enjeux & Risques

Vision stratégique et contraintes

Objectifs

1Exposer des API standardisées pour chaque partenaire avec des contrats de données cohérents
2Normaliser toutes les données leads independamment du format spécifique au partenaire
3Router les leads de manière fiable vers le CRM Hermes via Adobe Campaign pour le suivi commercial
4Superviser la qualité des flux : détection d'anomalies, leads bloques, filtrage des doublons
5Gerer les credentials et les accès API de manière centralisee via Microsoft API Manager

Contexte

Le projet a été initie au sein de l'équipe SI Marketing du Groupe Pichet, ou le nombre croissant de sources de leads externes (portails immobiliers, partenaires publicitaires, plateformes marketing) a créé le besoin d'un point d'entree unique pour centraliser et normaliser les leads entrants avant de les router vers le CRM commercial.

Le paysage existant était fragmente : chaque partenaire avait son propre format de données, sa methode d'authentification et son protocole de livraison. Sans le PSR, l'intégration d'un nouveau partenaire nécessitait un développement custom côté CRM - une approche insoutenable à mesure que l'écosystème partenaire grandissait.

Enjeux

Les leads sont le nerf de la guerre commerciale dans l'immobilier. Chaque lead représente un acheteur potentiel, et le marché est très competitif : perdre un lead à cause d'une erreur de routage ou d'une intégration retardee signifie donner ce prospect à un concurrent. Avec 9+ partenaires générant des leads simultanément, le PSR est devenu le pipeline de données le plus critique alimentant le pipeline commercial quotidien des équipes.

L'impact commercial était direct et mesurable : une API partenaire hors service pendant une seule journee pouvait signifier des dizaines de prospects perdus - chacun représentant potentiellement des centaines de milliers d'euros en ventes immobilières.

Sécurité & Conformité RGPD

Isolation des credentials par partenaire via APIM : chaque partenaire recoit des clés API uniques avec des permissions delimitées - aucun partenaire ne peut acceder aux données ou endpoints d'un autre
Politique de rotation systematique des clés API appliquee via la gestion du cycle de vie APIM - credentials renouveles selon un calendrier pour limiter la fenêtre d'exposition
Conformité RGPD pour les données personnelles : les leads contiennent nom, email, telephone - données transmises exclusivement en HTTPS, aucun stockage persistant dans les couches intermédiaires, le CRM comme seul referentiel de données
Audit de sécurité conduit en février 2023 couvrant l'infrastructure PSR, la configuration APIM et l'intégration Adobe Campaign - resultant en des contrôles d'accès renforcés et des règles de pare-feu mises à jour
Validation des entrees au niveau gateway : contrôles de format, limités de taille de payload et rejet des requetes malformees avant que les données n'atteignent les systèmes internes

Risques

Perte de Leads

Toute défaillance API ou erreur de routage se traduit directement en prospects commerciaux perdus - irrecuperables dans un marché immobilier competitif.

Hétérogénéité des Formats

Chaque partenaire envoie ses données dans son propre format avec des champs obligatoires, règles de validation et encodages différents.

Proliferation des Credentials

La gestion des clés API, tokens et accès pour 9+ partenaires via l'APIM nécessité une gestion rigoureuse du cycle de vie des credentials.

Dépendance Adobe Campaign

La migration d'Adobe Campaign v6 vers v7 a nécessité des changements d'URL sur toutes les configurations partenaires - une seule erreur pouvait silencieusement perdre des leads.

Pipeline du Cyclé de Vie des Leads

End-to-end lead lifecycle from partner source to CRM

Les Étapes - Ce que J'ai Fait

Progression chronologique du projet

Phase 1

Fondation de la Plateforme & Premier Partenaire

Fév 2021

Intégration de la première API partenaire : VotreAppartementNeuf (KESD-20158)
Mise en place de l'architecture PSR : reception, normalisation, routage
Configuration des credentials Microsoft API Manager pour CRM Hermes et GED v2 (KESD-24176, KESD-25889)
Mise en place du monitoring avec SOFT Monitor et notifications d'alertes email

Phase 2

Intégration Rapide des Partenaires

Juin - Dec 2022

Intégration de l'API SeLoger (PSR-48) - portail immobilier majeur
Intégration de l'API Myopla (PSR-47, KESD-55205) - partenaire marketing
Intégration de Cooper Advertising (PSR-52) - déployé en pre-production
Intégration d'Akrivia Leads (PSR-58, KESD-66929) et Visibilitie (KESD-67023)
Intégration de l'API Clovis (PSR-60, KESD-68919) - décembre 2022
Ajout des champs "Commentaire" et "Apport" dans l'API (PSR-54, KESD-61307)

Phase 3

Stabilisation & Évolutions

Jan - Fév 2023

Intégration de l'API Fine Media (KESD-71757) - dernier partenaire documente
Correction des codes action et statuts de leads bloqués (PSR-51)
Migration de toutes les URL d'Adobe Campaign v6 vers v7 (PSR-56)
Investigation et résolution de l'anomalie Investimeo PSR vs Neolane (PSR-59)
Reunion d'audit de sécurité pour l'infrastructure PSR (fev 2023)

Phase 4

Refonte Architecturale

2024

Pilotage de la refonte majeure du PSR : nouvelle architecture API SeLoger
Reconception de la couche d'intégration Adobe Campaign API
Amélioration de la gestion d'erreurs, logique de retry et observabilité
Documentation du playbook complet d'intégration partenaire pour la continuité d'équipe

API Partenaires Integrees

Partner	Jira Ticket	Period	Status
VotreAppartementNeuf	KESD-20158	Feb 2021	Active
SeLoger	PSR-48	Jun 2022	Active
Myopla	PSR-47	Jun 2022	Active
Cooper Advertising	PSR-52	Oct 2022	Pre-prod
Akrivia Leads	PSR-58	Nov 2022	Active
Visibilitie	KESD-67023	Nov 2022	Active
Clovis	PSR-60	Dec 2022	Active
Fine Media	KESD-71757	Jan 2023	Active
Investimeo	PSR-59	2022	Investigated

Chronologie d'Intégration des Partenaires

Intégrations Partenaires par Année

Processus d'Intégration Partenaire

Step-by-step process for each partner integration

Les Acteurs - Les Interactions

Équipes, parties prenantes et collaboration

Le projet PSR operait à l'intersection du marketing, de l'IT et des partenaires externes. Chaque nouvelle intégration partenaire nécessitait la coordination entre l'équipe technique du partenaire (pour les spécifications API), l'équipe SI Marketing (pour la validation business) et l'équipe CRM (pour la confirmation du routage des leads). J'ai servi de point de contact technique unique pour toutes les intégrations partenaires.

Leadership Technique & Transfert de Connaissances

Rédaction du playbook complet d'intégration partenaire sur Confluence - un guide pas a pas permettant a n'importe quel membre de l'équipe d'intégrer un nouveau partenaire de manière autonome, du setup des credentials APIM au monitoring en production
Animation de meetups techniques internes sur les patterns d'intégration API, partageant les leçons apprises lors de l'onboarding des partenaires avec l'équipe SI élargie
Production et maintenance de la documentation API sur 5 versions (v1 a v5), servant de référence pour les équipes internes et les partenaires externes
Formation des équipes techniques des partenaires externes sur les spécifications API du PSR, les flux d'authentification et les procédures de test lors de chaque cycle d'onboarding
Définition des standards de qualité de code pour le codebase PSR : patterns de validation, conventions de gestion d'erreurs et pratiques de logging adoptees par l'équipe SI Marketing

Franck C.

N+1 Manager

Validation de chaque intégration partenaire, approbation des déploiements en production et priorisation du backlog d'intégration.

Cyril M.

Équipe SI Marketing

Coordination avec les partenaires externes sur les spécifications techniques, formats de données et exigences business.

Emilie D.

Équipe Kariba

Maintenance des pages de documentation Confluence PSR, contribution à la base de connaissances.

Partenaires Externes

SeLoger, Myopla, Cooper, Akrivia, Clovis, Fine Media...

Fourniture des spécifications API, credentials de test et validation des tests d'intégration avant mise en production.

Les Résultats

Impact pour moi et pour l'entreprise

Pour Moi

Montee en expertise sur les patterns d'intégration API : authentification, normalisation, routage, gestion d'erreurs à l'échelle enterprise
Maîtrise de la plateforme Microsoft API Manager pour la gestion des credentials et des accès
Développement de solides compétences de coordination à l'intersection du marketing, de l'IT et des partenaires externes
Acquisition d'expérience dans le domaine du lead management : qualité des données, déduplication, stratégies de routage CRM
Construction de la confiance dans la responsabilite d'une plateforme critique ou chaque défaillance avait un impact commercial direct

Pour l'Entreprise

9+ API partenaires intégrées → diversification des canaux d'acquisition de leads alimentant le pipeline commercial
Point d'entree centralise → elimination du besoin de développement custom côté CRM par partenaire
Format de données standardisé → qualité de leads cohérente quelle que soit la source, ameliorant l'efficacite des équipes commerciales
Monitoring temps réel → détection immédiate des anomalies, réduisant la perte de leads a quasi-zero
Architecture evolutive → intégration de nouveaux partenaires réduite de semaines à jours grâce àu playbook PSR
Refonte 2024 → pérennisation de la plateforme avec les nouvelles intégrations SeLoger et Adobe Campaign

Stratégie de Monitoring & Observabilité

Dashboard SOFT Monitor avec jauges KPI en temps réel suivant la sante des flux de leads de 9+ partenaires simultanément
Alertes email automatisées declénchees sur les anomalies de traitement de leads : leads bloques, échecs de validation de format, timeouts d'API partenaire et erreurs de routage
Suivi des flux par partenaire : chaque API partenaire dispose de son monitoring individuel avec logs de transactions, taux de succès/échec et tendances de volume
Détection proactive d'anomalies : les changements de format des partenaires (ajouts de champs, modifications d'encodage) détectés à la couche de validation avant d'impacter les systèmes en aval
Réponse aux incidents de production : le monitoring a permis une détection en moins d'une minute des pannes partenaires, réduisant la perte silencieuse de leads de jours a minutes

Compétences Demontrees

Compétences Techniques

Design d'API & Patterns d'Intégration
Architecture Système (Gateway, Mediation, Routage)
Sécurité API (APIM, OAuth, cycle de vie des credentials)
Monitoring & Observabilité (SOFT Monitor, alerting)
Normalisation & Gestion de la Qualité des Données
Planification de Migration (Adobe Campaign v6 vers v7)
CI/CD & Déploiement (GitLab CI, AWS EKS, Kubernetes)

Leadership & Soft Skills

Coordination Multi-parties (marketing, IT, partenaires externes)
Communication Technique avec des équipes non-techniques
Ownership de Plateforme (point unique de responsabilite)
Transfert de Connaissances & Documentation (playbooks, docs API v1-v5)
Prise de Décision sous Pression Business
Animation de Meetups Techniques Internes & Formation d'Équipe

Étapes du Flux de Leads (% retention)

Distribution des Tickets Jira

Statut des Partenaires

Les Lendemains du Projet

Ce qui s'est passe après la livraison

Après la vague initiale d'intégrations partenaires (2021-2023), le PSR est entre dans une phase de stabilisation et d'optimisation. La plateforme a continue a traiter les leads quotidiennement depuis tous les partenaires integres, avec les alertes de monitoring detectant les anomalies occasionnelles (changements de format par les partenaires, dépréciations d'API, renouvellements de credentials).

La refonte 2024 a marqué une évolution architecturale significative : l'intégration de l'API SeLoger a été repensée, et la couche Adobe Campaign API a été modernisee. Cette refonte a démontré que les choix architecturaux initiaux étaient solides mais nécessitaient une mise à jour à mesure que les exigences internes et les API partenaires externes évoluaient.

Aujourd'hui, le PSR resté le point d'entree unique pour toute l'acquisition de leads externes au Groupe Pichet. Le playbook d'intégration partenaire que j'ai documenté permet à l'équipe d'intégrer de nouveaux partenaires de manière autonome, assurant la continuité des connaissances au-dela de mon implication directe.

Distribution de l'Effort Technique

Mon Regard Critique

Leçons apprises et évaluation honnete

Ce Qui a Bien Fonctionne

L'approche incrémentale partenaire par partenaire a permis de valider chaque intégration minutieusement - zero incident majeur de perte de leads pendant l'intégration
L'utilisation de Microsoft APIM comme couche gateway a fourni une isolation propre des credentials et du throttling - les partenaires n'ont jamais eu d'accès direct aux systèmes internes
L'intégration SOFT Monitor a offert une visibilité en temps réel sur la sante des flux de leads, detectant les problèmes en minutes au lieu de jours
La couche de normalisation a absorbe avec succès l'hétérogénéité des formats de 9+ partenaires en un schema unique compatible CRM

Ce Qui Pourrait Être Ameliore

La migration Adobe Campaign v6 vers v7 a révélé une fragilité : les changements d'URL nécessitaient des mises à jour manuelles sur toutes les configurations partenaires
La logique de déduplication des leads aurait pu être plus sophistiquée - le matching basique était suffisant mais les cas limités nécessitaient une revue manuelle
Les tests d'intégration de bout en bout étaient manuels et chronophages - une simulation automatisée des partenaires aurait accéléré le cycle d'intégration
La documentation était parfois rédigée après coup plutôt que pendant le développement - une documentation plus précoce aurait facilité le transfert de connaissances

Trade-offs & Arbitrages Techniques

Dette technique acceptee sur la logique de déduplication en Phase 2

Le business avait besoin de 6 partenaires integres en 6 mois. Investir dans un moteur de matching sophistique aurait retarde les intégrations partenaires de 2-3 mois. La déduplication basique était "suffisante" pour le volume - on a planifié l'implémentation propre pour la phase de refonte 2024.

Refus de contourner Adobe Campaign pour une "injection CRM directe" demandee par un partenaire

Un partenaire voulait une livraison de leads plus rapide en sautant la couche d'enrichissement Neolane. J'ai refuse car cela aurait créé un flux de données parallele hors de notre monitoring, cassant la traçabilité des leads et le workflow de l'équipe commerciale. La latence de 200ms était acceptable.

Endpoints dédiés par partenaire plutôt qu'un endpoint générique pilote par configuration

Plus de code à maintenir par partenaire, mais chaque intégration est isolée : un bug dans la normalisation d'un partenaire n'affecte jamais les autres. Ce trade-off s'est avéré critique quand SeLoger a changé son format en cours de contrat - seul leur endpoint a nécessité une mise à jour.

Pas de file de retry asynchrone en Phase 1

Le traitement synchrone était plus simple a monitorer et debugger pendant la phase de stabilisation. Le retry async aurait ajoute de la complexité avant qu'on comprenne pleinement les patterns de défaillance. On a ajoute la logique de retry en Phase 4 une fois les patterns clarifies.

Leçons Apprises

En lead management, la rapidite compte autant que la précision - un routage rapide mais légèrement imparfait bat un routage lent mais parfait, car les leads refroidissent vite
Les couches API gateway (comme APIM) sont essentielles avec de multiples partenaires externes - elles fournissent sécurité, monitoring et isolation des credentials en une seule couche
La validation partenaire par partenaire avec les équipes business est non-negociable - même des intégrations techniquement identiques peuvent avoir des attentes business différentes
Un playbook d'intégration bien documenté est le meilleur investissement pour l'autonomie de l'équipe à long terme - le playbook PSR a survécu a mon implication directe sur le projet