AnveVoice

Añade un agente de voz con IA a Joomla 4 y 5 (2026)

Añade el agente de voz de AnveVoice a Joomla con un módulo Custom en una posición de pie o con el Web Asset Manager de tu plantilla.

Cómo añadir AnveVoice a un sitio Joomla

En Joomla, la instalación más rápida es un módulo Custom (personalizado) colocado en una posición de pie de tu plantilla y mostrado en todas las páginas, con el editor cambiado a None (ninguno) para que conserve la etiqueta script. Los desarrolladores también pueden registrar el script a través del Web Asset Manager de la plantilla. Pasos comprobados con la documentación oficial el 2026-10-14.

En resumen

  • Dónde va el código: Un módulo Custom (System > Site Modules) en una posición de pie, o los assets web de la plantilla
  • Programación necesaria: Ninguna para el método con módulo; PHP y JSON para el método con plantilla
  • Límites del plan: Ninguno: Joomla es autoalojado. Los filtros de texto de tu grupo de usuarios pueden eliminar las etiquetas script
  • Tiempo: Unos 5 minutos

Antes de empezar

Crea tu bot de AnveVoice en app.anvevoice.app (plan Free: 0 US$, 50.000 tokens al mes, un bot, sin tarjeta) y copia el embed ID. Necesitas Super User (superusuario) o un rol equivalente que pueda gestionar módulos. La principal trampa de Joomla es el editor. La página de ayuda de Joomla para el módulo Custom indica que el editor no permite ciertas etiquetas HTML, y una etiqueta script es justo el tipo de cosa que se elimina o se reescribe. Sus soluciones sugeridas son cambiar temporalmente el editor de tu usuario a No Editor (ningún editor), usar una extensión de editor que acepte HTML sin procesar, o usar el modo HTML del editor, introducir el código y guardar.

  • 1. Copia tu etiqueta de instalación — Sustituye YOUR_EMBED_ID por el ID que aparece en tu panel de AnveVoice (app.anvevoice.app). Los parámetros de URL opcionales son &position=bottom-left y &theme=dark. <script src="https://anvevoice.app/embed.js?embedId=YOUR_EMBED_ID" async></script>

Método 1: un módulo Custom en una posición de pie

Prepare Content (preparar contenido), en la pestaña Options (opciones) del módulo, puede quedarse en No; solo hace que el texto pase por los plugins de contenido, y la etiqueta no necesita nada de eso.

  • 1. Cambia tu editor a None — Abre tu propia cuenta de usuario (Users > Manage, edítate a ti mismo) y en la pestaña Basic Settings (ajustes básicos) define Editor como Editor - None. Guarda. Después puedes restaurar TinyMCE.
  • 2. Crea el módulo — Ve a System (sistema) y, en Manage (gestionar), elige Site Modules (módulos del sitio), haz clic en New (nuevo) y selecciona Custom (personalizado). Ponle un título, como AnveVoice, y define Show Title (mostrar título) como Hide (ocultar).
  • 3. Pega la etiqueta — En el área de contenido, pega la etiqueta de AnveVoice exactamente como se muestra, sin nada alrededor.
  • 4. Elige una posición — Define Position (posición) como una que tu plantilla muestre. Con la plantilla predeterminada de Joomla, Cassiopeia, footer (pie) funciona bien. Asegúrate de que Status (estado) sea Published (publicado).
  • 5. Asígnalo a todas las páginas — En la pestaña Menu Assignment (asignación de menú), elige On All Pages (en todas las páginas). La página de ayuda también enumera No Pages (ninguna página), Only on the pages selected (solo en las páginas seleccionadas) y On all pages except those selected (en todas las páginas excepto las seleccionadas), que permiten limitarlo a ciertos elementos de menú.
  • 6. Guarda y prueba — Haz clic en Save & Close (guardar y cerrar), recarga la parte pública y busca el botón del micrófono.

Método 2: registra el script en tu plantilla

El manual de Joomla explica que los scripts se cargan a través del Web Asset Manager. Un asset definido en un archivo joomla.asset.json puede apuntar a una biblioteca externa estableciendo su uri con la URL completa, y sus atributos se asignan directamente a la etiqueta script, con async y defer como ejemplos. Las plantillas y los componentes tienen su propio joomla.asset.json, que se lee automáticamente, mientras que los módulos y los plugins deben registrar los suyos. Hazlo en un hijo de tu plantilla o en una plantilla personalizada, para que una actualización de la plantilla no lo borre. El ejemplo propio del manual es una biblioteca OpenLayers cuyo uri es una dirección de CDN; el tuyo es la URL de AnveVoice. Después de definir el asset en el joomla.asset.json de la plantilla, cárgalo con useScript en el index.php de la plantilla, a través del WebAssetManager obtenido del documento.

  • 1. Define el asset — Añade una entrada a la lista de assets en templates/<tu-plantilla>/joomla.asset.json. { "name": "anvevoice.embed", "type": "script", "uri": "https://anvevoice.app/embed.js?embedId=YOUR_EMBED_ID", "attributes": { "async": true }, "version": "auto" }
  • 2. Usa el asset — En el index.php de la plantilla, después de las líneas existentes de WebAssetManager, añade $wa->useScript('anvevoice.embed'); y guarda. Recarga el sitio.

Comprueba que funciona

  • 1. Abre el sitio como visitante — Una ventana privada evita las cachés y las diferencias que solo ve el administrador.
  • 2. Prueba el botón de voz — Haz clic en el botón redondo del micrófono (abajo a la derecha por defecto), permite el acceso al micrófono y habla. Se requiere HTTPS.
  • 3. Borra la caché de Joomla si no aparece nada — Ve a System > Clear Cache (borrar caché), selecciona todo y elimina, y luego recarga. Si usas caché de página o un CDN, purga también esa caché.

Problemas habituales en Joomla

  • La etiqueta desaparece al guardar el módulo: el editor WYSIWYG o un filtro de texto la eliminó. Define el editor como None y revisa System > Global Configuration > Text Filters (filtros de texto) para tu grupo de usuarios.
  • El módulo no se muestra: el nombre de la posición no existe en tu plantilla, o Menu Assignment está en No Pages. Compara con las posiciones que enumera tu plantilla.
  • La etiqueta aparece dos veces: el módulo y la plantilla la cargan ambos. Usa un solo método.
  • Se pierde tras actualizar la plantilla: editaste la plantilla original. Usa una plantilla hija.
  • El micrófono nunca pide permiso: la página está en HTTP.

Fuentes

  • Ayuda de Joomla (5.x): módulos del sitio, Custom (https://docs.sandbox.joomla.org/Help5.x:Site_Modules:_Custom) — consultado el 2026-10-14
  • Manual de Joomla: añadir JavaScript con el Web Asset Manager (https://manual.joomla.org/docs/general-concepts/javascript/adding-javascript/) — consultado el 2026-10-14

Relacionado

  • Cómo añadir AnveVoice a un sitio de Drupal
  • Cómo añadir AnveVoice a un sitio WordPress
  • Cómo añadir AnveVoice a un sitio de TYPO3
  • Cómo añadir AnveVoice a un sitio de Concrete CMS

Prueba AnveVoice en tu sitio

Plan gratuito: 0 US$, 50.000 tokens al mes, sin tarjeta. Obtén tu ID de inserción en el panel y pega una etiqueta.