Contact
Plateforme API de réception de leads partenaires (alias PSR)

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.

Février 2021 - 2024
~3 ans
Project Manager / Product Owner - Responsable Plateforme API
Groupe Pichet
REST APIMicrosoft APIMAdobe Campaign v7Dynamics 365AWS EKSKubernetesK8sDockerGitLab CIJira

API Partenaires

Dizaines

Intégrées et maintenues

Volume de Leads

~**K/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 projet en quelques mots

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.

Ce qu'est la plateforme

Plateforme API REST centralisée pour la réception, la normalisation et le routage multi-partenaires de leads

Domaine métier

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

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.
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.

Objectifs, Contexte, Enjeux & Risques

Vision stratégique et contraintes

Objectifs et critères de succès
  • 1Intégrer des dizaines de partenaires externes sans développement custom côté CRM par partenaire.
  • 2Maintenir zéro incident majeur de perte de leads pendant et après chaque onboarding.
  • 3Réduire le délai d'intégration d'un nouveau partenaire de semaines à jours.
  • 4Garantir une gouvernance auditable des credentials et accès sur l'ensemble des partenaires.
  • 5Dé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.

Pipeline du cycle de vie des leads
Cycle de vie complet d'un lead, de la source partenaire au CRM

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

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.

  • 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.
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.

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.

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.

Distribution de l'Effort Technique

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.

Parcours associé

Expérience professionnelle liée à cette réalisation

Technical Lead · Flux et Produits : contenus et intégration d'entreprise

Compétences mobilisées

Compétences techniques et humaines appliquées

Compétences techniques

Architecture & Conception5/5

Architecture Logicielle & Système

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 & Cloud4/5

DevOps, Cloud & Industrialisation Production

Dashboards SOFT Monitor, alertes email temps réel, observabilité par partenaire

Sécurité4/5

Sécurité Applicative & Conformité

Isolation des credentials via APIM, conformité RGPD et audit de sécurité 2023

Galerie d'images

Captures et visuels du projet

Présentation du comite d'architecture Groupe Pichet avec objectifs, processus de gouvernance et schema vision SI
Comite d'architecture - Objectifs et gouvernance
Schema de flux technique détaillé montrant la séquence d'intégration des données partenaires avec points de décision et appels API
Flux technique - Séquence d'intégration partenaires
Schéma de flux de données legacy-à-CRM montrant les appels API, le traitement des événements et la synchronisation base de données
Flux de données - Traitement legacy-à-CRM
Architecture Azure API Management avec authentification Active Directory, API Gateway, MongoDB, Power BI et infrastructure Terraform
Architecture - Plateforme Azure API Management

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