Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Como Adicionar o Chatbot de IA Asyntai ao Adobe Commerce (Magento)

Guia passo a passo para sites Magento

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.

Etapa 2: Usando o Page Builder (Recomendado)

A maneira mais fácil de adicionar o chatbot é usando o bloco de Código HTML do Page Builder:

  1. Faça login no seu Painel Administrativo do Magento
  2. Vá para Content → Pages
  3. Edite sua página inicial (ou qualquer página onde deseja o chatbot)
  4. No Page Builder, arraste um elemento "HTML Code" para a página
  5. Cole seu código de incorporação Asyntai
  6. Clique em "Save"
  7. Limpe o cache: System → Cache Management → Flush Magento Cache

Importante: Usar o Page Builder adiciona o código apenas a páginas individuais. Para instalação em todo o site, use o método Layout XML abaixo.

Alternativa: Usando Layout XML (Todas as Páginas)

To add the chatbot to all pages, create a layout file in your theme:

  1. Navegue até a pasta do seu tema: app/design/frontend/[Vendor]/[theme]/
  2. Crie a estrutura de pastas se não existir: Magento_Theme/layout/
  3. Crie ou edite o arquivo default_head_blocks.xml
  4. Adicione o seguinte codigo:
    <?xml version="1.0"?>
    <page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <head>
    <script src="https://asyntai.com/static/js/chat-widget.js" src_type="url" async="true" data-asyntai-id="YOUR_WIDGET_ID"/>
    </head>
    </page>
  5. Substitua YOUR_WIDGET_ID pelo seu ID de widget real
  6. Execute: bin/magento cache:flush
  7. Execute: bin/magento setup:static-content:deploy -f (se estiver em modo de produção)

Alternativa: Usando Bloco CMS

Você também pode criar um bloco CMS e incluí-lo no seu rodapé:

  1. Vá para Content → Blocks
  2. Clique em "Add New Block"
  3. Defina um título como "Asyntai Chatbot"
  4. Defina o Identificador como asyntai_chatbot
  5. In the content editor, switch to HTML mode and paste your embed code
  6. Clique em "Save Block"
  7. Adicione o bloco ao seu template de rodapé usando: {{block id="asyntai_chatbot"}}
  8. Limpe o cache

Passo 3: Verifique a Instalação

Após salvar suas alterações e limpar o cache, visite sua loja 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 limpar todos os caches: System → Cache Management → Flush Magento Cache. Também tente limpar o cache do navegador ou visualizar em uma janela anônima. Se estiver em modo de produção, execute bin/magento setup:static-content:deploy -f.