Extensión de Chatbot con IA para TYPO3 (Gratis, TYPO3 10 a 14)

Extensión TYPO3

La extensión WebChatAgent coloca tu chatbot en un sitio web de TYPO3. La instalas, pegas tu ID del chatbot en la configuración del sitio, y el botón de chat aparece en cada página de ese sitio. No hay TypoScript que incluir ni plantilla que modificar. El diseño, los textos, el comportamiento de la IA y el chat en vivo permanecen en tu panel de WebChatAgent, por lo que los cambios realizados allí se reflejan de inmediato en el sitio web.

Una misma versión cubre TYPO3 10.4, 11.5, 12.4, 13.4 y 14.

Paso 1: Instalar la extensión

Con Composer (la mayoría de proyectos TYPO3):

composer require webchatagent/typo3-webchatagent
vendor/bin/typo3 extension:setup

Sin Composer: abre Admin Tools → Extensions, busca webchatagent e instálala. TYPO3 crea los campos de la base de datos automáticamente.

La extensión es gratuita. La encontrarás en el TYPO3 Extension Repository y en Packagist.

Paso 2: Copiar tu ID del chatbot

1. Inicia sesión en tu panel de WebChatAgent y abre tu chatbot.
2. Abre Acciones del chatbot y haz clic en Copiar ID del chatbot.

El ID tiene un formato similar a 3f2b9c1e-8a7d-4e5f-9b0c-1d2e3f4a5b6c.

Paso 3: Añadir el ID a tu sitio

1. En TYPO3, dirígete a Site Management → Sites y edita tu sitio.
2. Abre la pestaña Chat.
3. Pega el ID del chatbot en ID del chatbot y guarda.

Abre tu sitio web en una nueva pestaña: el botón de chat aparecerá en la esquina de cada página. Si tienes varios sitios en una misma instalación de TYPO3, cada sitio tiene su propio ID, de modo que cada sitio web puede ejecutar su propio chatbot.

Ocultar el chat en ciertas páginas

Abre las propiedades de la página, pestaña Chat, y activa la opción Hide the chat button on this page and all subpages. Resulta útil para páginas de pago, páginas de aterrizaje de anuncios o un área de intranet.

La opción se aplica a la página y a todo lo que esté por debajo de ella. Si la activas en la página raíz, el botón de chat desaparecerá en todo el sitio, una forma rápida de pausar el chat sin borrar el ID.

Mostrar el chat dentro de una página

Para una página de contacto o ayuda, puedes colocar el chat directamente en el contenido en lugar de (o además de) utilizar el botón flotante:

1. En el módulo Page, añade un nuevo elemento de contenido.
2. Elige Chat integrado en Special elements.
3. Deja ID del chatbot vacío para usar el ID del sitio, o introduce otro para esta página en concreto.
4. Opcional: define una Altura como 600px u 80vh. Sin ella, el chat crecerá según su contenido.

El script del chat integrado solo se carga en las páginas que contienen dicho elemento. El texto de bienvenida, el tema y las demás opciones integradas provienen de Canales → Chat integrado en el panel, consulta la guía de Inline Chat.

Los editores sin permisos de administrador necesitan tener habilitados los nuevos campos y el tipo de contenido "Chat integrado" en su grupo de usuarios de backend.

Transferir usuarios identificados del sitio web al chat

Si tu sitio TYPO3 dispone de un área de acceso para usuarios, activa Pass logged-in website users to the chat en la pestaña Chat del sitio. Para los visitantes que hayan iniciado sesión, el chat recibirá su nombre, correo electrónico y usuario. El bot podrá saludarlos por su nombre y no les volverá a pedir sus datos de contacto.

TYPO3 añade estos datos en cada petición, por lo que nunca se guardan en la caché de la página. Los visitantes que no hayan iniciado sesión no envían datos de usuario. Recuerda mencionar esta transferencia en tu política de privacidad.

Enviar datos personalizados (para desarrolladores)

Para transferir datos adicionales, como un número de cliente, registra un listener para el evento WebChatAgent\WebChatAgent\Event\ModifyContextDataEvent y añade tus claves mediante setContextData(). El README en GitHub incluye un ejemplo completo. El formato y los límites se detallan en Embedding the chat widget.

Content Security Policy

Con la CSP de frontend habilitada (TYPO3 12 y posteriores), la extensión añade el servidor de chat a la política para scripts, conexiones, imágenes y medios, además de permitir estilos en línea para el widget. No es necesario editar csp.yaml.

Consentimiento de cookies

WebChatAgent no muestra su propio banner de consentimiento. Sin una señal de consentimiento, funciona en Privacy Mode anónimo. Si tu sitio TYPO3 utiliza un gestor de consentimiento, conéctalo según se describe en Cookie Consent and Anonymous Proactive Triggers.

Resolución de problemas

• ¿No aparece el botón de chat? Comprueba que el ID en la pestaña Chat esté completo y que ni la página ni sus páginas superiores tengan activado Hide the chat button. A continuación, vacía la caché de TYPO3. Si utilizas una caché de archivos estáticos como EXT:staticfilecache, vacíala también.
• ¿Sigue sin mostrarse? Es posible que tu chatbot esté restringido a ciertos dominios. Añade el dominio de tu sitio web en Allowed Domains dentro del panel.
• ¿Bloqueado por Content Security Policy? Revisa la consola del navegador. Si alojas el chat bajo tu propia dirección (marca blanca), introdúcela en Server address dentro de la pestaña Chat para que la extensión autorice exactamente esa dirección.