Funciones de inteligencia artificial

WP-ImmoMakler puede generar automáticamente contenido optimizado para motores de búsqueda basándose en los datos y descripciones de inmuebles existentes. La función se configura en el backend de su sitio web (wp-admin) bajo WP-ImmoMakler → Integraciones → Funciones IA. Desde WordPress 7.0, la conexión de IA se gestiona de forma centralizada a través de los Conectores de WordPress. PLUS

Conectar un proveedor de IA

WP-ImmoMakler utiliza el WordPress AI Client — una interfaz estandarizada a través de la cual se pueden conectar varios proveedores de IA sin comprometerse con un servicio específico.

Proveedores compatibles

De forma predeterminada, los siguientes proveedores están disponibles en el núcleo de WordPress:

• Anthropic Claude
• Google Gemini
• OpenAI ChatGPT

Usted puede configurar uno o varios proveedores simultáneamente. WP-ImmoMakler selecciona automáticamente un modelo adecuado de entre los proveedores configurados.

Introducir claves de API

Navegue en el backend de su sitio web (wp-admin) a Ajustes → Conectores e introduzca la clave de API del proveedor deseado. Las credenciales se almacenan de forma centralizada en WordPress y están disponibles para todos los plugins que admitan el WordPress AI Client.

Encontrará una guía detallada paso a paso — cómo crear un conector y generar una clave de API para Anthropic Claude, Google Gemini y OpenAI ChatGPT — en Configurar conectores de IA.

Versiones de WordPress y conexión de IA

Antes de WordPress 7.0, WP-ImmoMakler incluía el WP AI Client como biblioteca integrada en el plugin, y las claves de API se almacenaban en las opciones propias del plugin. Con WordPress 7.0, el AI Client y los nuevos Conectores forman parte del núcleo de WordPress. La gestión de las credenciales de IA se realiza desde entonces de forma centralizada en Ajustes → Conectores.

Al actualizar a WordPress 7.0: volver a introducir las claves de API

WordPress 7.0 no transfiere las claves de API de las ubicaciones de almacenamiento anteriores de WordPress 6.8 y 6.9. Tras la actualización a WordPress 7.0, aparecerá por tanto en la página de Integraciones un aviso amarillo y cerrrable «Funciones IA activadas, pero ningún proveedor de IA conectado», y el elemento de menú de WP-ImmoMakler mostrará un punto de estado rojo — aunque la IA en WP-ImmoMakler funcionara anteriormente.

Introduzca su clave de API una vez más en Ajustes → Conectores. A continuación, las funciones de IA en WP-ImmoMakler funcionarán sin necesidad de más ajustes.

Ajustes en WP-ImmoMakler

Los textos que se generan automáticamente y cómo se formulan los prompts se configuran en el backend de su sitio web (wp-admin) bajo WP-ImmoMakler → Integraciones → Funciones IA.

Activar el uso de inteligencia artificial

Interruptor principal global para todas las funciones de IA. Mientras este interruptor esté desactivado, no se generarán ni textos SEO ni extractos, aunque las funciones individuales de abajo estén activadas.

Cuando el interruptor está activo, WP-ImmoMakler comprueba si hay un proveedor de IA con credenciales conectado en Ajustes → Conectores. Si falta la conexión, aparecen dos avisos:

• un punto de estado rojo en el elemento de menú WP-ImmoMakler de la navegación lateral del administrador,
• un banner de aviso amarillo y cerrable con el título «Funciones IA activadas, pero ningún proveedor de IA conectado» por encima de los ajustes de Integraciones.

Ambos enlazan directamente a la página de Conectores para que pueda configurar la conexión rápidamente.

Nota

El uso de la inteligencia artificial puede producir resultados imprevisibles. Recomendamos revisar ocasionalmente los textos generados de forma aleatoria.

Título SEO

El título SEO se muestra como etiqueta <title> en el encabezado HTML y aparece como primer texto en los resultados de búsqueda. También sirve como valor og:title para las vistas previas en redes sociales, siempre que esté instalado un plugin SEO compatible (p. ej., Yoast SEO o Rank Math).

Las siguientes opciones están disponibles:

