Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Como Adicionar o Chatbot IA Asyntai ao BigCommerce

Guia passo a passo para lojas BigCommerce

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: Escolha o Método de Instalação

Existem várias maneiras de adicionar o widget de chat ao BigCommerce. Escolha o método que funciona melhor para você:

Método 1: Usando o Script Manager (Recomendado)

O Script Manager é a maneira mais fácil e recomendada de adicionar scripts personalizados à sua loja BigCommerce. Não requer nenhum conhecimento de programação e persiste entre mudanças de tema.

  1. Faça login no seu BigCommerce Control Panel
  2. Acesse Storefront → Script Manager
  3. Clique no botão "Create a Script"
  4. Configure seu script com estas definições:
    • Nome: Asyntai AI Chatbot
    • Descrição: Widget de chat com IA (opcional)
    • Posicionamento: Footer
    • Localização: All Pages
    • Categoria do Script: Functional
    • Tipo de Script: Script
  5. Na caixa "Script Contents", cole seu código de incorporação Asyntai
  6. Clique em "Save"

Por que usar o Script Manager? Scripts adicionados pelo Script Manager são gerenciados separadamente do seu tema. Eles não serão afetados quando você atualizar ou alterar o tema da sua loja.

Método 2: Usando o Page Builder

Você pode usar o Page Builder do BigCommerce para adicionar o widget de chat usando um elemento HTML. Este método é útil se você deseja mais controle sobre onde o widget aparece.

  1. Faça login no seu BigCommerce Control Panel
  2. Acesse Storefront → My Themes
  3. Clique no botão "Customize" no seu tema ativo
  4. Na barra lateral esquerda do Page Builder, encontre o elemento "HTML"
  5. Arraste e solte o elemento HTML na área de rodapé do seu template de página
  6. Clique no elemento HTML e selecione "Edit HTML"
  7. Cole seu código de incorporação Asyntai
  8. Clique em "Save HTML"
  9. Click "Publish" to apply changes to your live store

Nota: Se você deseja o chatbot em todas as páginas, precisará adicioná-lo a uma região global como o rodapé. O método Script Manager é mais fácil para instalação em todo o site.

Método 3: Editar Arquivos do Tema (Temas Stencil)

Para desenvolvedores que usam temas Stencil, você pode adicionar o código diretamente aos arquivos do tema. Isso requer acesso aos arquivos-fonte do seu tema.

Usando o BigCommerce Control Panel

  1. Acesse Storefront → My Themes
  2. Clique em "Advanced" no seu tema ativo
  3. Selecione "Edit Theme Files"
  4. Navegue até templates → components → common
  5. Abra footer.html
  6. Role até o final do arquivo
  7. Paste your Asyntai embed code just before the closing tag
  8. Clique em "Save & Apply File"

Usando o Stencil CLI (Desenvolvimento Local)

Se você está desenvolvendo localmente com o Stencil CLI:

  1. Abra os arquivos locais do seu tema
  2. Navegue até templates/components/common/footer.html
  3. Add your Asyntai embed code before the closing tags
  4. Envie suas alterações usando stencil push

Importante: As alterações nos arquivos do tema podem ser sobrescritas quando você atualizar seu tema. Para uma solução permanente que persiste entre atualizações de tema, use o método Script Manager.

Passo 3: Verifique a Instalação

Após adicionar o código, visite sua loja BigCommerce em uma nova aba do navegador ou janela anônima. Você deverá ver o botão do widget de chat no canto inferior direito da sua loja. Clique nele para confirmar que abre e funciona corretamente.

Não está vendo o widget? Limpe o cache do navegador e tente novamente. Se você fez alterações pelo Theme Editor, certifique-se de ter clicado em "Publish" para aplicar as alterações à sua loja ativa.