Cómo añadir el chatbot de IA de Asyntai a TYPO3
Guía paso a paso para sitios web de TYPO3
Paso 1: Obtén su código de inserción
Primero, ve a tu Panel de control de Asyntai y desplázate hasta la sección "Código de inserción". Copia tu código de inserción único que se verá así:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Nota: El código anterior es solo un ejemplo. Debe copiar su propio código de inserción único desde su Panel de control ya que contiene su ID de widget personal.
Paso 2: Usar TypoScript footerData (Recomendado)
La forma más fácil de agregar el chatbot a todas las páginas es usando footerData de TypoScript:
- Inicie sesión en su backend de TYPO3
- Ve a Web → Template
- Seleccione su página raíz en el árbol de páginas
- Haga clic en "Edit the whole template record" (o seleccione "Info/Modify" y luego "Setup")
- En el campo Setup, agrega el siguiente código TypoScript:
page.footerData.99 = TEXT
page.footerData.99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Reemplace
YOUR_WIDGET_IDcon su ID de widget real del panel de control - Haga clic en "Save"
- Vacíe la caché de TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
Consejo: Usar footerData coloca el script justo antes de la etiqueta de cierre </body>, lo cual es recomendable para widgets de chat ya que no ralentizará la carga de su página.
Alternativa: Usar Site Package (Para Site Packages)
Si estás utilizando un paquete de sitio, puede agregar el script a través de su archivo de configuración TypoScript:
- Navegue a la carpeta de su paquete de sitio:
packages/your_sitepackage/Configuration/TypoScript/ - Abra o cree setup.typoscript
- Añada el siguiente código:
page.footerData {
99 = TEXT
99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
} - Reemplaza
YOUR_WIDGET_IDcon su ID de widget real - Limpie la caché en el backend de TYPO3
Alternativa: Usar plantilla Fluid (FooterAssets)
Para sitios que usan plantillas Fluid, puedes usar la sección FooterAssets:
- Navegue a su archivo de plantilla Fluid (generalmente en
Resources/Private/Templates/) - Añada una sección FooterAssets en su layout o plantilla:
<f:section name="FooterAssets">
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</f:section> - Asegúrate de que el diseño de tu página renderice la sección FooterAssets:
<f:render section="FooterAssets" optional="true" /> - Limpie la caché de TYPO3
Importante: La función FooterAssets requiere TYPO3 v8 o posterior. Para versiones anteriores, utiliza el método footerData de TypoScript.
Alternativa: Usar AssetCollector (Para desarrolladores)
Para desarrolladores de extensiones, TYPO3 v10.3+ ofrece la API AssetCollector:
- En su código PHP (por ejemplo, un controlador o middleware), inyecta el AssetCollector
- Añada el script con atributos personalizados:
use TYPO3\CMS\Core\Page\AssetCollector;
$this->assetCollector->addJavaScript(
'asyntai_chatbot',
'https://asyntai.com/static/js/chat-widget.js',
['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID']
);
Paso 3: Verificar la instalación
Después de guardar sus cambios y limpiar la caché, visite su sitio web en una nueva pestaña del navegador o en una ventana de incógnito. Debería ver el botón del widget de chat en la esquina inferior derecha. Haga clic en él para asegurarse de que se abra y funcione correctamente.
¿No ves el widget? Asegúrese de vaciar todos los cachés: ve a Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. También intenta limpiar el caché de su navegador o ver en una ventana de incógnito. Si usas TypoScript, verifique que su plantilla esté correctamente incluida en la jerarquía de páginas.
Weebly