• Generar título SEO — Activa la generación. Cuando está activa, el título SEO se genera por IA a partir de los datos del inmueble y las descripciones.
• Título SEO: Prompt — El texto de instrucciones para la IA. El prompt puede formularse en cualquier idioma; los textos generados aparecerán en el idioma del inmueble correspondiente independientemente.
• Título SEO: incluir información de precio — Cuando está activado, se incluye información de precio en el prompt. Predeterminado: desactivado. Tenga en cuenta que la información de precio puede aparecer en los resultados de búsqueda de Google y permanecer allí durante un período prolongado incluso después de modificar o eliminar el inmueble.
• Título SEO: núm. máx. de caracteres — Longitud máxima del título generado. Predeterminado: 60 caracteres; se permiten entre 10 y 500.

Descripción SEO

La descripción SEO se muestra como <meta name="description"> en el encabezado HTML. Aparece en los resultados de búsqueda de Google debajo del título e influye decisivamente en la tasa de clics. Los plugins SEO compatibles adoptan automáticamente la descripción generada.

Mientras la IA todavía no haya respondido, se entrega el texto que WP-ImmoMakler generó a partir de sus plantillas durante la importación; la versión de la IA lo sustituye a continuación. Si las funciones de IA están desactivadas, se mantienen los textos de las plantillas — véase Título SEO y descripción SEO.

En el caso de los inmuebles de referencia – inmuebles ya vendidos o alquilados –, la IA recibe además la indicación de que el inmueble ya no está disponible. En ese caso, deja de ofrecerlo y se dirige en su lugar a propietarios dispuestos a vender. Esta indicación se añade a cada prompt y no se puede sobrescribir.

Las siguientes opciones están disponibles:

• Generar descripción SEO — Activa la generación.
• Descripción SEO: Prompt — El texto de instrucciones para la IA. El idioma del prompt puede elegirse libremente.
• Descripción SEO: incluir información de precio — Predeterminado: desactivado.
• Descripción SEO: núm. máx. de caracteres — Predeterminado: 160 caracteres; se permiten entre 10 y 500.

Extracto

El extracto es un resumen compacto de las características más importantes del inmueble. Se almacena en el campo estándar de WordPress post_excerpt y puede utilizarse en los siguientes lugares:

• Página de detalle (vista individual) — como párrafo de introducción destacado debajo del subtítulo (activo por defecto, véase Visualización en la página de detalle)
• Datos estructurados (JSON-LD) — como disambiguatingDescription del inmueble, independiente de la descripción SEO
• Plantillas personalizadas mediante las funciones de WordPress get_the_excerpt() y the_excerpt()
• Page builders como Elementor, Divi o Beaver Builder
• Páginas de resultados de búsqueda y vistas de lista como texto teaser
• Endpoints de la REST API

Las siguientes opciones están disponibles:

• Generar extracto — Activa la generación.
• Extracto: Prompt — El texto de instrucciones para la IA.
• Extracto: incluir información de precio — Predeterminado: desactivado.
• Extracto: núm. máx. de caracteres — Predeterminado: 300 caracteres; se permiten entre 10 y 2000.

Visualización en la página de detalle

Con independencia de si el texto se ha introducido manualmente o se ha generado mediante IA, WP-ImmoMakler muestra el extracto en la página de detalle del inmueble de forma predeterminada como resumen destacado directamente bajo el subtítulo (clase CSS immomakler-property-excerpt). Si no hay ningún extracto almacenado para un inmueble, el párrafo no se muestra.

La visualización puede controlarse en dos lugares:

• Personalizador: en el backend de su sitio web (wp-admin) bajo WP-ImmoMakler → Personalizador → Vista de detalle de inmuebles → Mostrar resumen — activa o desactiva el párrafo para la vista de detalle estándar.
• Page Builder: Los elementos de constructor «Vista de detalle (completa)» para Elementor, WPBakery, Divi, Bricks y Oxygen, así como el bloque de Gutenberg «Vista detallada del inmueble», disponen cada uno de una opción propia Mostrar resumen, con la que puede anular la salida por plantilla.

Además, el extracto se muestra en los datos estructurados (JSON-LD) del inmueble como disambiguatingDescription — independiente de la description (descripción SEO). Esto proporciona a los motores de búsqueda y a los sistemas de respuesta IA (AEO/GEO) un resumen compacto e independiente del inmueble. Para más detalles sobre la salida Schema.org, consulte Datos estructurados Schema.org.

Restablecer prompts predeterminados

