Fonctions IA

WP-ImmoMakler peut générer automatiquement des contenus optimisés pour les moteurs de recherche sur la base des données et descriptions de biens immobiliers existants. La fonction est configurée dans le backend de votre site web (wp-admin) sous WP-ImmoMakler → Intégrations → Fonctions IA. Depuis WordPress 7.0, la connexion IA est gérée de manière centralisée via les Connecteurs WordPress. PLUS

Connecter un fournisseur IA

WP-ImmoMakler utilise le WordPress AI Client — une interface standardisée permettant de connecter différents fournisseurs d’IA sans être lié à un service spécifique.

Fournisseurs pris en charge

Par défaut, les fournisseurs suivants sont disponibles dans le cœur de WordPress :

• Anthropic Claude
• Google Gemini
• OpenAI ChatGPT

Vous pouvez configurer un ou plusieurs fournisseurs simultanément. WP-ImmoMakler sélectionne automatiquement un modèle approprié parmi les fournisseurs configurés.

Saisir les clés API

Naviguez dans le backend de votre site web (wp-admin) vers Réglages → Connecteurs et saisissez la clé API du fournisseur souhaité. Les identifiants sont stockés de manière centralisée dans WordPress et sont disponibles pour tous les plugins prenant en charge le WordPress AI Client.

Vous trouverez un guide détaillé étape par étape — comment créer un connecteur et générer une clé API pour Anthropic Claude, Google Gemini et OpenAI ChatGPT — sous Configurer les connecteurs IA.

Versions de WordPress et connexion IA

Avant WordPress 7.0, WP-ImmoMakler fournissait le WP AI Client en tant que bibliothèque intégrée au plugin, et les clés API étaient stockées dans les options propres au plugin. Avec WordPress 7.0, l’AI Client et les nouveaux Connecteurs font partie du cœur de WordPress. La gestion des identifiants IA s’effectue depuis lors de manière centralisée sous Réglages → Connecteurs.

Lors de la mise à jour vers WordPress 7.0 : saisir à nouveau les clés API

WordPress 7.0 ne reprend pas les clés API des emplacements de stockage précédents de WordPress 6.8 et 6.9. Après la mise à jour vers WordPress 7.0, une notification jaune et fermable « Fonctions IA activées, mais aucun fournisseur IA connecté » apparaîtra sur la page Intégrations, et l’entrée de menu WP-ImmoMakler affichera un point de statut rouge — même si l’IA fonctionnait auparavant dans WP-ImmoMakler.

Saisissez à nouveau votre clé API une seule fois sous Réglages → Connecteurs. Les fonctions IA dans WP-ImmoMakler fonctionneront ensuite sans autre ajustement.

Réglages dans WP-ImmoMakler

Les textes générés automatiquement et la formulation des prompts sont définis dans le backend de votre site web (wp-admin) sous WP-ImmoMakler → Intégrations → Fonctions IA.

Activer l’utilisation de l’intelligence artificielle

Commutateur principal global pour toutes les fonctions IA. Tant que ce commutateur est désactivé, ni les textes SEO ni les extraits ne seront générés — même si les fonctions individuelles ci-dessous sont activées.

Lorsque le commutateur est actif, WP-ImmoMakler vérifie si un fournisseur IA avec des identifiants est connecté sous Réglages → Connecteurs. Si la connexion est absente, deux notifications apparaissent :

• un point de statut rouge sur l’entrée de menu WP-ImmoMakler dans la navigation latérale de l’administration,
• une bannière de notification jaune et fermable intitulée « Fonctions IA activées, mais aucun fournisseur IA connecté » au-dessus des réglages Intégrations.

Les deux renvoient directement à la page Connecteurs afin que vous puissiez rapidement configurer la connexion.

Note

L’utilisation de l’intelligence artificielle peut produire des résultats imprévisibles. Nous recommandons de vérifier occasionnellement les textes générés par sondage.

Titre SEO

Le titre SEO est affiché sous forme de balise <title> dans l’en-tête HTML et apparaît comme premier texte dans les résultats de recherche. Il sert également de valeur og:title pour les aperçus sur les réseaux sociaux, à condition qu’un plugin SEO compatible (p. ex. Yoast SEO ou Rank Math) soit installé.

Les options suivantes sont disponibles :

