Configurer les webhooks Immoteur

Configurez un service webhook lorsque votre intégration a besoin de recevoir des annonces sans polling de l’API. Immoteur envoie une requête JSON POST vers l’URL configurée dans votre dashboard.

​

Choisissez les mises à jour à recevoir

Immoteur envoie une notification d’annonce lorsqu’une annonce est créée ou lorsqu’un champ normalisé éligible change. Un revisit ne modifiant que meta.lastSeenAt est capturé pour la réconciliation par export delta et ne crée pas de notification directe. Utilisez meta.lastModifiedAt pour identifier la dernière mise à jour normalisée et meta.lastSeenAt pour identifier le dernier revisit. Il n’existe pas de webhook keep-alive périodique.

​

Configurez le service et son endpoint

Dans le dashboard Immoteur, ouvrez API → Webhooks (ou la page API → Webhooks et créez un service. Chaque service possède exactement un type de payload : classified pour les événements live d’annonce, ou classifieds pour les exports. Utilisez un endpoint HTTPS contrôlé par votre service.

​

Filtrez le flux

Les événements reçus par un service dépendent de son filtre. Choisissez un type de filtre, puis fournissez la forme demandée par ce type. Pour une couverture globale sans filtre supplémentaire, conservez toutes les clés obligatoires, renseignez transactionType avec une valeur non nulle, puis laissez nulles les valeurs pour lesquelles le schéma l’autorise : propertyTypes, publisherType et sourceDomains.

​

Choisissez le type de payload

Pour les exports classifieds, exportType est obligatoire et indique le type effectivement livré pour l’ensemble de l’export : full pour un Export complet ou delta pour un Export delta. Le champ est présent dans chaque chunk de données et dans le message final. Lorsqu’un Export delta demandé bascule vers un Export complet, l’export effectivement livré est un Export complet avec exportType: "full" ; les payloads envoyés au receiver n’exposent ni le mode demandé ni la raison du repli. Un export peut contenir plusieurs livraisons. Ne supposez ni un nombre fixe d’éléments ni un ordre de livraison. Pour associer événements live, baseline et réconciliation delta, créez deux services compatibles : un service classified et un service d’export classifieds distinct. Ils peuvent cibler le même receiver, mais ne constituent pas le même service. Pour le service live classified, configurez onlyNew=false. Consultez Synchroniser les annonces pour le flux complet, puis Livraison, tentatives et idempotence des webhooks avant d’implémenter votre receiver.