Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Como Adicionar o Chatbot de IA Asyntai ao TYPO3

Guia passo a passo para sites TYPO3

Obter Código de Incorporação

Passo 1: Obtenha Seu Código de Incorporação

Primeiro, acesse seu Dashboard Asyntai e role para baixo até a seção "Embed Code". Copie seu código de incorporação exclusivo que se parecerá com isto:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Nota: O código acima é apenas um exemplo. Você deve copiar seu próprio código de incorporação exclusivo do seu Dashboard, pois ele contém seu ID de widget pessoal.

Passo 2: Usando TypoScript footerData (Recomendado)

A maneira mais fácil de adicionar o chatbot a todas as páginas éusando o TypoScript footerData:

  1. Faça login no seu Backend do TYPO3
  2. Vá para Web → Template
  3. Selecione sua página raiz na árvore de páginas
  4. Clique em "Edit the whole template record" (ou selecione "Info/Modify" e depois "Setup")
  5. No campo Setup, adicione o seguinte códigoTypoScript:
    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. Substitua YOUR_WIDGET_ID pelo ID real do seu widget no painel
  7. Clique em "Save"
  8. Limpe o cache do TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

Dica: Usar footerData posiciona o script logo antes da tag de fechamento </body>, o que é recomendado para widgets de chat, pois não irá desacelerar o carregamento da suapágina.

Alternativa: Usando Site Package (Para Site Packages)

Se você está usando um site package, pode adicionar o script por meiodo seu arquivo de configuração TypoScript:

  1. Navegue até a pasta do seu site package:packages/your_sitepackage/Configuration/TypoScript/
  2. Abra ou crie o arquivo setup.typoscript
  3. Adicione o seguinte codigo:
    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. Substitua YOUR_WIDGET_ID pelo seu ID de widget real
  5. Limpe o cache no backend do TYPO3

Alternativa: Usando Fluid Template (FooterAssets)

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

  1. Navegue até o seu arquivo de template Fluid (geralmente emResources/Private/Templates/)
  2. Adicione uma seção FooterAssets no seu layout ou template:
    <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. Limpe o cache do TYPO3

Importante: O recurso FooterAssets requer TYPO3 v8 ou posterior. Para versõesmais antigas, use o método TypoScript footerData.

Alternativa: Usando AssetCollector (Para Desenvolvedores)

For extension developers, TYPO3 v10.3+ offers the AssetCollector API:

  1. No seu código PHP (ex.: um controller ou middleware), injete oAssetCollector
  2. Adicione o script com 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']
    );

Passo 3: Verifique a Instalação

Apos salvar suas alteracoes e limpar o cache, visite seu site em uma nova aba do navegador ou janela anonima. Voce deve ver o botao do widget de chat no canto inferior direito. Clique nele para verificar se abre e funciona corretamente.

Não está vendo o widget? Certifique-se de limpar todos os caches: vá para Admin Tools→ Maintenance → Flush TYPO3 and PHP Cache. Tente tambémlimpar o cache do navegador ou visualizar em uma janela anônima. Seestiver usando TypoScript, verifique se o seu template estádevidamente incluído na hierarquia de páginas.