• Générer le titre SEO — Active la génération. Lorsqu’elle est active, le titre SEO est généré par l’IA à partir des données et descriptions du bien immobilier.
• Titre SEO : Prompt — Le texte d’instruction pour l’IA. Le prompt peut être formulé dans n’importe quelle langue ; les textes générés apparaîtront dans la langue du bien immobilier concerné.
• Titre SEO : inclure les informations de prix — Lorsqu’elle est activée, les informations de prix sont incluses dans le prompt. Par défaut : désactivé. Notez que les informations de prix peuvent apparaître dans les résultats de recherche Google et y rester pendant une période prolongée même après la modification ou la suppression du bien immobilier.
• Titre SEO : nombre max. de caractères — Longueur maximale du titre généré. Par défaut : 60 caractères, plage autorisée : 10 à 500.

Description SEO

La description SEO est affichée sous forme de <meta name="description"> dans l’en-tête HTML. Elle apparaît dans les résultats de recherche Google sous le titre et influence considérablement le taux de clics. Les plugins SEO compatibles reprennent automatiquement la description générée.

Tant que l’IA n’a pas encore répondu, c’est le texte que WP-ImmoMakler a généré à partir de ses modèles lors de l’import qui est diffusé ; la version IA le remplace ensuite. Si les fonctions IA sont désactivées, les textes issus des modèles restent en place — voir Titre SEO et description SEO.

Pour les biens de référence – des biens immobiliers déjà vendus ou loués –, l’IA reçoit en plus l’indication que le bien n’est plus disponible. Elle ne le propose alors plus et s’adresse à la place aux propriétaires prêts à vendre. Cette indication est ajoutée à chaque prompt et ne peut pas être remplacée.

Les options suivantes sont disponibles :

• Générer la description SEO — Active la génération.
• Description SEO : Prompt — Le texte d’instruction pour l’IA. La langue du prompt est librement choisie.
• Description SEO : inclure les informations de prix — Par défaut : désactivé.
• Description SEO : nombre max. de caractères — Par défaut : 160 caractères, plage autorisée : 10 à 500.

Extrait

L’extrait est un résumé compact des caractéristiques les plus importantes du bien immobilier. Il est enregistré dans le champ standard WordPress post_excerpt et peut être utilisé aux endroits suivants :

• Page de détail (vue individuelle) — comme paragraphe d’introduction mis en évidence sous le sous-titre (actif par défaut, voir Affichage sur la page de détail)
• Données structurées (JSON-LD) — comme disambiguatingDescription du bien immobilier, distinct de la description SEO
• Templates personnalisés via les fonctions WordPress get_the_excerpt() et the_excerpt()
• Page builders tels qu’Elementor, Divi ou Beaver Builder
• Pages de résultats de recherche et vues en liste comme texte teaser
• Endpoints de l’API REST

Les options suivantes sont disponibles :

• Générer l’extrait — Active la génération.
• Extrait : Prompt — Le texte d’instruction pour l’IA.
• Extrait : inclure les informations de prix — Par défaut : désactivé.
• Extrait : nombre max. de caractères — Par défaut : 300 caractères, plage autorisée : 10 à 2 000.

Affichage sur la page de détail

Que le texte soit saisi manuellement ou généré par l’IA, WP-ImmoMakler affiche par défaut l’extrait sur la page de détail du bien immobilier comme résumé mis en évidence directement sous le sous-titre (classe CSS immomakler-property-excerpt). Si aucun extrait n’est enregistré pour un bien immobilier, le paragraphe n’est pas affiché.

L’affichage peut être contrôlé à deux endroits :

• Personnaliseur : dans le backend de votre site web (wp-admin) sous WP-ImmoMakler → Personnaliseur → Vue de détail des biens → Afficher le résumé — active ou désactive le paragraphe pour la vue de détail standard.
• Page Builder : Les éléments de constructeur « Vue de détail (complète) » pour Elementor, WPBakery, Divi, Bricks et Oxygen, ainsi que le bloc Gutenberg « Vue détaillée du bien immobilier », disposent chacun d’une option Afficher le résumé, vous permettant de remplacer l’affichage par template.

De plus, l’extrait est affiché dans les données structurées (JSON-LD) du bien immobilier comme disambiguatingDescription — distinct de la description (description SEO). Les moteurs de recherche et les systèmes de réponse IA (AEO/GEO) obtiennent ainsi un résumé compact et autonome du bien. Pour plus de détails sur l’affichage Schema.org, consultez Données structurées Schema.org.

Réinitialiser les prompts par défaut

Juste au-dessus du bouton Enregistrer se trouve le menu déroulant Réinitialiser les prompts par défaut. En sélectionnant une langue ici (allemand, anglais, espagnol ou français), les trois champs de prompt (Titre SEO, Description SEO, Extrait) sont immédiatement réinitialisés aux prompts par défaut fournis dans la langue choisie. La sélection revient ensuite à « — Veuillez sélectionner — ».

