> ## Documentation Index
> Fetch the complete documentation index at: https://docs.immoteur.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurer les webhooks Immoteur

> Configurez un webhook Immoteur et choisissez les mises à jour de données reçues par votre service

Configurez un webhook lorsque votre service a besoin de mises à jour d’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 l’endpoint

Créez un webhook depuis **Service → Webhooks** dans le dashboard Immoteur. Utilisez un endpoint HTTPS contrôlé par votre service.

<Warning>
  Si votre endpoint limite les adresses IP sources, autorisez avant tout test
  les IP d’egress Immoteur suivantes :{" "}

  `51.38.208.80` et `54.37.96.165`{/* immoteur-parameter:end */}.
</Warning>

<img src="https://mintcdn.com/scrapimmo/0PVu746hR8-0GvuV/images/webhook/create-webhook.png?fit=max&auto=format&n=0PVu746hR8-0GvuV&q=85&s=36a0f3cca7a5117a890cbbc69fba3b0f" alt="Formulaire de création de webhook" width="584" height="693" data-path="images/webhook/create-webhook.png" />

## Filtrez le flux

Les événements reçus par votre service dépendent des filtres configurés sur l’exporter. Choisissez un type de filtre, puis limitez le payload au marché traité par votre intégration.

<Tabs>
  <Tab title="Professionnel">
    <ul>
      <li>
        Type de transaction <strong>(Requis)</strong>
      </li>

      <li>Source de domaine</li>
      <li>Type de bien</li>

      <li>
        SIREN / SIRET <strong>(Requis)</strong>
      </li>
    </ul>
  </Tab>

  <Tab title="Géographique">
    <ul>
      <li>
        Type de transaction <strong>(Requis)</strong>
      </li>

      <li>Type de bien</li>
      <li>Type de vendeur</li>

      <li>
        Département <strong>(Requis)</strong>
      </li>
    </ul>
  </Tab>

  <Tab title="Global">
    <ul>
      <li>
        Type de transaction <strong>(Requis)</strong>
      </li>

      <li>Source de domaine</li>
      <li>Type de bien</li>
      <li>Type de vendeur</li>
    </ul>
  </Tab>
</Tabs>

## Choisissez le type de payload

| Type de payload        | Cas d’usage                       | Contrat                                                                                                  |
| ---------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Notification d’annonce | Traiter une mise à jour d’annonce | Le payload est un objet `Classified` de `webhooks.classified-notification` dans la référence API générée |
| Export d’annonces      | Recevoir un export par lots       | Le payload contient `exportId`, `items` et `isComplete` de `webhooks.classifieds-export`                 |

Un export peut contenir plusieurs livraisons. Ne supposez ni un nombre fixe d’éléments ni un ordre de livraison. Consultez [Synchroniser les annonces](./synchroniser-annonces-immobilieres) pour le flux complet, les mises à jour en direct et la réconciliation delta, puis [Livraison, tentatives et idempotence des webhooks](./livraison-webhooks) avant d’implémenter votre service de réception.