---
title: "Plateforme API de réception de leads partenaires (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-04-24T08:28:22.478Z"
---

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

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

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

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

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.

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

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

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

### 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_

- **Architecture & Conception Système** - Architecture de bout en bout : gateway API, normalisation, enrichissement, routage CRM
- **REST API Design** - Conception des endpoints REST partenaires, contrats de données et 5 versions d'API
- **Gestion des Parties Prenantes** - Point de contact technique unique pour des dizaines de partenaires externes et équipes internes
- **Gestion de Projet** - Project Manager / Product Owner de la plateforme de 2021 à 2023
- **Communication & Collaboration** - Cycle d'intégration API avec les partenaires externes : specs, tests, validation, go-live
- **Web Application Security (OWASP)** - Isolation des credentials via APIM, conformité RGPD et audit de sécurité 2023
- **Résolution de Problèmes & Pensée Critique** - Diagnostic d'anomalies inter-systèmes et migrations complexes de configurations partenaires
- **Monitoring & Supervision** - Dashboards SOFT Monitor, alertes email temps réel, observabilité par partenaire
- **Adaptabilité & Agilité d'Apprentissage** - Maîtrise de Microsoft APIM et du domaine lead management immobilier

## 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**