Webhook, liens et redirection

PLUS

Un front end généré de façon statique doit savoir quand vos biens ont changé afin de reconstruire les pages concernées. Pour cela, WP-ImmoMakler appelle une adresse de votre front end après chaque transfert depuis votre logiciel CRM : le webhook. Les deux autres options de cette page veillent à ce que les liens et les visiteurs qui arrivent encore sur WordPress atterrissent sur le front end.

Vous trouverez tous les réglages dans le back end de votre site (wp-admin), sous WP-ImmoMakler → Intégrations → Headless.

Webhook

Activez Envoyer le webhook et saisissez sous Adresse du webhook l’adresse que votre front end met à disposition pour les notifications, par exemple https://www.votre-domaine.fr/api/revalidate/. Saisissez l’adresse exactement comme votre front end y répond, avec une barre oblique finale pour le starter Astro : si le front end redirige, par exemple d’une adresse sans barre oblique finale vers une adresse avec, WP-ImmoMakler ne suit pas la redirection et consigne dans le log « Headless webhook refused by the front end » avec le statut de la redirection, par exemple 308. WP-ImmoMakler collecte les modifications et les envoie regroupées : après un import qui crée, modifie ou supprime de nombreux biens, un seul message part dès que les secondes réglées sous “Wartezeit” (libellé en allemand, pas encore traduit) se sont écoulées sans nouvelle modification (par défaut : 60). Un bien publié ou supprimé manuellement est signalé de la même façon.

Le message est un POST avec un document JSON :

{
  "event": "properties.changed",
  "api_version": 1,
  "site": "https://wordpress.votre-domaine.fr/",
  "api_base": "https://wordpress.votre-domaine.fr/wp-json/immomakler-headless/v1",
  "sent_at": "2026-10-12T18:30:00+00:00",
  "delivery_id": "6f1c…",
  "import_counts": { "files_imported": 1, "created": 2, "updated": 14, "deleted": 1 },
  "created": [ { "objektnr_extern": "WP1240", "post_id": 4711, "title": "…", "frontend_url": "https://www.votre-domaine.fr/biens/…/" } ],
  "updated": [ … ],
  "deleted": [ { "objektnr_extern": "WP1101", "post_id": 0, "title": "…" } ],
  "full_rebuild_hint": false
}

created, updated et deleted désignent les biens concernés par leur numéro d’objet ; un front end reconstruit les pages citées ou déclenche un build complet. full_rebuild_hint vaut true lorsque quelque chose a changé qui ne peut être attribué à un seul bien, par exemple des réglages qui concernent toutes les pages. Un front end devrait y répondre par un build complet.

Vérifier la signature

Chaque message porte les en-têtes X-ImmoMakler-Event, X-ImmoMakler-Delivery (un identifiant unique), X-ImmoMakler-Timestamp (heure Unix de l’envoi) et X-ImmoMakler-Signature. La signature est sha256= suivi du HMAC-SHA256 de horodatage.corps, avec le secret du webhook des réglages comme clé. Votre front end calcule la même valeur sur le corps inchangé et la compare ; si elle diffère ou si l’horodatage date de plus de quelques minutes, il rejette le message.

import { createHmac, timingSafeEqual } from 'node:crypto';

const expected = 'sha256=' + createHmac('sha256', secret).update(`${timestamp}.${rawBody}`).digest('hex');
const valid = timingSafeEqual(Buffer.from(expected), Buffer.from(signatureHeader));

WP-ImmoMakler génère le secret à la première ouverture des réglages ; avec Générer un nouveau secret, vous le remplacez, après quoi le front end doit lui aussi connaître le nouveau secret.

Livraison et nouvelles tentatives

Si votre front end ne répond pas par un statut 2xx, ou ne répond pas du tout, WP-ImmoMakler répète la livraison après 1, 5 et 30 minutes, puis 2 et 6 heures. Ensuite, il abandonne le message et le consigne dans le journal immomakler-headless-*.log du répertoire d’import ; la modification suivante repart de zéro. L’état de la dernière livraison apparaît dans les réglages sous Webhook, et avec Envoyer un message de test, vous envoyez un message avec l’événement ping pour vérifier la connexion.

Liens vers le front end

Avec Réécrire les liens vers le frontend, tous les liens que WordPress construit vers un bien, la liste des biens ou une catégorie pointent vers le front end : dans les e-mails des demandes de contact et des alertes de recherche, dans les flux, dans les menus et dans les liens « Afficher » du back end. L’interface elle-même continue d’indiquer l’adresse WordPress sous wp_url.

Redirection vers le front end

Dès que le front end diffuse les pages des biens, activez Rediriger les visiteurs vers le frontend. Lorsqu’un visiteur ou un moteur de recherche appelle un bien, la liste des biens ou une catégorie sur votre site WordPress, WP-ImmoMakler répond par une redirection permanente (301) vers la page correspondante du front end ; les paramètres de recherche de la liste des biens sont conservés. Ainsi, les adresses référencées dans les moteurs de recherche conservent leur valeur.