Toute personnalisation sera écrasée. Sauvegardez les personnalisations importantes au préalable ou utilisez cette fonction délibérément pour repartir d’un modèle propre.

Les prompts par défaut fournis sont rédigés dans un style informel, comme il est d’usage pour les prompts destinés aux modèles de langage. La langue sélectionnée ici n’a aucune influence sur la langue des textes générés par l’IA — celle-ci est déterminée automatiquement à partir des caractéristiques du bien immobilier concerné.

Quand les textes sont créés

Les textes IA ne sont pas créés pendant l’importation, mais peu après, en arrière-plan. Dès qu’un bien immobilier est importé et publié, WP-ImmoMakler retient lesquels des trois textes manquent encore, et un processus d’arrière-plan traite cette file d’attente. L’importation n’attend donc plus le fournisseur IA et se déroule rapidement même lorsque celui-ci répond lentement ou n’est momentanément pas joignable.

Tant que les textes IA ne sont pas disponibles, le bien immobilier n’est pas dépourvu de texte : lors de l’importation, WP-ImmoMakler génère d’abord le titre SEO, la description SEO et l’extrait à partir des données du bien elles-mêmes — c’est-à-dire du type de bien, de la localisation, de la surface et du nombre de pièces. Ces textes par défaut sont remplacés dès que l’IA a répondu.

Déroulement dans le temps

Le processus d’arrière-plan s’exécute toutes les cinq minutes et prend en charge jusqu’à cinq biens immobiliers par passage. Comme jusqu’à trois textes sont générés par bien, cela représente au maximum 15 requêtes à votre fournisseur IA par passage. Après une synchronisation complète portant sur plusieurs centaines de biens, il faut donc un certain temps avant que tous les textes soient disponibles — la file d’attente est conservée et traitée étape par étape.

Le processus d’arrière-plan est un événement cron de WordPress et nécessite donc — comme l’importation automatique — que votre site web soit appelé régulièrement. Sur les sites web à faible trafic, le mieux est de mettre en place une véritable tâche cron ; la marche à suivre est décrite sous Importation automatique par tâche cron.

Régénérer les textes IA de biens immobiliers existants

Un bien immobilier n’entre de lui-même dans la file d’attente que lors de l’importation. Pour les biens déjà présents dans WordPress, il existe trois déclencheurs :

• Un bien immobilier isolé — dans l’administration de votre site web (wp-admin), sous WP-ImmoMakler → Biens immobiliers, la ligne du bien propose l’action Régénérer les textes IA.
• Une sélection — cochez plusieurs biens immobiliers et choisissez Régénérer les textes IA dans les Actions groupées, au-dessus de la liste.
• Tous les biens immobiliers — dans l’onglet Fonctions IA, sous les réglages de prompts, se trouve le bouton Régénérer les textes IA de tous les biens immobiliers.

Aucun de ces clics ne génère lui-même du texte : il place simplement le bien dans la file d’attente que le processus d’arrière-plan traite ensuite. Un clic ne peut donc jamais rester bloqué sur le fournisseur IA, et vous pouvez continuer à travailler immédiatement.

L’ensemble du portefeuille est lui aussi mis en file progressivement — 50 biens immobiliers par passage du processus d’arrière-plan, afin que même un site web comptant plusieurs milliers de biens ne reste pas bloqué sur une seule requête. Tant que le passage est en cours, l’onglet affiche, à la place du bouton de démarrage, une indication qu’un passage est déjà en cours ainsi que le bouton Interrompre le passage. Une interruption ne stoppe que la mise en file ultérieure ; les biens déjà mis en file conservent leur place dans la file d’attente. L’onglet indique également combien de biens immobiliers sont actuellement en attente.

Les trois actions n’apparaissent que si au moins l’un des trois textes est activé et si votre compte utilisateur est autorisé à gérer les biens immobiliers (capacité manage_immomakler_properties).

Occasions typiques : vous avez modifié un prompt plus haut et souhaitez l’appliquer au portefeuille existant, ou vous n’avez activé les fonctions IA qu’une fois les biens immobiliers depuis longtemps présents dans WordPress.

Lorsque le fournisseur IA ne répond pas

