Documentation

ImmoWP API & intégrations

Pourquoi une passerelle ? (man-in-the-middle)

ImmoWP se place entre le logiciel immobilier (CRM) et votre site — WordPress, Next.js, ou un site généré avec Claude. Ce n’est pas un luxe technique : c’est ce qui rend le stock d’annonces consommable, stable et maintenable.

Le schéma

CRM (Hektor, Apimo, Ubiflow…)
        │
        ▼
   ImmoWP API  ←  man-in-the-middle
   (sync, mapping, cache, auth)
        │
        ▼
  Site / Claude / Meerweb
  (design, pages, SEO)

Sans passerelle, le site (ou l’IA) doit parler directement le langage du CRM. Avec ImmoWP, le site ne voit qu’une API simple et normalisée.

1. Un contrat unique au lieu de 40 intégrations

Chaque CRM a son auth, son format (API REST, ZIP Poliris, XML…) et ses champs. Brancher un site « en direct » = un connecteur par logiciel, à réécrire à chaque changement éditeur.

La passerelle expose un seul endpoint et un schéma stable (offer_type, financial.sale_price, media.photos…). Changer de CRM côté agence ne casse plus le front.

2. Même avec un seul CRM, le MITM sert encore

Pour une agence mono-logiciel, le gain n’est plus le multi-CRM, c’est l’exploitation :

  • Sync 24/7 — cron, cache, reprise d’erreur (pas une session Claude one-shot)
  • Secrets CRM isolés — le site n’a qu’une clé ImmoWP, pas le login Apimo/Hektor
  • Mapping déjà battu — prix, honoraires, DPE, photos, multi-langues
  • Mise en ligne rapide — Claude construit le site ; le tuyau annonces existe déjà
  • Support / statut — savoir si le flux est actif et à jour (/v1/status)

3. Claude (ou un builder IA) n’est pas un opérateur d’intégration

Un LLM excelle à générer pages, design et UX. Il n’est pas un service qui tire un ZIP Hektor tous les matins, gère les quotas API et corrige un champ DPE après une maj CRM.

Claude = usine à site.
ImmoWP = usine à annonces.

Demander à Claude de « se connecter en direct au CRM » revient à lui confier la maintenance d’un connecteur en production — fragile dès que le chat est terminé.

4. Sécurité

  • Pas de credentials CRM dans le front, le repo public ou le prompt
  • Accès lecture stock via clé dédiée, révocable
  • Possibilité de désactiver une passerelle sans toucher au site

5. Données normalisées = moins de bugs d’affichage

Sans couche intermédiaire, chaque CRM renvoie prix en string, centimes, tableaux multilingues, photos sous des formes différentes. Le MITM livre un JSON homogène pour le listing et la fiche bien.

Voir le modèle de données v1 et la référence API.

6. Quand le direct peut suffire

  • Prototype jetable ou export CSV figé
  • Un seul CRM, un dev qui opère le connecteur au long cours
  • Pas de besoin de sync automatique

Dès qu’il y a un site en production, des mises à jour CRM et peu de suivi technique, la passerelle devient le choix rationnel.

En une phrase

Le man-in-the-middle ImmoWP n’est pas un détour : c’est la prise standard entre le métier immobilier (CRM) et le web (site / IA), pour ne pas reconstruire l’intégration à chaque projet.

Suite