Conectar WordPress

Qué hace

El plugin de WelcomeAI mantiene el contenido de tu WordPress en tus bases de conocimiento. Tú escribes reglas; cada regla dice qué contenido sale del sitio, qué campos viajan con él y en qué base aterriza. Después de la primera sincronización se cuida solo: publicas una entrada y aparece, la editas y el documento se actualiza, la borras y el documento se va.

No instala el widget de chat. Ese es otro trabajo y vive en tu espacio de trabajo: crea allí el widget y pega su script de una línea en tu tema, igual que en cualquier otro sitio.

A qué puede acceder

Solo a lo que piden tus reglas y, por defecto, solo a lo que un visitante ya podía leer.

Una regla cubre un tipo de contenido -- entradas, páginas, un tipo personalizado que registre tu sitio o productos de WooCommerce -- y tú eliges los estados que incluye. Publicado, para empezar. Nunca lee las contraseñas de tu WordPress, y de tu instalación no se guarda nada más que la URL del sitio y el contenido que tus reglas seleccionan.

Qué necesitas antes de empezar

• WordPress 6.2 o posterior, PHP 8.0 o posterior.
• Una cuenta de administrador en el sitio, para instalar un plugin.
• Un espacio de WelcomeAI en cualquier plan, Starter incluido.
• Al menos una base de conocimiento a la que enviar contenido.

Autenticación

Tres valores, todos de WelcomeAI:

El plugin valida la clave junto con el ID de usuario antes de desbloquear nada más, así que un valor incorrecto falla en el paso de conexión y no en silencio más tarde. La clave se guarda cifrada en la tabla de opciones de WordPress; trata el sitio como cualquier otro lugar que contiene una credencial. También puedes ponerla en wp-config.php, donde nunca llega a la base de datos:

define( 'WELCOMEAI_API_KEY', 'wai_live_...' );
define( 'WELCOMEAI_USER_ID', 'tu-id-de-usuario' );

Configurarlo

1. Descarga el plugin desde Integraciones en tu espacio de trabajo.
2. Súbelo y actívalo: Plugins, Añadir nuevo, Subir plugin y elige el zip. Aparece una entrada WelcomeAI en el menú de administración.
3. Pega tu ID de usuario y la clave de API y pulsa Validar. Te dice cuál de los dos está mal si hay alguno.
4. Escribe tu primera regla en Reglas de sincronización: elige un tipo de contenido, la base de conocimiento que alimenta y los campos a incluir. La regla cuenta cuántos elementos coinciden antes de ejecutarla.
5. Pulsa Sincronizar todo en Actividad. Un catálogo de miles sale por lotes en vez de agotar el tiempo.

Escribir reglas

Una regla son cuatro decisiones.

• El tipo de contenido. Uno por regla. Todo lo demás del formulario sale de él, por eso es la primera pregunta.
• Las bases de conocimiento. Elige más de una y el contenido aterriza en cada una, como documento propio. Dos reglas que alimentan la misma base producen un documento con los dos conjuntos de campos.
• Los filtros. Un bloque por cada taxonomía que tenga el tipo. No marques nada y la regla cubre todos los elementos; marca términos y cubre solo esos, o todo excepto esos. Marca "incluir términos hijos" en una taxonomía jerárquica y una categoría padre se lleva a sus hijas.
• Los campos. Lo que se escribe en el documento que lee el asistente.

Algunos ejemplos de lo que eso te da:

• Todas las entradas a una base llamada Entradas, y las de Guías también a una segunda base.
• El tipo personalizado services a una base Servicios, team a una base Equipo.
• Los productos a una base Productos, pero no los etiquetados descatalogado.

Qué se importa

El plugin lee lo que cada tipo de contenido tiene de verdad y te lo lista: los campos básicos (título, contenido, extracto, imagen destacada, URL, autor, fechas, estado, slug, superior, orden), todas las taxonomías registradas para ese tipo, los metadatos que llevan tus entradas, los grupos de campos de ACF, los campos de JetEngine y los campos de producto de WooCommerce.

Dos cosas que conviene saber:

• Todo lo que marcas se escribe en el cuerpo del documento, porque esa es la parte que el asistente puede leer. Un campo vacío en un elemento simplemente no aparece en ese documento.
• Las claves que empiezan por guión bajo están ocultas por defecto. Suelen ser la contabilidad interna de algún plugin -- ACF escribe un _hero_text al lado de cada hero_text -- pero si alguna tuya tiene texto real, activa "Ofrecer campos personalizados protegidos" en Conexión.

Si añades un campo después de instalar un plugin que lo registra, pulsa Volver a leer los campos.

WooCommerce

Una regla cuyo tipo de contenido es Productos ofrece los campos de la tienda: SKU, precio, precio normal y rebajado, stock y estado del stock, atributos, peso y dimensiones, clase de envío, texto alternativo de la galería, nota de compra, tipo de producto, valoración y productos relacionados.

Las variaciones van dentro de su producto. Un documento por producto, con cada variación y su propio SKU, precio y stock, para que "¿tienen la negra en talle M y cuánto cuesta?" se responda desde un solo sitio. Una tienda de 500 productos con seis variaciones cada uno sigue siendo 500 documentos y no 3.500.

El envío no está en ningún producto, así que hay una segunda opción: Enviar también un documento de Información de la tienda. Lleva tus zonas de envío y lo que cuesta cada método, los medios de pago que tienes activos, la moneda, la dirección de la tienda y tus páginas de políticas, y se rehace cuando cambias cualquiera de ellos. Sin él, "¿cuánto cuesta el envío?" no tiene respuesta.

Cómo se gestionan las actualizaciones

