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

Plateforme API de réception de leads partenaires (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
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
  • Intégration de la première API partenaire : VotreAppartementNeuf
  • Mise en place de l'architecture PSR : réception, normalisation, routage
  • Configuration des credentials Microsoft API Manager pour le CRM commercial
  • 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 - portail immobilier majeur
  • Intégration de l'API Myopla - partenaire marketing
  • Intégration de Cooper Advertising - déployé en pre-production
  • Intégration d'Akrivia Leads et Visibilitie
  • Intégration de l'API Clovis - décembre 2022
  • Ajout des champs "Commentaire" et "Apport" dans l'API
Phase 3
Stabilisation & Évolutions
Jan - Fév 2023
  • Intégration de l'API Fine Media - dernier partenaire documente
  • Résolution d'anomalies de routage et gestion des leads bloqués
  • Migration de toutes les URL de la couche de routage marketing v6 vers v7
  • Diagnostic et résolution d'une anomalie de routage inter-systèmes
  • Revue de sécurité approfondie sur l'infrastructure de la plateforme
Phase 4
Refonte Architecturale
2024
  • Pilotage de la refonte majeure du PSR : nouvelle architecture API SeLoger
  • Reconception de la couche d'intégration API de routage marketing
  • 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

Les Acteurs - Les Interactions

Équipes, parties prenantes et collaboration

Coordonner marketing, IT et partenaires externes

Le projet PSR opérait à 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.

  • Franck C. (Manager) - Valide les intégrations et priorise le backlog d'onboarding partenaire.
  • Cyril M. (SI Marketing) - Coordonne les specs techniques et les besoins business avec les partenaires.
  • Emilie D. (Prestataire externe) - Maintient la documentation Confluence PSR et la base de connaissances.
  • Partenaires externes (SeLoger, Myopla, Cooper...) - Fournissent les specs API, les credentials de test et valident avant go-live.
Leadership Technique & Transfert de Connaissances
  • Playbook d'intégration partenaire documenté sur Confluence.
  • Documentation API maintenue sur 5 versions (v1 à v5).
  • Formation des partenaires externes sur les specs API, l'authentification et les procédures de test.

Les Résultats

Impact pour moi et pour l'entreprise

Ce que j'en ai personnellement retiré
  • Expertise à l'échelle entreprise sur les patterns d'intégration API (auth, normalisation, routage, gestion d'erreurs).
  • Coordination multi-parties entre marketing, IT et partenaires externes.
  • Ownership d'une plateforme critique où chaque défaillance impactait directement le commercial.
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

Leçons apprises et évaluation honnete

Ce qui a bien fonctionné et pourquoi
  • Approche partenaire par partenaire : chaque intégration validée avant la suivante, zéro perte majeure de leads.
  • APIM comme gateway : credentials isolés, throttling géré, partenaires jamais en accès direct aux systèmes internes.
  • Monitoring temps réel : les problèmes détectés en minutes au lieu de jours.
  • Couche de normalisation : des dizaines de formats hétérogènes unifiés dans un schéma propre côté CRM.
Ce qui aurait pu être mieux fait
  • La migration v6 vers v7 a exigé des mises à jour manuelles sur chaque configuration partenaire.
  • La déduplication restait basique : les cas limites demandaient une revue manuelle.
  • Les tests d'intégration étaient manuels et chronophages.
  • La documentation arrivait souvent après coup plutôt que pendant le développement.
Trade-offs & Arbitrages Techniques

Dette technique assumée sur la déduplication en Phase 2

Déduplication basique pour tenir la deadline des 6 partenaires ; refonte propre planifiée pour 2024.

Refus de contourner la couche de routage marketing

Traçabilité et workflow commercial préservés, plutôt que gagner 200 ms.

Endpoints dédiés par partenaire

Plus de code, mais chaque intégration reste isolée et facile à debugger.

Pas de retry asynchrone en Phase 1

Synchrone au début pour un monitoring simple ; retry ajouté en Phase 4.

Leçons Apprises
  • En lead management, la vitesse compte autant que la précision : les leads refroidissent vite.
  • Une couche gateway (type APIM) est indispensable face à plusieurs partenaires externes.
  • La validation par partenaire avec le métier est non-négociable, même pour des intégrations techniquement identiques.
  • Un bon playbook d'intégration survit au départ de son auteur - c'est l'investissement le plus rentable.

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 & Conception Système

Architecture de bout en bout : gateway API, normalisation, enrichissement, routage CRM

Architecture & Conception5/5

Conception d'APIs REST

Conception des endpoints REST partenaires, contrats de données et 5 versions d'API

Sécurité4/5

Sécurité applicative web (OWASP)

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

DevOps & Cloud3/5

Monitoring & Supervision

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

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