--- title: "PSR - Plateforme API Centralisee de Leads Partenaires" description: "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." locale: "fr" canonical: "https://portfolio.josedacosta.info/fr/realisations/psr-plateforme-api-partenaires" source: "https://portfolio.josedacosta.info/fr/realisations/psr-plateforme-api-partenaires.md" html_source: "https://portfolio.josedacosta.info/fr/realisations/psr-plateforme-api-partenaires" author: "José DA COSTA" date: "2021" type: "achievement" slug: "psr-plateforme-api-partenaires" tags: ["REST API", "Microsoft API Manager", "Adobe Campaign v7", "Dynamics 365", "AWS EKS", "Kubernetes", "Docker", "GitLab CI", "SOFT Monitor", "Jira"] generated_at: "2026-04-23T15:45:13.799Z" --- # 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. **Date:** Février 2021 - 2024 **Duration:** ~3 ans **Role:** Project Manager / Product Owner - Responsable Plateforme API **Technologies:** REST API, Microsoft API Manager, Adobe Campaign v7, Dynamics 365, AWS EKS, Kubernetes, Docker, GitLab CI, SOFT Monitor, Jira ### Key Metrics - API Partenaires: **-** - Integrees et maintenues - Volume de Leads: **-** - ~1 lead toutes les 2 secondes en pic - Taux de Perte: **-** - Zero incident majeur de perte - Délai d'Intégration: **-** - Reduit de semaines à jours ## Présentation _Définition et périmètre du projet_ ### Nature Plateforme API REST centralisee pour la reception, normalisation et routage multi-partenaires de leads ### Domain Immobilier / PropTech - Lead Management (B2B interne + B2B partenaires externes) ### Décisions Architecturales Clés - [object Object] - [object Object] - [object Object] ### Scope - 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 **Content:** 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 Label:** Nature **Domain Label:** Domaine **Scope Label:** Périmètre Fonctionnel ## Objectifs, Contexte, Enjeux & Risques _Vision stratégique et contraintes_ ### Obj - Exposer des API standardisées pour chaque partenaire avec des contrats de données cohérents - Normaliser toutes les données leads independamment du format spécifique au partenaire - Router les leads de manière fiable vers le CRM Hermes via Adobe Campaign pour le suivi commercial - Superviser la qualité des flux : détection d'anomalies, leads bloques, filtrage des doublons - Gerer les credentials et les accès API de manière centralisee via Microsoft API Manager ### Context 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. ### Stakes 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 ### Risk - [object Object] - [object Object] - [object Object] - [object Object] **Objectives:** Objectifs **Context:** Contexte **Stakes:** Enjeux **Risks:** Risques ## Les Étapes - Ce que J'ai Fait _Progression chronologique du projet_ ## Les Acteurs - Les Interactions _Équipes, parties prenantes et collaboration_ ### 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 **Content:** 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. ## Les Résultats _Impact pour moi et pour l'entreprise_ ### For Me - 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 ### For Company - 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 **For Me:** Pour Moi **For Company:** Pour l'Entreprise ## Les Lendemains du Projet _Ce qui s'est passe après la livraison_ **Content:** 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. ## Mon Regard Critique _Leçons apprises et évaluation honnete_ ### Positive - 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 ### Improvement - 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 ### Tradeoff - [object Object] - [object Object] - [object Object] - [object Object] ### Lesson - 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 **Positives:** Ce Qui a Bien Fonctionne **Improvements:** Ce Qui Pourrait Être Ameliore **Lessons:** Leçons Apprises