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 su Panel de control de Asyntai y desplácese hasta la sección "Código de inserción". Copie su 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 mas fácil de agregar el chatbot a todas las páginas es usando footerData de TypoScript:
- Inicia 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")
- In the Setup field, add the following TypoScript code:
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> - Reemplaza
YOUR_WIDGET_IDcon su ID de widget real del panel de control - Haga clic en "Save"
- Vacia la cache de TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
Consejo: Usar footerData coloque 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)
For sites using Fluid templates, you can use the FooterAssets section:
- 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> - Make sure your page layout renders the FooterAssets section:
<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)
For extension developers, TYPO3 v10.3+ offers the AssetCollector API:
- 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ías ver el botón del widget de chat en la esquina inferior derecha. Haga clic en él para asegurarte de que se abra y funciona 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