Volver al panel

Documentación

Aprende a usar Asyntai

Cómo añadir el chatbot de IA de Asyntai a TYPO3

Guía paso a paso para sitios web de TYPO3

Obtener código de inserción

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:

  1. Inicia sesión en su backend de TYPO3
  2. Ve a Web → Template
  3. Seleccione su página raíz en el árbol de páginas
  4. Haga clic en "Edit the whole template record" (o seleccione "Info/Modify" y luego "Setup")
  5. 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>
  6. Reemplaza YOUR_WIDGET_ID con su ID de widget real del panel de control
  7. Haga clic en "Save"
  8. 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:

  1. Navegue a la carpeta de su paquete de sitio: packages/your_sitepackage/Configuration/TypoScript/
  2. Abra o cree setup.typoscript
  3. 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>
    }
  4. Reemplaza YOUR_WIDGET_ID con su ID de widget real
  5. Limpie la caché en el backend de TYPO3

Alternativa: Usar plantilla Fluid (FooterAssets)

For sites using Fluid templates, you can use the FooterAssets section:

  1. Navegue a su archivo de plantilla Fluid (generalmente en Resources/Private/Templates/)
  2. 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>
  3. Make sure your page layout renders the FooterAssets section:
    <f:render section="FooterAssets" optional="true" />
  4. 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:

  1. En su código PHP (por ejemplo, un controlador o middleware), inyecta el AssetCollector
  2. 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.