Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Como Adicionar o Chatbot de IA Asyntai ao Drupal

Guia passo a passo para sites Drupal

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 o Módulo Header and Footer Scripts (Recomendado)

A maneira mais fácil de adicionar o chatbot é usando o módulo Header and Footer Scripts:

  1. Faça login no seu painel administrativo do Drupal
  2. Vá até Extend e clique em "Install new module"
  3. Pesquise por "Header and Footer Scripts" ou baixe em Drupal.org
  4. Instale e ative o módulo
  5. Va ate Configuration → Development → Header and Footer Scripts
  6. Clique na aba "Footer"
  7. Cole o código de incorporação do Asyntai no campo Footer Scripts
  8. Clique em "Save configuration"

Dica: Adicionar o codigo na secao do footer garante que ele carregue apos o conteudo da pagina, o que e recomendado para widgets de chat.

Alternativa: Editar Template do Tema

Você também pode adicionar o código diretamente ao HTML do seu tema:

  1. Navegue até a pasta do seu tema: themes/your_theme/
  2. Abra o arquivo html.html.twig (ou crie um se nao existir)
  3. Encontre a tag de fechamento </body>
  4. Cole seu código de incorporação Asyntai logo antes da tag </body>
  5. Salve o arquivo
  6. Limpe o cache do Drupal: Configuration → Performance → Clear all caches

Importante: Alteracoes em arquivos do tema podem ser sobrescritas ao atualizar seu tema. Considere usar um tema filho ou o modulo Header and Footer Scripts para uma solucao mais permanente.

Alternativa: Usando Libraries (Para Desenvolvedores)

Para desenvolvedores que preferem usar o sistema de biblioteca de ativos do Drupal:

  1. Crie ou edite o arquivo *.libraries.yml do seu tema
  2. Adicione uma nova entrada de biblioteca:
    asyntai-chatbot:
    js:
    https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
  3. Anexe a biblioteca no arquivo *.info.yml do seu tema:
    libraries:
    - your_theme/asyntai-chatbot
  4. Limpe o cache do Drupal

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 o cache do Drupal em Configuration → Performance → Clear all caches. Tente tambem limpar o cache do navegador ou visualizar em uma janela anonima.