Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Como Adicionar o Chatbot IA Asyntai ao PrestaShop

Guia passo a passo para sites PrestaShop

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 Módulo de Código Personalizado (Recomendado)

A maneira mais fácil de adicionar o chatbot é usando um módulo gratuito "Custom Code" do marketplace PrestaShop Addons:

  1. Faça login no seu Back Office do PrestaShop
  2. Vá para Modules → Module Manager
  3. Clique em "Upload a module" ou pesquise no marketplace por "Custom Code" ou "Header Footer Scripts"
  4. Install a module like "Custom JS and CSS" or similar
  5. Após instalado, vá para a configuração do módulo
  6. Encontre a seção "Footer Scripts" ou "Before </body>"
  7. Cole seu código de incorporação Asyntai
  8. Clique em "Save"

Dica: Módulos gratuitos populares para essa finalidade incluem "Custom JS and CSS Pro", "Custom Code" e "Header and Footer Scripts". Esses módulos sobrevivem às atualizações de tema e do PrestaShop.

Alternativa: Editar Template do Tema (PrestaShop 1.7+/8)

You can add the code directly to your theme's footer template:

  1. Acesse seus arquivos do PrestaShop via FTP ou gerenciador de arquivos
  2. Navegue até a pasta do seu tema: themes/your_theme/templates/_partials/
  3. Abra o arquivo footer.tpl (ou em alguns temas, verifique templates/layouts/layout-both-columns.tpl)
  4. Encontre a tag de fechamento </body> ou a seção {block name='javascript_bottom'}
  5. Cole seu código de incorporação do Asyntai logo antes da tag de fechamento </body>
  6. Salve o arquivo
  7. Limpe o cache do PrestaShop: Advanced Parameters → Performance → Clear cache

Importante: Alterações nos arquivos do tema podem ser sobrescritas ao atualizar seu tema. Considere usar um tema filho ou um módulo para uma solução mais permanente.

Alternativa: Usando o Arquivo JavaScript Personalizado do Tema

Many PrestaShop themes include a custom.js file for your own scripts:

  1. Navegue até: themes/your_theme/assets/js/
  2. Procure um arquivo chamado custom.js (crie-o se não existir)
  3. Adicione o seguinte código para carregar o chatbot dinamicamente:
    (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);
    })();
  4. Substitua YOUR_WIDGET_ID pelo seu ID de widget real
  5. Limpe o cache do PrestaShop

Alternativa: Criar um Módulo Simples (Para Desenvolvedores)

Para desenvolvedores, você pode criar um módulo simples usando o hook displayFooter:

  1. Crie uma pasta: modules/asyntaichatbot/
  2. Crie asyntaichatbot.php com este código:
    <?php
    class AsyntaiChatbot extends Module {
      public function __construct() {
        $this->name = 'asyntaichatbot';
        $this->version = '1.0.0';
        $this->author = 'Your Name';
        parent::__construct();
        $this->displayName = 'Asyntai Chatbot';
      }
      public function install() {
        return parent::install() && $this->registerHook('displayFooter');
      }
      public function hookDisplayFooter($params) {
        return '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
      }
    }
  3. Substitua YOUR_WIDGET_ID pelo seu ID de widget real
  4. Instale o módulo via Modules → Module Manager

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 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 o cache do PrestaShop: vá para Advanced Parameters → Performance → Clear cache. Também tente limpar o cache do navegador ou visualizar em uma janela anônima. Se estiver usando um módulo personalizado, verifique se está habilitado no Module Manager.