Justo encima del botón Guardar se encuentra el campo de selección Restablecer prompts predeterminados. Si selecciona aquí un idioma (alemán, inglés, español o francés), los tres campos de prompt (Título SEO, Descripción SEO, Extracto) se restablecerán inmediatamente a los prompts predeterminados incluidos en el idioma elegido. A continuación, la selección vuelve a «— Por favor, seleccione —».

Las personalizaciones propias se sobrescribirán. Guarde las personalizaciones importantes antes o utilice la función de forma deliberada para empezar de nuevo con una plantilla limpia.

Los prompts predeterminados incluidos están redactados en estilo informal, como es habitual en los prompts para modelos de lenguaje. El idioma seleccionado aquí no influye en el idioma de los textos generados por la IA — este se determina automáticamente a partir de las características del inmueble correspondiente.

Cuándo se generan los textos

Los textos de IA no se generan durante la importación, sino poco después, en segundo plano. En cuanto un inmueble se ha importado y publicado, WP-ImmoMakler anota cuáles de los tres textos faltan todavía, y un proceso en segundo plano va vaciando esa cola. De este modo la importación ya no espera al proveedor de IA y se completa con rapidez incluso cuando este responde con lentitud o no está accesible en ese momento.

Hasta que los textos de IA estén disponibles, el inmueble no se queda sin texto: durante la importación WP-ImmoMakler genera primero el título SEO, la descripción SEO y el extracto a partir de los propios datos del inmueble — es decir, del tipo de inmueble, la ubicación, la superficie y el número de habitaciones. Estos textos predeterminados se sustituyen en cuanto la IA ha respondido.

Desarrollo temporal

El proceso en segundo plano se ejecuta cada cinco minutos y atiende hasta cinco inmuebles por pasada. Dado que por inmueble se generan hasta tres textos, se trata como máximo de 15 solicitudes a su proveedor de IA por pasada. Tras una sincronización completa con varios cientos de inmuebles pasa, por tanto, algún tiempo hasta que todos los textos están disponibles — la cola se conserva y se procesa paso a paso.

El proceso en segundo plano es un evento cron de WordPress y necesita por ello — igual que la importación automática — que su sitio web se visite con regularidad. En sitios web con poco tráfico de visitantes lo mejor es configurar un cronjob real; cómo hacerlo se explica en Importación automática mediante cronjob.

Regenerar los textos de IA de inmuebles existentes

Un inmueble entra en la cola por sí solo únicamente durante la importación. Para los inmuebles que ya están en WordPress existen tres desencadenantes:

• Un inmueble concreto — en el backend de su sitio web (wp-admin), en WP-ImmoMakler → Inmuebles, la fila del inmueble ofrece la acción Regenerar textos de IA.
• Una selección — marque varios inmuebles y elija Regenerar textos de IA en Acciones en lote, encima de la lista.
• Todos los inmuebles — en la pestaña Funciones de IA, debajo de los ajustes de prompts, encontrará el botón Regenerar los textos de IA de todos los inmuebles.

Ninguno de estos clics genera texto por sí mismo: únicamente coloca el inmueble en la cola que el proceso en segundo plano irá vaciando. Por eso un clic nunca puede quedarse bloqueado esperando al proveedor de IA, y usted puede seguir trabajando de inmediato.

La totalidad de la cartera también se planifica de forma escalonada — 50 inmuebles por pasada del proceso en segundo plano, para que ni siquiera un sitio web con varios miles de inmuebles se quede bloqueado en una sola solicitud. Mientras la pasada está en curso, la pestaña muestra un aviso de que ya hay una pasada en marcha junto con el botón Cancelar la pasada en lugar del botón de inicio. Cancelar solo detiene la planificación adicional; los inmuebles ya planificados conservan su lugar en la cola. La pestaña también indica cuántos inmuebles están esperando en ese momento.

Las tres acciones solo aparecen cuando al menos uno de los tres textos está activado y su cuenta de usuario tiene permiso para gestionar inmuebles (capacidad manage_immomakler_properties).

Ocasiones típicas: ha modificado un prompt más arriba y quiere aplicarlo a la cartera existente, o ha activado las funciones de IA cuando los inmuebles llevaban ya tiempo en WordPress.

Cuando el proveedor de IA no responde

