Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Como Adicionar o Chatbot de IA Asyntai ao Umbraco

Guia passo a passo para sites Umbraco 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: Editar o Template Master (Recomendado)

A maneira mais fácil de adicionar o chatbot a todas as páginas éeditando o seu template Master:

  1. Faça login no seu Umbraco Backoffice
  2. Acesse Settings na barra lateral esquerda
  3. Expanda Templates
  4. Clique no seu template Master (ou no template de layout principal que seu site utiliza)
  5. Encontre a tag de fechamento </body>
  6. Cole seu código de incorporação Asyntai logo antes da tag </body>
  7. Clique em "Save"

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.

Alternativa: Usando Document Type de Configurações do Site

Para mais flexibilidade, você pode adicionar um campo personalizadopara gerenciar scripts do rodapé:

  1. Vá para Settings → Document Types
  2. Edite o document type Site Settings (ou crie um senão existir)
  3. Adicione uma nova propriedade chamada "Footer Scripts" com o tipo de dados Textarea
  4. Salve o Document Type
  5. Vá para Content e edite o nó de Site Settings
  6. Cole o código de incorporação do Asyntai no campo Footer Scripts
  7. No seu template Master, adicione este código antes de</body>:
    @Html.Raw(Model.Value("footerScripts"))
  8. Salve tanto o conteúdo quanto o template

Nota: Usar @Html.Raw() é importante para renderizar as tags de script corretamente sem codificação HTML.

Alternativa: Usando a Pasta de Scripts

Você também pode criar um arquivo JavaScript no Umbraco Backoffice:

  1. Vá para Settings → Scripts
  2. Clique com o botão direito em Scripts e selecione"Create"
  3. Crie um novo arquivo chamado asyntai-chatbot.js
  4. Adicione o seguinte codigo:
    (function() {
      var script = document.createElement('script');
      script.async = true;
      script.src = 'https://asyntai.com/static/js/chat-widget.js';
      script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
      document.body.appendChild(script);
    })();
  5. Substitua YOUR_WIDGET_ID pelo seu ID de widget real
  6. Salve o arquivo
  7. Inclua este script no seu template Master antes de</body>:
    <script src="/scripts/asyntai-chatbot.js"></script>

Alternativa: Página Específica com RenderSection

Se voce deseja o chatbot apenas em paginas especificas:

  1. No seu template Master, adicione antes de</body>:
    @RenderSection("footerScripts", required: false)
  2. No template da página específica onde deseja o chatbot, adicione:
    @section footerScripts {
      <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
    }

Passo 3: Verifique a Instalação

Após salvar suas alterações, visite seu site em uma nova aba do navegador ou em uma janela anônima. Você deverá ver o botão 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 que salvou o template após fazer as alterações. Tente limpar o cache do navegador ou visualizar em uma janelaanônima. Se estiver usando o Umbraco Cloud, as alterações devem ser implantadas automaticamente. Para Umbraco auto-hospedado, pode ser necessário reiniciar a aplicação ou limpar o cache.