--- title: "Plateforme API de réception de leads partenaires (alias PSR)" description: "Plateforme API centralisée qui route les leads immobiliers de dizaines de portails partenaires vers le CRM commercial." locale: "fr" canonical: "https://portfolio.josedacosta.info/fr/realisations/plateforme-api-reception-leads-partenaires" source: "https://portfolio.josedacosta.info/fr/realisations/plateforme-api-reception-leads-partenaires.md" html_source: "https://portfolio.josedacosta.info/fr/realisations/plateforme-api-reception-leads-partenaires" author: "José DA COSTA" date: "2021" type: "achievement" slug: "plateforme-api-reception-leads-partenaires" tags: ["REST API", "Microsoft API Manager", "Adobe Campaign v7", "Dynamics 365", "AWS EKS", "Kubernetes", "Docker", "GitLab CI", "SOFT Monitor", "Jira"] generated_at: "2026-05-26T15:38:47.843Z" --- # Plateforme API de réception de leads partenaires (alias PSR) Plateforme API centralisée qui route les leads immobiliers de dizaines de portails partenaires vers le CRM commercial. **Date:** Février 2021 - 2024 **Durée:** ~3 ans **Rôle:** 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 ### Indicateurs clés - API Partenaires: **-** - Intégrées 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 - Dizaines: **-** ## Présentation _Définition et périmètre du projet_ ### Le projet en quelques mots ### Ce qu'est la plateforme Plateforme API REST centralisée pour la réception, la normalisation et le routage multi-partenaires de leads ### Immobilier / PropTech - Lead Management (B2B interne + B2B partenaires externes) ### Décisions Architecturales Clés - API Gateway managé - OAuth, throttling et analytics par partenaire nativement, plutôt que tout reconstruire en interne. - Routage via une couche d'enrichissement marketing - Enrichissement et déduplication avant injection CRM, pour préserver le workflow commercial. - Un endpoint dédié par partenaire - Logique de normalisation isolée, debug plus simple, pas de configuration runtime complexe. ### Périmètre Fonctionnel - API REST standardisées par partenaire. - Normalisation des leads quel que soit le format partenaire. - Routage vers le CRM commercial. - Détection des anomalies : leads bloqués, doublons, erreurs de format. - Credentials et accès API centralisés via APIM. - Monitoring temps réel de la qualité des leads avec alertes. Le **PSR** est la **plateforme API centralisée** de réception de leads partenaires que j'ai pilotée. Chaque partenaire se connecte via un **endpoint API dédié**, qui normalise les données et les transmet au CRM commercial via la couche de routage marketing et le **Microsoft API Manager (APIM)**. En tant que **Technical Lead 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 routé se traduit directement en une **opportunité commerciale manquée** dans un marché immobilier très compétitif. Domaine métier ## Objectifs, Contexte, Enjeux & Risques _Vision stratégique et contraintes_ ### Objectifs et critères de succès - Intégrer des dizaines de partenaires externes sans développement custom côté CRM par partenaire. - Maintenir zéro incident majeur de perte de leads pendant et après chaque onboarding. - Réduire le délai d'intégration d'un nouveau partenaire de semaines à jours. - Garantir une gouvernance auditable des credentials et accès sur l'ensemble des partenaires. - Détecter les anomalies de traitement en minutes plutôt qu'en jours. ### Pourquoi ce projet a vu le jour Le projet a été initié au sein de l'**équipe SI Marketing** du Groupe Pichet, où le nombre croissant de sources de leads externes (portails immobiliers, partenaires publicitaires, plateformes marketing) a créé le besoin d'un **point d'entrée unique** pour centraliser et normaliser les leads entrants avant de les router vers le CRM commercial. Le paysage existant était fragmenté : chaque partenaire avait son propre format de données, sa méthode 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 commerciaux et stratégiques 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 compétitif : perdre un lead à cause d'une erreur de routage ou d'une intégration retardée signifie donner ce prospect à un concurrent. Avec des dizaines de 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 journée 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 : clés API uniques, permissions délimitées. - Rotation systématique des clés API via le cycle de vie APIM. - Conformité RGPD : HTTPS exclusif, pas de stockage persistant intermédiaire, CRM seul référentiel. - Audit de sécurité formel au cours du projet → contrôles d'accès renforcés et règles pare-feu mises à jour. - Validation au gateway : format, taille de payload, rejet des requêtes malformées. ### Risques identifiés en amont - 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 des dizaines de partenaires via l'APIM nécessité une gestion rigoureuse du cycle de vie des credentials. - Dépendance à la couche de routage marketing - La migration v6 vers v7 de la couche de routage marketing a nécessité des changements d'URL sur toutes les configurations partenaires - une seule erreur pouvait silencieusement perdre des leads. ## Les Étapes - Ce que J'ai Fait _Progression chronologique du projet_ - Phase 1 - Fondation de la Plateforme & Premier Partenaire - Fév 2021 - J'ai intégré la première API partenaire : VotreAppartementNeuf - J'ai posé l'architecture du PSR : réception, normalisation et routage - Côté sécurité, j'ai configuré les credentials Microsoft API Manager pour le CRM commercial - Pour superviser la plateforme, j'ai installé SOFT Monitor et les notifications d'alertes email - Phase 2 - Intégration Rapide des Partenaires - Juin - Dec 2022 - J'ai intégré l'API SeLoger, le portail immobilier majeur - Côté marketing, j'ai intégré l'API Myopla - J'ai raccordé Cooper Advertising et déployé l'intégration en pré-production - En parallèle, j'ai intégré Akrivia Leads et Visibilitie - En décembre 2022, j'ai intégré l'API Clovis - Pour enrichir les leads, j'ai ajouté les champs "Commentaire" et "Apport" dans l'API - Phase 3 - Stabilisation & Évolutions - Jan - Fév 2023 - J'ai intégré l'API Fine Media, dernier partenaire documenté - Côté qualité, j'ai résolu les anomalies de routage et géré les leads bloqués - J'ai migré toutes les URL de la couche de routage marketing de v6 vers v7 - Sur un incident complexe, j'ai diagnostiqué et résolu une anomalie de routage inter-systèmes - Pour sécuriser la plateforme, j'ai mené une revue de sécurité approfondie de l'infrastructure - Phase 4 - Refonte Architecturale - 2024 - J'ai piloté la refonte majeure du PSR autour d'une nouvelle architecture API SeLoger - Côté routage marketing, j'ai reconçu la couche d'intégration API - Pour gagner en robustesse, j'ai amélioré la gestion d'erreurs, la logique de retry et l'observabilité - Pour assurer la continuité de l'équipe, j'ai documenté le playbook complet d'intégration partenaire ## Les Acteurs - Les Interactions _Avec qui j'ai interagi directement et comment j'ai orchestré la collaboration_ ### Comment j'ai coordonné marketing, IT et partenaires externes ### Leadership Technique & Transfert de Connaissances - J'ai documenté sur Confluence le playbook complet d'intégration partenaire. - J'ai maintenu la documentation API sur 5 versions (v1 à v5). - Côté partenaires externes, j'ai formé les équipes sur les specs API, l'authentification et les procédures de test. - Franck C. - Manager - Avec lui, j'ai validé les intégrations et priorisé le backlog d'onboarding partenaire. - Cyril M. - SI Marketing - Avec lui, j'ai coordonné les specs techniques et les besoins business avec les partenaires. - Emilie D. - Prestataire externe - Avec elle, j'ai maintenu la documentation Confluence PSR et la base de connaissances. - Partenaires externes - SeLoger, Myopla, Cooper... - Avec eux, j'ai récupéré les specs API et les credentials de test, et validé chaque intégration avant go-live. J'ai piloté le projet PSR à l'intersection du **marketing, de l'IT et des partenaires externes**. Pour chaque nouvelle intégration partenaire, j'ai coordonné 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_ ### Pour moi - Compétences acquises et renforcées grâce à ce projet - J'ai acquis une expertise à l'échelle entreprise sur les patterns d'intégration API (auth, normalisation, routage, gestion d'erreurs). - Côté posture, j'ai appris à orchestrer un écosystème multi-parties entre marketing, IT et partenaires externes. - J'ai porté l'ownership d'une plateforme critique où chaque défaillance impactait directement le commercial. - Ce projet a changé ma façon de travailler : je raisonne désormais comme 'point unique de responsabilité' et j'investis dans l'outillage de monitoring dès le jour 1 d'une plateforme critique. ### Valeur livrée au Groupe Pichet - Dizaines d'API partenaires intégrées, diversifiant les canaux d'acquisition de leads. - Point d'entrée unique, supprimant le besoin de développement custom côté CRM par partenaire. - Monitoring temps réel, ramenant la perte silencieuse de leads de jours à minutes. - Onboarding de nouveaux partenaires réduit de semaines à jours grâce au playbook PSR. ### Stratégie de Monitoring & Observabilité - Dashboard SOFT Monitor avec jauges KPI en temps réel suivant la sante des flux de leads de dizaines de partenaires simultanément - Alertes email automatisées declénchees sur les anomalies de traitement de leads : leads bloqués, é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 Démontrées ### 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 (couche de routage marketing 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 responsabilité) - Transfert de Connaissances & Documentation (playbooks, docs API v1-v5) - Prise de Décision sous Pression Business - Animation de Meetups Techniques Internes & Formation d'Équipe ## Les Lendemains du Projet _Ce qui s'est passé après la livraison_ ### Où en est le projet aujourd'hui Après la vague initiale (2021-2023), le PSR est entré en **phase de stabilisation** et a continué à traiter les leads quotidiennement. La **refonte 2024** a modernisé l'intégration SeLoger et la couche de routage marketing. Aujourd'hui, le PSR reste **le point d'entrée unique pour toute l'acquisition de leads externes** au Groupe Pichet. Le playbook que j'ai documenté permet à l'équipe d'intégrer de nouveaux partenaires en autonomie. ## Mon Regard Critique _Comment je juge ce projet avec le recul_ ### Ce qui a bien fonctionné et pourquoi - J'ai tenu une approche partenaire par partenaire : chaque intégration validée avant la suivante, zéro perte majeure de leads. - Avec APIM en gateway, j'ai isolé les credentials, géré le throttling et évité tout accès direct des partenaires aux systèmes internes. - Côté monitoring temps réel, le dispositif que j'ai mis en place fait remonter les problèmes en minutes au lieu de jours. - J'ai bâti une couche de normalisation qui unifie des dizaines de formats hétérogènes dans un schéma propre côté CRM. ### Ce qui aurait pu être mieux fait - Sur la migration v6 vers v7, j'ai dû faire des mises à jour manuelles sur chaque configuration partenaire - j'aurais pu l'outiller davantage. - Sur la déduplication, je suis resté basique et les cas limites demandaient une revue manuelle que j'aurais pu automatiser. - Côté tests d'intégration, je n'ai pas suffisamment automatisé - le processus restait manuel et chronophage. - J'ai souvent produit la documentation après coup plutôt que pendant le développement, et j'aurais gagné à l'écrire en continu. ### Trade-offs & Arbitrages Techniques - Dette technique assumée sur la déduplication en Phase 2 - J'ai volontairement livré une déduplication basique pour tenir la deadline des 6 partenaires et j'ai planifié la refonte propre pour 2024. - Refus de contourner la couche de routage marketing - J'ai préservé la traçabilité et le workflow commercial plutôt que d'économiser 200 ms. - Endpoints dédiés par partenaire - J'ai assumé plus de code pour garder chaque intégration isolée et facile à debugger. - Pas de retry asynchrone en Phase 1 - J'ai démarré en synchrone pour un monitoring simple, puis j'ai ajouté le retry en Phase 4. ### Les enseignements durables que ce projet m'a apportés - J'ai appris qu'en lead management, la vitesse compte autant que la précision : les leads refroidissent vite. - J'ai vu qu'une couche gateway (type APIM) est indispensable face à plusieurs partenaires externes. - J'ai mesuré que la validation par partenaire avec le métier est non-négociable, même pour des intégrations techniquement identiques. - J'ai constaté qu'un bon playbook d'intégration survit au départ de son auteur - c'est l'investissement le plus rentable pour la continuité de l'équipe. ### Contexte additionnel - Chronologie d'Intégration des Partenaires - Distribution des Tickets Jira - Étapes du Flux de Leads (% retention) - Intégrations Partenaires par Année - Distribution de l'Effort Technique - Statut des Partenaires - Architecture Système - Pipeline du cycle de vie des leads - Cycle de vie complet d'un lead, de la source partenaire au CRM - API Partenaires Intégrées - Processus d'Intégration Partenaire ## Compétences mobilisées _Compétences techniques et humaines appliquées_ - **[Pilotage Projet & Méthodes Agiles](https://portfolio.josedacosta.info/fr/competences/pilotage-projet-methodes-agiles.md)** - Point de contact technique unique pour des dizaines de partenaires externes et équipes internes, Project Manager / Product Owner de la plateforme de 2021 à 2023 - **[Résolution de Problèmes & Adaptabilité](https://portfolio.josedacosta.info/fr/competences/resolution-de-problemes-adaptabilite.md)** - Diagnostic d'anomalies inter-systèmes et migrations complexes de configurations partenaires - Maîtrise de Microsoft APIM et du domaine lead management immobilier - **[Pédagogie & Communication & Collaboration](https://portfolio.josedacosta.info/fr/competences/pedagogie-communication-collaboration.md)** - Cycle d'intégration API avec les partenaires externes : specs, tests, validation, go-live - **[Architecture Logicielle & Système](https://portfolio.josedacosta.info/fr/competences/architecture-logicielle-systeme.md)** - Architecture de bout en bout : gateway API, normalisation, enrichissement, routage CRM, Conception des endpoints REST partenaires, contrats de données et 5 versions d'API - **[DevOps, Cloud & Industrialisation Production](https://portfolio.josedacosta.info/fr/competences/devops-cloud-industrialisation-production.md)** - Dashboards SOFT Monitor, alertes email temps réel, observabilité par partenaire - **[Sécurité Applicative & Conformité](https://portfolio.josedacosta.info/fr/competences/securite-applicative-conformite.md)** - Isolation des credentials via APIM, conformité RGPD et audit de sécurité 2023 ## Parcours associé _Expérience professionnelle liée à cette réalisation_ - **Technical Lead · Flux et Produits : contenus et intégration d'entreprise** ## Galerie d'images _Captures et visuels du projet_ ## Vous avez une API de réception partenaires à concevoir ? J'ai livre la PSR API Partenaires : authentification, versioning, documentation OpenAPI et monitoring des usages pour l'ouverture B2B a des tiers. Parlons de votre contexte. **Contactez-moi**