Documentação

Shopify

Adicione seu agente a qualquer loja Shopify colando o código de incorporação no seu tema.

Adicione seu agente de IA a uma loja Shopify colando o código de incorporação no arquivo theme.liquid do seu tema. Funciona com todos os planos do Shopify.

Primeiro, obtenha seu código de incorporação em Chatbot > Publicar no painel.

Método 1: Editar theme.liquid (Recomendado)

Adicione o widget em todo o site editando seu tema publicado:

  1. No admin do Shopify, vá para Loja virtual → Temas.
  2. Na linha do seu tema ativo, clique no menu ... (Ações) → Editar código.
  3. Na pasta Layout à esquerda, abra theme.liquid.
  4. Role até o final e cole seu código de incorporação imediatamente antes da tag de fechamento </body>.
  5. Clique em Salvar.

Exemplo de formato (use os valores reais de Chatbot > Publicar):

<script
  src="YOUR_WIDGET_URL"
  data-chatbot="YOUR_CHATBOT_ID"
  async
></script>

O widget aparece em todas as páginas da loja — produto, coleção, carrinho, início.

Método 2: Duplicar Primeiro, Depois Editar

Se você quiser uma reversão segura:

  1. Loja virtual → Temas.
  2. No seu tema ativo, clique no menu ... (três pontos) → Duplicar. Uma cópia aparece no final da lista de temas.
  3. Edite o theme.liquid da duplicata conforme acima.
  4. Clique no menu ... na duplicata → Visualizar para testar.
  5. Quando estiver satisfeito, clique no menu ... → Publicar para colocá-la no ar.

Método 3: Colar Em Uma Página Específica

Para adicionar o widget apenas a uma página (por exemplo, uma página de suporte):

  1. No admin do Shopify, vá para Loja virtual → Páginas.
  2. Abra a página que você quer editar.
  3. Clique no ícone <> (Show HTML) no editor de conteúdo.
  4. Cole seu código de incorporação no final do conteúdo.
  5. Salvar.

O widget só será carregado nessa página.

Requisitos

  • O tema que você edita deve ser um tema publicado ou pago. O código de temas de teste não pode ser salvo.
  • O domínio da sua loja deve estar na lista de domínios permitidos do seu agente, se você tiver restrições de domínio ativadas.

Depois de Publicar

O Shopify entrega os recursos da loja a partir da sua CDN. As alterações se propagam em um ou dois minutos. Se você não vir o widget:

  1. Force a atualização da página (⌘+Shift+R no Mac, Ctrl+F5 no Windows).
  2. Abra o site em uma janela anônima.
  3. Verifique o console do navegador para erros.

Solução de Problemas

O widget não aparece.

  • Confirme que você editou o tema ativo (ou publicou a duplicata).
  • Confirme que o trecho está antes de </body>, não dentro de <head>.
  • Verifique se o domínio da sua loja está permitido em Chatbot > Publicar > Segurança.

O widget se sobrepõe ao chat ou à gaveta de carrinho do Shopify.

  • Ajuste a posição do widget nas configurações de Design do seu agente.

O widget aparece no editor, mas não na loja ativa.

  • Certifique-se de ter clicado em Salvar depois de colar — o editor de código não salva automaticamente.

Testes

  1. Abra sua loja em uma janela anônima.
  2. Procure o balão de chat no canto.
  3. Clique para abrir e enviar uma mensagem de teste.

Conecte Uma Loja Para Consultas de Pedidos e Pesquisa de Produtos

Incorporar o widget e conectar sua loja são duas coisas separadas. O código de incorporação acima coloca o widget de chat na sua loja. Uma conexão separada com o Shopify — feita na aba Ações → Integrações do seu agente — permite adicionalmente que o agente pesquise seu catálogo em tempo real e consulte o status de um pedido dentro da conversa.

Você pode usar qualquer uma das duas isoladamente. Use apenas a incorporação se o agente deve responder apenas com base no seu conteúdo de treinamento, e adicione a conexão da loja quando quiser dados de produtos e pedidos em tempo real.

Conectar a loja fornece apenas as credenciais, mas não ativa nada por conta própria: depois, adicione as ações Pesquisar produtos e Consultar status do pedido na aba Ações do seu agente e ative cada uma que você quiser que o agente use.

Configurar ações do Shopify →

Próximos Passos