Como Adicionar o Chatbot IA Asyntai ao OpenCart

Guia passo a passo para sites OpenCart

Plataforma:

The Easy Way: Install the Asyntai Extension

We publish a free extension on the OpenCart Marketplace. It puts the chatbot on your storefront and connects your account, and there is no code to copy and no template to edit. It works on OpenCart 3.x and 4.x.

Download Asyntai - AI Chatbot from the OpenCart Marketplace
In your admin panel, go to Extensions → Installer and upload the ZIP file
Go to Extensions → Extensions, choose Modules in the list, find Asyntai AI Chatbot and press the green install button
Press edit, then press Connect to Asyntai. A window opens where you sign in or create an account.

That is all. The chatbot is live on your storefront when the window closes.

Your products, prices and stock

When you connect, the extension also lets Asyntai read your catalogue. Your assistant then answers with the price you charge today and tells shoppers what is in stock, instead of repeating whatever your pages said when they were last read.

Asyntai reads your products through a read-only address on your own store. Every request is signed, and the reply carries the prices a shopper would actually pay, with your tax rules already applied. You can switch this off at any time on the extension's settings screen.

Updating from version 1.0.0? OpenCart clears a module's settings when you uninstall it, so press Connect to Asyntai once after the update. From this version on, updates keep your connection.

Or Add the Code Yourself

Prefer not to install an extension? The rest of this page shows how to add the chatbot by hand. You will not get the catalogue reading this way.

Passo 1: Obtenha Seu Código de Incorporação

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</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.

Step 2: Edit Footer Template

A maneira mais direta de adicionar o chatbot é editando o template de rodapé do seu tema:

Acesse seus arquivos do OpenCart via FTP ou gerenciador de arquivos
Navegue até o template de rodapé do seu tema:
- OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
- OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
Abra o arquivo de rodapé para edição
Encontre a tag de fechamento </body>
Cole seu código de incorporação Asyntai logo antes da tag </body>
Salve o arquivo
Limpe o cache do OpenCart: Dashboard → Ícone de engrenagem azul (canto superior direito) → Refresh ou exclua o conteúdo de system/storage/cache/

Dica: Se você está usando o tema padrão, o caminho seria catalog/view/theme/default/template/common/footer.twig. Sempre crie um backup antes de editar arquivos de template.

Alternativa: Usando a Opção de Código Personalizado do Tema

Muitos temas modernos do OpenCart incluem uma opção integrada para código personalizado:

Faça login no seu Painel Admin do OpenCart
Vá para Extensions → Themes (ou Extensions → Extensions → Themes)
Clique em Edit no seu tema ativo
Procure por uma seção "Custom Code", "Footer Scripts" ou "Custom JavaScript"
Cole seu código de incorporação Asyntai
Clique em "Save"
Limpe o cache

Nota: Nem todos os temas possuem esta opção. Se o seu tema não inclui campos de código personalizado, use o método de edição de template ou instale uma extensão.

Alternativa: Usando uma Extensão de Código Personalizado

Você pode instalar uma extensão gratuita do OpenCart Marketplace para adicionar scripts personalizados:

Go to the OpenCart Marketplace
Pesquise por "Custom Script", "Header Footer Scripts" ou "Custom Code"
Baixe e instale uma extensão adequada
No seu painel admin, vá para Extensions → Extensions → Modules
Encontre e instale o módulo de código personalizado
Configure o módulo e cole seu código de incorporação Asyntai na seção de rodapé
Salve e limpe o cache

Importante: Usar extensões é recomendado em vez de editar arquivos do núcleo, pois elas sobrevivem às atualizações do OpenCart. Extensões populares incluem "Custom Script in Header & Footer" disponível no marketplace.

Alternativa: Usando o Método addScript (Para Desenvolvedores)

Para desenvolvedores, o OpenCart 3.x/4.x oferece uma forma programática de adicionar scripts:

Abra catalog/controller/common/footer.php
Adicione a seguinte linha antes de $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Para o atributo data, você precisará modificar o footer.twig para incluí-lo manualmente, ou adicionar JavaScript inline após o loop de scripts

Nota: Para que o widget funcione corretamente com o atributo data, o método de template é mais simples, pois o método addScript não suporta atributos personalizados diretamente.

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 OpenCart. Vá ao seu painel admin, clique no ícone de engrenagem azul no canto superior direito e clique nos botões de atualização. Também tente limpar o cache do navegador ou visualizar em uma janela anônima. Se você modificou o arquivo de template errado, verifique se seu tema está usando o arquivo que você editou.

Documentação