• Límite de solicitudes alcanzado (límite de frecuencia o cuota agotada): WP-ImmoMakler pausa entonces todas las solicitudes de IA. Si el proveedor indica un tiempo de espera, se adopta ese tiempo; de lo contrario la pausa es de cinco minutos, y nunca se pausa más de una hora. Después la cola continúa. Esto no cuenta como intento fallido para el inmueble.
• Ningún proveedor de IA conectado: La cola se mantiene y se vuelve a comprobar una hora más tarde. En cuanto haya introducido una clave de API en Ajustes → Conectores, los textos se recuperan.
• Fallo puntual en un inmueble: Solo ese inmueble se pospone y se reintenta con intervalos crecientes. Tras cinco intentos infructuosos WP-ImmoMakler lo retira de la cola; en la siguiente importación de ese inmueble el proceso comienza de nuevo.

Lo que hace el proceso en segundo plano queda registrado por WP-ImmoMakler en un archivo de registro immomakler-ai-… en el directorio de importación — separado del registro de importación, para que los tiempos de espera del proveedor y los reintentos no lo saturen.

Repercusión en el expose PDF PLUS

El expose PDF incorpora el título SEO y la descripción SEO en sus propiedades de documento. Por eso un PDF precargado en el momento de la publicación contiene al principio los textos predeterminados. WP-ImmoMakler lo descarta en cuanto se han escrito los textos de IA de un inmueble y lo genera de nuevo.

Consejo profesional

El proceso puede ajustarse mediante código:

// Con qué frecuencia se ejecuta el proceso en segundo plano, en segundos (predeterminado: 300, mínimo: 60).
add_filter( 'immomakler_ai_worker_interval', fn (): int => 900 );

// Cuántos inmuebles procesa una pasada (predeterminado: 5).
// Redúzcalo si la cuota del proveedor es ajustada.
add_filter( 'immomakler_ai_worker_batch_size', fn (): int => 2 );

// Qué textos entran en la cola para un inmueble.
// Un array vacío omite el inmueble por completo - aquí: inmuebles de referencia.
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
);

// Se ejecuta en cuanto se han escrito los textos de IA de un inmueble.
add_action( 'immomakler_ai_texts_generated', function ( int $post_id ): void {
  // p. ej. vaciar una caché externa para este inmueble.
} );

Preguntas frecuentes

¿Se regeneran los textos existentes tras un cambio de prompt? No. Un prompt modificado se aplica a todos los textos que se generen a partir de ese momento; los textos ya existentes se mantienen. Un inmueble entra en la cola cuando se importa por primera vez o se actualiza mediante una importación de actualización — por tanto, un cambio en el prompt solo tendrá efecto en la próxima importación de un inmueble.

Para que los textos se regeneren para todos los inmuebles existentes, utilice el botón Regenerar los textos de IA de todos los inmuebles en la pestaña Funciones de IA — véase Regenerar los textos de IA de inmuebles existentes. Una sincronización completa en su software de agencia da el mismo resultado, pero retransmite además todos los datos de los inmuebles.

¿Por qué un inmueble recién importado muestra al principio otro texto? Porque los textos de IA se generan en segundo plano poco después de la importación. Hasta entonces el inmueble muestra los textos predeterminados que WP-ImmoMakler compone a partir de los propios datos del inmueble. Más detalles en Cuándo se generan los textos.

¿Qué datos utiliza la IA? El sistema evalúa todos los datos del inmueble introducidos — ubicación, tipo, superficie, número de habitaciones, equipamiento — así como las descripciones introducidas manualmente. La información de precio solo se incluye cuando la opción correspondiente está explícitamente activada para el título SEO, la descripción SEO o el extracto. Cuanto más completos sean los datos, mejores serán los textos generados.

¿Son necesarios conocimientos de SEO? No. La IA se encarga de la optimización automáticamente. No obstante, se recomienda revisar ocasionalmente los textos generados y adaptarlos al lenguaje corporativo propio.

¿En qué idioma se suministra el prompt? De forma predeterminada en alemán. Mediante el campo de selección Restablecer prompts predeterminados al final de la pestaña puede cambiar en cualquier momento a inglés, español o francés y cargar la plantilla correspondiente en los tres campos de prompt. El prompt cargado puede personalizarse libremente a continuación. El idioma del prompt no influye en el idioma de los textos generados — este se determina automáticamente por inmueble.

---

También puede interesarle

• Configurar conectores de IA
• Título SEO y descripción SEO
• Datos estructurados Schema.org
• Indexación en Google
• Integración con Yoast SEO
• Integración con Rank Math