Añade un agente de voz con IA a OpenCart (guía 2026)
Añade el agente de voz de AnveVoice a OpenCart con el Theme Editor del admin para sustituir footer.twig: ruta exacta, guardado, borrado de caché y problemas.
Cómo añadir AnveVoice a una tienda OpenCart
OpenCart no tiene un cuadro de código personalizado en sus ajustes. La vía admitida es el Theme Editor (editor de temas) bajo Design (diseño), donde sustituyes la plantilla común del pie y pegas la etiqueta de AnveVoice antes de la etiqueta de cierre body. La sustitución se guarda en la base de datos y surte efecto de inmediato. Pasos comprobados con la documentación oficial el 2026-10-14.
En resumen
- Dónde va el código: Design > Theme Editor > plantilla common/footer (sustitución del pie, guardada en la base de datos)
- Programación necesaria: Pegar una línea en una plantilla Twig; no hace falta acceso a archivos
- Límites del plan: Ninguno: OpenCart es software autoalojado y editas tus propias plantillas
- Tiempo: Unos 5 minutos
Antes de empezar
Obtén tu embed ID en app.anvevoice.app. El plan Free cuesta 0 US$, incluye 50.000 tokens al mes y un bot, y no requiere tarjeta. También necesitas un acceso de administrador a OpenCart. El sistema de layouts de OpenCart es fácil de confundir con un gestor de scripts. La pantalla Design > Layouts (diseño > layouts) solo decide qué módulos aparecen en las posiciones Content Top, Content Bottom, Column Left y Column Right de cada ruta, y su documentación no dice nada sobre scripts. El JavaScript sin procesar pertenece a una plantilla, por eso el Theme Editor es la herramienta adecuada aquí.
- 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: sustituir el pie en el Theme Editor
La documentación de OpenCart describe el Theme Editor como un mecanismo de sustitución: eliges una tienda y una plantilla .twig, editas su código, activas la sustitución y guardas. La versión editada se guarda en la base de datos en lugar de en un archivo, así que la plantilla original en disco no se toca.
- 1. Abre el Theme Editor — En el admin, ve a Design > Theme Editor (diseño > editor de temas) y haz clic en Add New (añadir nuevo), o en Edit (editar) si ya tienes una sustitución para el pie.
- 2. Elige la tienda y la plantilla — Selecciona tu tienda (la tienda predeterminada, o una concreta en una instalación con varias tiendas) y, después, en Choose Template (elegir plantilla), elige la plantilla común del pie, footer.twig. Su código actual se carga en el editor.
- 3. Pega la etiqueta — Desplázate hasta el final de la plantilla y pega la etiqueta de AnveVoice en su propia línea, justo encima de la etiqueta de cierre body. No cambies el Twig que la rodea.
- 4. Activa y guarda — Define Status (estado) como Enabled (activado) y haz clic en Save (guardar). La documentación de OpenCart advierte de que editar una sustitución activa cambia la tienda en vivo de inmediato, así que haz el cambio cuando estés listo para que lo vean los visitantes.
- 5. Borra la caché de plantillas si hace falta — Si el botón no aparece, la documentación indica que la caché de plantillas puede ocultar los cambios; bórrala en System > Settings > Server (sistema > ajustes > servidor) y recarga.
Lo que advierte la documentación de OpenCart
Como las sustituciones viven en la base de datos, incluye la tabla de temas en tus copias de seguridad y cuando migres una tienda; si no, la edición del pie no seguirá la tienda a un servidor nuevo. Tampoco hay bloqueo de archivos: si dos administradores editan la misma sustitución, gana el último guardado. No hay botón de deshacer. Para volver atrás, desactiva la sustitución o pega de nuevo el código original de la plantilla y guarda. Si sustituyes una plantilla que pertenece a una extensión, una actualización de esa extensión puede romper la sustitución, así que para esta tarea es preferible el pie del núcleo. Un error de sintaxis en Twig puede producir una página en blanco; activar el Debug Mode ayuda a encontrar el fallo.
Método 2: editar el archivo en un tema propio
Si mantienes tu propia extensión de tema y despliegas los archivos desde control de versiones, puedes poner la misma línea en la copia de ese tema de common/footer.twig y enviarla con tu código. Es un flujo de desarrollo, y la documentación de OpenCart se centra en el Theme Editor, así que considéralo la alternativa manual. Elijas la vía que elijas, añade la etiqueta una sola vez; el script ignora una segunda copia, pero una sola etiqueta es más fácil de mantener.
Comprueba que funciona
- 1. Abre la tienda en una ventana privada — Carga la página de inicio y una página de producto como invitado.
- 2. Haz clic en el botón del micrófono — Aparece abajo a la derecha por defecto. Permite el micrófono y pregunta algo sobre un producto; la tienda debe usar HTTPS.
- 3. Confirma en el código fuente — Mira el código fuente de la página y busca anvevoice.app/embed.js para confirmar que la sustitución del pie se renderiza.
Problemas habituales en OpenCart
- No hay botón tras guardar: confirma que Status está en Enabled en la sustitución y borra la caché de plantillas.
- Pantalla en blanco tras guardar: se coló un error de sintaxis en Twig. Desactiva la sustitución y vuelve a añadir la etiqueta sin tocar el resto del marcado.
- El botón aparece solo en algunas tiendas: las sustituciones se eligen por tienda, así que repite los pasos para cada tienda de una instalación con varias.
- La edición del pie se pierde tras migrar: la tabla de temas no se incluyó en la exportación de la base de datos.
Fuentes
- Documentación de OpenCart: Theme Editor (https://docs.opencart.com/design/theme-editor.md) — consultado el 2026-10-14
- Documentación de OpenCart: Layouts (https://docs.opencart.com/design/layouts.md) — consultado el 2026-10-14
Relacionado
- Cómo añadir AnveVoice a una tienda PrestaShop
- Cómo añadir AnveVoice a Magento y Adobe Commerce
- Cómo agregar AnveVoice a una tienda WooCommerce
- Cómo añadir AnveVoice a una tienda de Ecwid
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.