• Limite de requêtes atteinte (limite de débit ou quota épuisé) : WP-ImmoMakler met alors en pause toutes les requêtes IA. Si le fournisseur indique un délai d’attente, ce délai est repris, sinon la pause est de cinq minutes ; la pause n’excède jamais une heure. Ensuite, la file d’attente reprend. Cela ne compte pas comme une tentative échouée pour le bien immobilier.
• Aucun fournisseur IA connecté : La file d’attente est conservée et réexaminée une heure plus tard. Dès que vous avez saisi une clé API sous Réglages → Connecteurs, les textes sont rattrapés.
• Échec isolé sur un bien immobilier : Seul ce bien est différé et retenté à intervalles croissants. Après cinq tentatives infructueuses, WP-ImmoMakler le retire de la file d’attente ; à la prochaine importation de ce bien, le processus repart du début.

WP-ImmoMakler consigne ce que fait le processus d’arrière-plan dans un fichier journal immomakler-ai-… situé dans le répertoire d’importation — séparé du journal d’importation, afin que les délais d’attente du fournisseur et les nouvelles tentatives ne le noient pas.

Incidence sur l’exposé PDF PLUS

L’exposé PDF reprend le titre SEO et la description SEO dans ses propriétés de document. Un PDF préchargé au moment de la publication contient donc d’abord les textes par défaut. WP-ImmoMakler l’écarte dès que les textes IA d’un bien immobilier ont été écrits et le génère à nouveau.

Astuce de pro

Le déroulement peut être adapté par code :

// À quelle fréquence le processus d'arrière-plan s'exécute, en secondes (par défaut : 300, minimum : 60).
add_filter( 'immomakler_ai_worker_interval', fn (): int => 900 );

// Combien de biens immobiliers un passage traite (par défaut : 5).
// À réduire lorsque le quota du fournisseur est serré.
add_filter( 'immomakler_ai_worker_batch_size', fn (): int => 2 );

// Quels textes entrent dans la file d'attente pour un bien immobilier.
// Un tableau vide ignore entièrement le bien - ici : les biens de référence.
add_filter(
  'immomakler_ai_queued_fields',
  function ( array $fields, int $post_id ): array {
    return \ImmoMakler\Data\Property_Helper::is_reference( $post_id ) ? [] : $fields;
  },
  10,
  2
);

// S'exécute dès que les textes IA d'un bien immobilier ont été écrits.
add_action( 'immomakler_ai_texts_generated', function ( int $post_id ): void {
  // p. ex. vider un cache externe pour ce bien immobilier.
} );

Questions fréquentes

Les textes existants sont-ils régénérés après une modification de prompt ? Non. Un prompt modifié s’applique à tous les textes générés par la suite ; les textes déjà présents restent inchangés. Un bien immobilier entre dans la file d’attente lorsqu’il est nouvellement importé ou mis à jour via une importation de mise à jour — une modification du prompt ne prend donc effet qu’à la prochaine importation d’un bien immobilier.

Pour faire régénérer les textes de tous les biens immobiliers existants, utilisez le bouton Régénérer les textes IA de tous les biens immobiliers dans l’onglet Fonctions IA — voir Régénérer les textes IA de biens immobiliers existants. Une synchronisation complète dans votre logiciel d’agence aboutit au même résultat, mais retransmet au passage toutes les données des biens immobiliers.

Pourquoi un bien immobilier fraîchement importé affiche-t-il d’abord un autre texte ? Parce que les textes IA ne sont créés en arrière-plan que peu après l’importation. Jusque-là, le bien affiche les textes par défaut que WP-ImmoMakler compose à partir des données du bien elles-mêmes. Voir Quand les textes sont créés.

Quelles données l’IA utilise-t-elle ? Le système évalue toutes les données du bien immobilier saisies — localisation, type, surface, nombre de pièces, équipements — ainsi que les descriptions saisies manuellement. Les informations de prix ne sont incluses que lorsque l’option correspondante est explicitement activée pour le titre SEO, la description SEO ou l’extrait. Plus les données sont complètes, meilleurs sont les textes générés.

Des connaissances en SEO sont-elles nécessaires ? Non. L’IA prend en charge l’optimisation automatiquement. Il est néanmoins conseillé de vérifier occasionnellement les textes générés et de les adapter au langage propre à votre entreprise.

Dans quelle langue le prompt est-il fourni ? Par défaut en allemand. Le menu déroulant Réinitialiser les prompts par défaut en bas de l’onglet vous permet de passer à tout moment à l’anglais, l’espagnol ou le français et de charger le modèle correspondant dans les trois champs de prompt. Le prompt chargé peut ensuite être librement personnalisé. La langue du prompt n’influence pas la langue des textes générés — celle-ci est déterminée automatiquement par bien immobilier.

---

Cela pourrait aussi vous intéresser

• Configurer les connecteurs IA
• Titre SEO et description SEO
• Données structurées Schema.org
• Indexation Google
• Intégration Yoast SEO
• Intégration Rank Math