Añade un agente de voz con IA a TYPO3 (guía 2026)

Cómo añadir AnveVoice a un sitio de TYPO3

TYPO3 añade los recursos de página mediante TypoScript. La instalación más sencilla y estable entre versiones es page.footerData, que imprime la etiqueta script antes de la etiqueta de cierre body. La alternativa, page.includeJSFooterlibs con async, depende de tu versión de TYPO3, porque la propiedad external se eliminó en la v14. Pasos comprobados con la documentación oficial el 2026-10-14.

En resumen

• Dónde va el código: Configuración de TypoScript de tu paquete de sitio o de la plantilla raíz (page.footerData o page.includeJSFooterlibs)
• Programación necesaria: Unas pocas líneas de TypoScript; acceso de administrador o de integrador
• Límites del plan: Ninguno: TYPO3 es autoalojado, pero el acceso a TypoScript suele estar limitado a los administradores
• Tiempo: Unos 10 minutos

Antes de empezar

Obtén tu ID de incrustación en app.anvevoice.app (plan Free: 0 US$, 50.000 tokens al mes, un bot, sin tarjeta). Necesitas poder editar la configuración de TypoScript de tu sitio, ya sea en el módulo Template (Plantilla) del backend (el campo Setup de la plantilla raíz) o en el archivo setup.typoscript de tu paquete de sitio. Si un desarrollador gestiona el paquete de sitio en control de versiones, dale las líneas de abajo en lugar de editar el backend. TYPO3 ofrece varias formas de añadir JavaScript. La documentación de referencia enumera includeJS, includeJSLibs y sus variantes de pie para archivos, y footerData para salida arbitraria. Para una etiqueta de terceros con cadena de consulta, footerData evita cualquier particularidad en el manejo de archivos.

• 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 opcionales de URL son &position=bottom-left y &theme=dark. <script src="https://anvevoice.app/embed.js?embedId=YOUR_EMBED_ID" async></script>

Método 1: page.footerData (funciona en todas las versiones)

La referencia de TypoScript describe footerData como un funcionamiento parecido a headerData, pero su salida va al final de la página, justo antes de la etiqueta de cierre body. Admite claves numéricas, y cada una contiene un objeto de contenido. Elige un número que no use ninguna otra extensión; los números altos son una opción segura.

• 1. Abre tu configuración de TypoScript — En el backend, abre Site Management (Gestión de sitios) > TypoScript (o el módulo Template (Plantilla) en versiones antiguas), elige la página raíz de tu sitio y edita el Setup (Configuración).
• 2. Añade la entrada footerData — Añade estas líneas a la configuración del objeto page, manteniendo tu configuración existente. page.footerData.1760 = TEXT page.footerData.1760.value = <script src="https://anvevoice.app/embed.js?embedId=YOUR_EMBED_ID" async></script>
• 3. Guarda y vacía las cachés — Guarda y después usa el icono del rayo en la barra de herramientas del backend para vaciar las cachés del frontend (o todas las cachés). TypoScript se guarda en caché, así que la nueva salida solo aparece después de vaciarlas.

Método 2: includeJSFooterlibs con async

La misma referencia indica que includeJSFooterlibs coloca un bloque al final de la página, justo antes de la etiqueta de cierre body, y que las subpropiedades como async y defer están disponibles igual que en includeJS. Para archivos alojados en otro host, la referencia documenta una propiedad external que omite la comprobación de existencia del archivo, pero también indica que las propiedades por archivo external, disableCompression y excludeFromConcatenation no están disponibles en TYPO3 v14 y superiores, porque TYPO3 ya no admite la concatenación de recursos ni la precompresión. Así que en TYPO3 v12 y v13, establece external a 1 junto con async. En la v14 y posteriores, elimina la línea external; no te fíes de ella. Si no estás seguro de tu versión o planeas una actualización, el método 1 es la opción más segura.

• 1. Añade la entrada de biblioteca (v12 y v13) — Usa una clave de tu elección y la URL completa como valor. page.includeJSFooterlibs.anvevoice = https://anvevoice.app/embed.js?embedId=YOUR_EMBED_ID page.includeJSFooterlibs.anvevoice.external = 1 page.includeJSFooterlibs.anvevoice.async = 1
• 2. En la v14 y posteriores — Conserva la primera y la tercera línea y elimina la línea external.
• 3. Vacía las cachés — Vacía las cachés del frontend desde la barra de herramientas y recarga.

Particularidades de TYPO3

Qué TypoScript prevalece: con varias plantillas de TypoScript o site sets, el objeto page que edites debe ser el que renderiza tu frontend, normalmente el objeto page definido por tu paquete de sitio. Si tu entrada está en una plantilla de extensión que no se incluye, no se imprimirá nada. Varios sitios e idiomas: el TypoScript asignado a una raíz de sitio se aplica solo a ese sitio, así que las instalaciones multisitio necesitan la entrada en cada raíz, o en un site set compartido. Usa condiciones si el asistente debe aparecer solo en algunos idiomas o árboles de páginas. Seguridad del contenido: si tu sitio envía una cabecera Content Security Policy, añade anvevoice.app a sus orígenes de scripts; de lo contrario, el navegador bloqueará la etiqueta.

Comprueba que funciona

• 1. Abre una página del frontend en una ventana privada — Usa una página de la raíz del sitio que hayas editado.
• 2. Busca el botón — Un botón redondo de micrófono aparece abajo a la derecha por defecto; permite el micrófono (se requiere HTTPS) y haz una pregunta.
• 3. Mira el código fuente — Busca anvevoice.app/embed.js cerca del final del body.

Problemas comunes en TYPO3

• No aparece nada: no se vaciaron las cachés, o el TypoScript está en una plantilla que no está activa para este árbol de páginas.
• La etiqueta se muestra como texto escapado: el valor se definió con un stdWrap que codifica HTML; usa TEXT con un valor simple como se muestra.
• Funciona en la v12 pero no tras actualizar a la v14: la propiedad external ya no existe; cambia a footerData o elimina esa línea.
• Aparece en el head: la entrada se puso por error en headerData o en includeJSLibs.

Fuentes

• Referencia de TypoScript de TYPO3 (v13): propiedades de página, includeJSFooterlibs, footerData (https://docs.typo3.org/m/typo3/reference-typoscript/main/en-us/Setup/Page/Index.html) — consultado el 2026-10-14
• Referencia de TypoScript de TYPO3 (v12): includeJS external y footerData (https://docs.typo3.org/m/typo3/reference-typoscript/12.4/en-us/Setup/Page/Index.html) — consultado el 2026-10-14

Relacionado

• Cómo añadir AnveVoice a un sitio de Drupal
• Cómo añadir AnveVoice a un sitio Joomla
• Cómo añadir AnveVoice a un sitio de Umbraco
• Cómo añadir AnveVoice a un sitio WordPress

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.