Cada documento se identifica por el id de la entrada y la base a la que fue, así que editarla actualiza el mismo documento en vez de crear un segundo. Borrar una entrada -- o despublicarla, o sacarla de una categoría por la que filtra una regla, o editar la regla para que ya no la cubra -- elimina el documento, sus fragmentos y sus embeddings de esa base.

El plugin también se actualiza solo. Consulta tu espacio de trabajo dos veces al día y ofrece la versión nueva en la pantalla de Plugins mientras la suscripción del espacio esté activa. Nunca se actualiza por su cuenta.

Para qué se usa

Responder preguntas de soporte desde una sección de ayuda que ya existe. Hacer buscable la documentación de una forma que tolere las palabras que un cliente usa de verdad. Dejar que el asistente de una tienda responda sobre un producto concreto -- su precio, si hay talle M, cuánto cuesta el envío -- desde el catálogo mismo.

Cómo funciona la sincronización

Después de la primera vez no tienes que programar nada: un cambio llega solo a la base de conocimiento, normalmente en menos de un minuto. Publicar, editar, borrar, mover una entrada de categoría, editar un campo personalizado que una regla usa, cambiar el precio de una variación: todo eso encola el elemento y la cola se vacía en segundo plano, en lotes de 25.

• No se envía nada cuando nada cambió. Pulsar Actualizar en una entrada que no editaste no cuesta ninguna petición.
• La cola va a su ritmo. Cada plan tiene un cupo diario de API, y un lote de 25 elementos es una petición. Si una primera sincronización grande lo agota, el plugin se pausa y te dice cuándo sigue.
• En una tienda WooCommerce usa Action Scheduler, que WooCommerce ya instala. En el resto usa WP-Cron.
• En un sitio grande, usa WP-CLI: wp welcomeai sync termina el trabajo sin dejar una pestaña abierta. wp welcomeai status dice cómo va todo y wp welcomeai reconcile compara las bases de conocimiento con el sitio.

Qué se elimina, y cuándo

Un documento sale de su base de conocimiento cuando el elemento que hay detrás ya no le corresponde:

• la entrada se borra, va a la papelera o se despublica;
• pierde la categoría por la que filtra la regla;
• editas la regla para que ya no la cubra, o borras la regla;
• pulsas Eliminar en la pestaña Contenido.

Nunca se duplica nada. Cada documento guarda una referencia al elemento del que salió, así que una edición actualiza ese documento en vez de crear un segundo, y repetir una sincronización reconoce lo que ya está.

Buscar huérfanos, en la pestaña Actividad, lee lo que tiene cada base de conocimiento y lo compara con tu sitio: lo que el sitio no puede justificar se elimina, y lo que falta se envía. Ejecútalo si borraron documentos desde la app, o si el sitio estuvo desconectado mientras cambiaba el contenido.

Cómo comprobar que funciona

• La pestaña Contenido lista cada elemento que este sitio ha enviado, por base de conocimiento, con su estado y cuándo se sincronizó. Filtra por estado para encontrar lo que esté en error.
• La pestaña Actividad muestra qué está esperando, qué está en una base y qué falló, y los últimos eventos.
• En tu espacio de trabajo, la base de conocimiento muestra los documentos y Fuentes conectadas lista el sitio con la versión del plugin.
• Pregúntale al asistente algo que solo ese contenido responda. La cita debería ser la entrada.

Actualizar desde la versión 1

Tus ajustes se convierten en reglas: una por cada tipo de contenido que sincronizabas, alimentando la base a la que apuntabas y con los campos que enviaba la versión 1. No se reenvía nada y no se reindexa nada: el plugin lee lo que la base ya tiene y lo reconoce.

Los ajustes del widget desaparecen y un aviso lo dice una vez. Si tu sitio cargaba el widget de chat a través del plugin, abre el widget en tu espacio de trabajo y pega su script en tu tema; hasta que lo hagas, el widget no está en el sitio.

Errores habituales

Credenciales no válidas. La clave o el ID de usuario están mal, o pertenecen a espacios distintos. Los dos están en la página de claves de API.

Este plan no incluye la API REST. La suscripción del espacio de trabajo venció. Todos los planes de pago incluyen el conector.

API inaccesible. El sitio no llega a app.welcomeai.dev. Los cortafuegos y WP_HTTP_BLOCK_EXTERNAL en wp-config.php son las causas habituales.

Cupo diario de API alcanzado. La primera sincronización de un sitio grande puede agotar el cupo diario del plan. El plugin se pausa y sigue solo; la pestaña Actividad dice cuándo.

Elementos atascados en "esperando". No hay nada vaciando la cola. En un sitio con poco tráfico WP-Cron se dispara pocas veces: pulsa Enviar lo que está esperando o ejecuta wp welcomeai sync.

Las entradas se sincronizan pero las respuestas no las mencionan. Dale un minuto a la indexación y comprueba que el documento está indexed en la base de conocimiento. Si el contenido lo pinta un maquetador con JavaScript, lo que envía el plugin puede ser más pobre que lo que ve un visitante.

Reconectar

Pega una clave nueva y pulsa Validar. Las reglas, el registro de lo enviado y la cola se conservan. Si la clave fue revocada, dejan de ofrecerse actualizaciones hasta que haya una válida.

Desconectar

Desactivar el plugin detiene las actualizaciones; los documentos siguen en la base de conocimiento y el sitio conserva su registro, así que al reactivarlo sigue donde lo dejó.

Borrar el plugin elimina sus ajustes, reglas y tablas del sitio y nada de ninguna base de conocimiento. Para eliminar también el contenido, borra la fuente de WordPress en Fuentes conectadas, o los documentos directamente.