Como criar um Chatbot de IA FlowHunt para Shopify

Este guia mostra como conectar o FlowHunt à sua loja Shopify, adicionar um fluxo de chatbot Shopify pré-criado, publicá-lo e incorporar o chatbot na sua vitrine.

Pré-requisitos

• Uma loja Shopify com acesso de administrador
• Uma conta FlowHunt com acesso ao workspace: https://app.flowhunt.io/
• Importante: Utilize o mesmo e-mail da sua conta FlowHunt e da sua conta de administrador Shopify.

1) Integre o Shopify com o FlowHunt (via Shopify App Store)

1. Abra a Shopify App Store e pesquise por “FlowHunt”.
2. Clique em Instalar e, se solicitado, selecione a loja correta.
3. Revise as permissões solicitadas e clique em Instalar app / Autorizar.

Após a instalação, você será redirecionado para o Shopify e/ou FlowHunt. A conexão é criada através do fluxo de instalação do marketplace.

2) Instale o aplicativo FlowHunt em sua loja Shopify

1. Na tela de autorização do Shopify, revise as permissões solicitadas.
2. Clique em Instalar app para concluir a instalação.

3) Confirme se a integração com o Shopify está ativada

Após a instalação bem-sucedida, retorne ao FlowHunt → Integrações. Você deve ver o Shopify marcado como Conectado/Ativado.

Se não estiver ativado, clique em Conectar novamente e siga o fluxo de autorização.

4) Adicione um chatbot Shopify da Flow Library

1. No FlowHunt, vá para Flow Library.
2. Pesquise por “Shopify Chatbot”.
3. Abra o template e clique em Adicionar ao Workspace.

Isso adicionará um fluxo de chatbot Shopify pronto para uso ao seu workspace.

5) Personalize o chatbot para sua marca

Abra o fluxo que você acabou de adicionar e ajuste:

• Prompt do sistema e tom: Defina a voz e os limites da sua marca.
• Fontes de conhecimento: Conecte seu catálogo de produtos, FAQ, políticas ou outros documentos.
• Ferramentas e ações: Opcionalmente, habilite consulta de pedidos, verificação de status ou atualizações em CRM, se seu plano e configuração permitirem.
• UI/branding: Configure o nome do widget, saudações e rótulos visíveis posteriormente na seção Chatbots.

Ao finalizar, Salve suas alterações.

6) Publique o fluxo

Clique em Publicar no fluxo para que fique disponível para ser usado por um chatbot em seu site/vitrine.

7) Crie um novo Código de Integração (Chatbot)

1. Vá para Chatbots no FlowHunt.
2. Clique em Novo Código de Integração.
3. Selecione o fluxo publicado que você criou acima.
4. Configure as opções do widget (tema, posição, comportamento de abertura, idioma, lista de domínios permitidos, etc.).
5. Salve. O FlowHunt irá gerar um snippet de script (seu Código de Integração).

Guarde este snippet—você irá colá-lo em seu tema Shopify no próximo passo.

8) Incorpore o chatbot na sua vitrine Shopify

Você pode adicionar o Código de Integração de duas formas. Escolha a opção que melhor se adapta às suas necessidades.

Opção A — Adicionar ao theme.liquid (site inteiro)

Este método adiciona o chatbot em todas as páginas da sua loja. Siga estes passos detalhados:

Passo 1: Acesse o admin do Shopify e vá para Loja Virtual > Temas

Passo 2: Clique no botão Personalizar ao lado do seu tema ativo Passo 3: Clique nos 3 pontos (⋯) no canto superior esquerdo e selecione Editar código

Passo 4: Localize o arquivo theme.liquid na pasta Layout (/layout/theme.liquid)

Passo 5: Adicione o Código de Integração logo antes da tag de fechamento </body> Passo 6: Salve suas alterações pressionando Ctrl + S (ou Cmd + S no Mac)

Após salvar, visite sua vitrine e atualize a página. O chatbot deve aparecer em todas as páginas.

Notas importantes:

• Colar antes de </body> garante que o widget carregue em todas as páginas
• Mantenha o snippet do FlowHunt intacto e sem modificações
• O chatbot aparecerá em todas as páginas da sua loja

Opção B — Adicionar via seção Custom Liquid (páginas específicas)

Este método permite exibir o chatbot apenas em páginas ou templates específicos. Perfeito se você quiser o chatbot apenas em páginas de produto ou landing pages específicas.

Passo 1: Vá em Loja Virtual > Temas e clique em Personalizar ao lado do seu tema ativo

Passo 2: Navegue até o template específico que deseja adicionar o chatbot (ex: páginas de produto, páginas de coleção ou uma página específica)

Passo 3: Clique em Adicionar seção ou Adicionar bloco (dependendo do tema) Passo 4: Procure e selecione Custom Liquid entre as opções disponíveis Passo 5: Cole seu Código de Integração FlowHunt na área de conteúdo do Custom Liquid

Passo 6: Clique em Salvar e depois em Visualizar para testar o chatbot naquele template específico

Notas importantes:

• Este método permite controle preciso de onde o chatbot aparece
• Você precisará repetir esses passos para cada template onde quiser o chatbot
• Ótimo para testar o chatbot em páginas específicas antes de liberar para o site inteiro
• O chatbot aparecerá apenas nos templates que você configurar

Verificação e testes

• Abra sua vitrine em uma janela anônima/privada para evitar ativos em cache.
• Faça perguntas comuns (envio, devoluções, disponibilidade de produtos) para validar o fluxo.
• Revise o registro de conversas no FlowHunt (habilite Verbose se necessário) para ver quais documentos ou ferramentas foram utilizados.

Solução de problemas

• Chatbot não aparece: Certifique-se de que o Código de Integração está incluído na página, seu tema está publicado e o domínio está permitido nas configurações de Chatbots.
• Widgets duplicados: Remova snippets duplicados e mantenha somente um Código de Integração ativo.
• Respostas ausentes: Verifique as Fontes de Conhecimento e configurações do Document Retriever no seu fluxo, depois publique novamente.
• Erro de permissões do Shopify: Reconecte o Shopify em FlowHunt → Integrações e reinstale se solicitado.