Usar CMS AI Agent con Joomla
Todo lo que necesitas para Joomla, en el orden en el que lo vas a hacer de verdad. Si te atascas, la última sección trae los mensajes de error reales y qué significa cada uno.
Activa esto primero
- Dos plugins activados en Sistema → Plugins. Este es el paso que se le olvida a todo el mundo, y no funciona nada hasta que los dos están encendidos: Web Services - Content y API Authentication - Web Services Joomla Token.
- Un token de API, generado en el administrador de Joomla en Usuarios → Gestionar: edita un usuario, abre la pestaña Joomla API Token y crea uno. La cuenta necesita permisos de Administrador o Super Usuario.
- Joomla 4 o posterior. Joomla 3 no tiene API de servicios web en absoluto, y no hay nada que se pueda activar para dársela.
Conectar tu sitio web
- En CMS AI Agent, añade tu sitio web por su dirección: la misma que escribes en el navegador, con https:// incluido.
- Comprobamos la dirección y te decimos qué hemos encontrado: que es Joomla, qué versión, y si su API de servicios web responde en /api/.
- Pega el token de API. Es largo y solo se muestra una vez: si lo has perdido, genera uno nuevo en vez de adivinarlo.
- Elige qué puede hacer la conexión: solo leer, escribir borradores, cambiar el SEO. Nunca es «todo», y puedes cambiarlo después.
- Y ya está. No se instala nada en tu sitio Joomla: ni una extensión, ni un plugin nuestro, ni un archivo. La conexión entera es la propia API de servicios web de Joomla.
Qué puedes pedir en Joomla
-
Leer el contenido
Mirar lo que ya hay en el sitio web: la lista de páginas y entradas, quién escribió cada una, cuándo cambió por última vez, si está publicada, y el texto completo de cualquiera de ellas.
«¿Qué páginas no se han tocado en más de un año?»
-
Crear contenido
Añadir algo que antes no existía: una página nueva, una entrada nueva, una ficha del tipo que use tu sitio web. Llega como borrador, con título, texto y un resumen corto, listo para que lo leas antes de que lo vea nadie más.
«Añade una página sobre nuestro nuevo horario y déjala como borrador.»
-
Editar contenido
Cambiar algo que ya está ahí: el título, el texto, el resumen. Se te dice exactamente qué elementos se han tocado, y tu sitio web conserva su propio historial de lo que decían antes.
«Cambia el teléfono de la página de Contacto por el nuevo.»
-
Publicar contenido
Mover algo entre borrador, publicado y privado. Este es el paso que decide si el público puede ver una página, y por eso es algo que se pide a propósito y no algo que ocurre de pasada.
«Publica el borrador del mercado del sábado.»
-
Programar publicaciones
Poner una fecha y una hora futuras para que algo aparezca, de modo que una entrada escrita un martes por la tarde salga el lunes por la mañana sin que nadie esté delante del teclado.
«Programa la entrada del horario de Navidad para el uno de diciembre.»
-
Gestionar imágenes y archivos
Subir imágenes y archivos al sitio web y rellenar el texto que va con ellos: el título, el pie de foto y el texto alternativo que lee un lector de pantalla y que un buscador lee en lugar de la imagen.
«Sube las fotos de la semana pasada a la galería y escribe el texto alternativo de cada una.»
-
Gestionar categorías y etiquetas
Ordenar el contenido para que la gente lo encuentre: en qué categoría está una entrada, qué etiquetas lleva, y crear una categoría o etiqueta nueva cuando hace falta de verdad.
«Pon todas las entradas de recetas en la categoría Recetas.»
-
Editar la información SEO
El texto que no se ve en la página pero decide cómo se ve la página en un resultado de búsqueda y cuando alguien la comparte: el título SEO, la descripción de debajo y el texto alternativo de las imágenes.
«¿Qué páginas no tienen descripción SEO? Escribe una para cada una.»
-
Gestionar los menús
Los menús en los que hace clic un visitante: añadir una entrada, cambiarle el nombre, ponerlas en otro orden, meter una debajo de otra.
«Añade la nueva página de Horario al menú principal, después de Contacto.»
-
Información del sitio
Los datos llanos del sitio web: cómo se llama, con qué software y qué versión funciona, cuántas páginas y entradas tiene, en qué idiomas está escrito y cuándo cambió por última vez.
«¿Cuántas páginas tiene mi sitio web y cuándo se actualizó cada una?»
-
Información de administración
Qué hay instalado, qué tiene una actualización pendiente y quién tiene cuenta en el sitio web. Solo lectura: no instala, actualiza, activa ni elimina plugins o temas, no cambia ajustes y no añade ni modifica usuarios.
«¿Hay algo en mi sitio web esperando una actualización?»
Qué no va a hacer en Joomla
Joomla no tiene forma de hacer esto, así que este agente no lo ofrece. Lo que habría significado:
-
Tipos de contenido propios
Pocos sitios web tienen solo páginas y entradas. Una inmobiliaria tiene inmuebles, un restaurante tiene platos, una escuela tiene cursos. Esto es trabajar con esos, en sus propios campos, en vez de obligar a que todo sea una entrada de blog.
-
Cambios en lote
El mismo cambio en muchos elementos a la vez. No ocurre nada de inmediato: primero se te muestra la lista entera, con el valor actual al lado del valor propuesto, y se ejecuta solo después de que digas que sí. Se puede parar a medias y se puede deshacer.
-
Gestionar redirecciones
Mandar una dirección antigua a una nueva, para que un enlace que alguien guardó o un resultado que sigue en Google acabe en la página correcta en vez de en un error. También puede listar todo lo que ya se está mandando a otro sitio.
Conviene saber sobre Joomla
- Un artículo está en una sola categoría y lleva muchas etiquetas. Eso es el modelo de Joomla, no una limitación nuestra, así que pedir que un artículo esté en dos categorías se rechaza con el motivo, en vez de dejarlo callado en la última que se nombró.
- Joomla no guarda título, pie ni texto alternativo en el archivo. Eso se escribe allí donde se usa la imagen, dentro del artículo, así que las imágenes se pueden listar y subir, pero en el archivo no hay nada que etiquetar.
- La meta descripción se puede escribir y volver a leer. El título del navegador no: Joomla lo guarda dentro de los atributos del propio artículo y no como campo, y la petición de cambiarlo se rechaza con ese motivo.
- El cuerpo de un artículo vuelve como un solo texto, porque Joomla junta la introducción y el texto completo antes de entregarlos. Al escribir, todo va a la introducción y el texto completo se vacía, que es lo que mantiene el artículo entero en vez de partirlo sin avisar.
Cuando algo sale mal
Los fallos con los que se topa la gente de verdad, con las palabras exactas que te va a mostrar CMS AI Agent. El mensaje está en inglés estés donde estés, porque es lo que dice el software.
El sitio es claramente Joomla y está claramente en línea, pero la comprobación dice que la API está apagada.
Lo que vas a ver
Qué hacer
Este es el problema de los dos plugins, y es el fallo más común en Joomla con diferencia. Ve a Sistema → Plugins, busca «Web Services» y activa Web Services - Content. Después busca «API Authentication» y activa API Authentication - Web Services Joomla Token. Los dos. Uno solo da un 404 que parece exactamente que la API no existe.
El token se rechaza.
Lo que vas a ver
Qué hacer
Comprueba que lo copiaste entero (es largo y se corta con facilidad) y que el plugin «API Authentication - Web Services Joomla Token» está activado. Con ese plugin apagado Joomla ignora el token por completo y todos los tokens parecen incorrectos.
El token se acepta, pero no se puede leer ningún contenido.
Lo que vas a ver
Qué hacer
El token es de una cuenta sin permisos suficientes. Genera uno nuevo en una cuenta con permisos de Administrador o Super Usuario: el token lleva los permisos de esa cuenta y nada más.
El sitio responde en el navegador pero a nosotros nos rechaza, muchas veces con «Not Acceptable».
Lo que vas a ver
Qué hacer
Algo delante de Joomla nos está bloqueando: una extensión de seguridad, Cloudflare o el cortafuegos del alojamiento. «Not Acceptable» suele ser ModSecurity en alojamiento compartido. Pide a tu alojamiento que permita las peticiones a /api/, o añade una excepción en la extensión de seguridad.
Llegamos al sitio pero no encontramos ninguna API de Joomla.
Lo que vas a ver
Qué hacer
Comprueba que la dirección es correcta: que falte el www o que haya una redirección a otro dominio es la causa habitual. Si la dirección está bien, mira la versión de Joomla: Joomla 3 no tiene API de servicios web, y no hay plugin que se la dé.