Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Como Adicionar o Chatbot de IA Asyntai ao ExpressionEngine

Guia passo a passo para ExpressionEngine CMS

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: Adicionar ao Layout do Template (Recomendado)

A maneira mais facil de adicionar o chatbot a todas as paginas e editando o template de layout principal no painel de controle do ExpressionEngine:

  1. No painel de controle do EE, va ate Developer > Templates > Template Groups
  2. Abra o grupo de templates principal (geralmente \"site\") e edite o template de layout (ou o template que envolve todas as paginas)
  3. Encontre a tag de fechamento </body>
  4. Cole seu código de incorporação Asyntai logo antes da tag </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. Salve o template

Dica: Adicionar o script antes da tag de fechamento </body> garante que ele carregue após o conteúdo da página, o que é recomendado para widgets de chat e não atrasa o carregamento da sua página.

Método Alternativo 1: Usando Template Partials do EE

Os Template Partials do ExpressionEngine permitem criar trechos reutilizaveis que podem ser incluidos em varios templates:

  1. No painel de controle do EE, vá até Developer > Templates > Template Partials
  2. Clique em \"New\" para criar um novo partial chamado _asyntai_widget
  3. Cole seu código de incorporação Asyntai no conteúdo do partial:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. Salve o partial
  5. Inclua-o no seu template de layout logo antes da tag de fechamento </body>:
    {embed="_asyntai_widget"} </body>

Nota: Usar Template Partials mantem seu codigo organizado e facilita a atualizacao do codigo de incorporacao do chatbot em um unico lugar em todo o site.

Método Alternativo 2: Usando Cabeçalho/Rodapé HTML do EE

Algumas configuracoes do ExpressionEngine oferecem uma secao global de footer para adicionar scripts:

  1. Va ate Settings > Content & Design > Global Template Preferences
  2. Se sua configuracao do EE tiver uma secao global de footer, cole o codigo de incorporacao Asyntai la
  3. Se nenhuma secao global de footer estiver disponivel, edite seu template de layout principal diretamente e adicione o codigo de incorporacao antes da tag de fechamento </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. Salve suas alterações

Método Alternativo 3: Usando config.php

Para usuarios avancados, voce pode injetar o script do chatbot atraves da configuracao do ExpressionEngine ou criando um add-on personalizado:

  1. Acesse os arquivos do projeto ExpressionEngine via FTP, SSH ou seu editor de codigo
  2. Navegue ate o diretorio system/user/config/ e abra o config.php
  3. Para injecao de JavaScript personalizado, considere criar um add-on/extensao simples do EE que se conecta ao hook template_post_parse para injetar o script na renderizacao da pagina:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. Substitua YOUR_WIDGET_ID pelo ID real do seu widget no painel

Importante: O metodo config.php e add-on e destinado a usuarios avancados com experiencia em desenvolvimento ExpressionEngine. Para a maioria dos usuarios, o metodo de layout de template (Passo 2) ou o metodo de Template Partials (Metodo Alternativo 1) e recomendado.

Passo 3: Verifique a Instalação

Apos salvar suas alteracoes, visite seu site ExpressionEngine 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 ter salvo o template e de estar editando o template de layout correto que suas paginas usam. Limpe o cache do navegador ou visualize em uma janela anonima. Se o cache de templates do ExpressionEngine estiver ativado, limpe o cache no painel de controle em Developer > Utilities > Cache Manager.