Como Adicionar o Chatbot de IA Asyntai ao TYPO3
Guia passo a passo para sites TYPO3
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:
- Faça login no seu Backend do TYPO3
- Vá para Web → Template
- Selecione sua página raiz na árvore de páginas
- Clique em "Edit the whole template record" (ou selecione "Info/Modify" e depois "Setup")
- 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> - Substitua
YOUR_WIDGET_IDpelo ID real do seu widget no painel - Clique em "Save"
- 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:
- Navegue até a pasta do seu site package:
packages/your_sitepackage/Configuration/TypoScript/ - Abra ou crie o arquivo setup.typoscript
- 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>
} - Substitua
YOUR_WIDGET_IDpelo seu ID de widget real - Limpe o cache no backend do TYPO3
Alternativa: Usando Fluid Template (FooterAssets)
For sites using Fluid templates, you can use the FooterAssets section:
- Navegue até o seu arquivo de template Fluid (geralmente em
Resources/Private/Templates/) - 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> - Make sure your page layout renders the FooterAssets section:
<f:render section="FooterAssets" optional="true" /> - 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:
- No seu código PHP (ex.: um controller ou middleware), injete oAssetCollector
- 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.
Weebly