Shopify

Importante: A integração do Shopify permite incorporar um funcionário de IA em sua loja do Shopify para atender às dúvidas dos clientes, fornecer recomendações de produtos, auxiliar nos pedidos e melhorar a experiência de compra.

​

🔢 Índice

1. Overview
2. Prerequisites
3. Installation Steps
4. Configuring Your AI Employee
5. Customization Options
6. Common Use Cases
7. Troubleshooting
8. Best Practices

​

1. Visão geral

​

O que esta integração faz

• Tire dúvidas sobre produtos
• Obtenha informações de tamanho e especificação
• Acompanhar o status do pedido
• Solicitar devoluções ou trocas
• Obtenha recomendações de compras
• Receba suporte instantâneo 24 horas por dia, 7 dias por semana

​

Principais recursos

• Instalação fácil: Adicione com uma tag de script simples
• Widget personalizável: combine com a marca da sua loja
• Mobile Responsive: Funciona em todos os dispositivos
• Conhecimento do produto: conecte datastores com informações do produto
• Integração de pedidos: pode ser integrado com APIs do Shopify (via ferramenta HTTP)
• Captura de leads: Colete informações do cliente
• Multilíngue: Suporte a vários idiomas

​

Requisitos Técnicos

• Loja Shopify ativa (qualquer plano)
• Acesso ao editor de código do tema
• Funcionário ZappWay AI criado e configurado
• Familiaridade básica com HTML (útil, mas não obrigatório)

​

2. Pré-requisitos

​

Antes de começar

1. Acesse Funcionários de IA
2. Clique em “Criar funcionário de IA”
3. Defina configurações e instruções
4. Consulte o Guia do Funcionário de IA para obter detalhes

• Descrições dos produtos
• Guias de dimensionamento
• Políticas de envio
• Políticas de devolução
• Perguntas frequentes

1. Open AI Employee settings
2. Go to Tools tab
3. Add Datastore Tool
4. Select your product datastore
5. Save configuration

1. Open your AI Employee in the dashboard
2. Copy the Agent ID from the URL or settings
3. Keep this handy for installation

​

3. Etapas de instalação

​

Etapa 1: Acesse o Editor de Código do Tema

1. Log in to your Shopify Admin dashboard
2. Navigate to Online Store → Themes
3. Find your current active theme
4. Click Actions → Edit code

​

Etapa 2: Copiar script de integração

  import Chatbox from 'https://cdn.jsdelivr.net/npm/@zappway/embeds@latest/dist/chatbox/index.js';

  Chatbox.initBubble({
    agentId: 'YOUR_AGENT_ID',
  })

  import Chatbox from 'https://cdn.jsdelivr.net/npm/@zappway/embeds@latest/dist/chatbox/index.js';

  Chatbox.initBubble({
    agentId: 'clf1a2b3c4d5e6f7g8h9',
  })

​

Etapa 3: Inserir script no tema

1. In the theme code editor, locate the theme.liquid file in the Layout folder
2. Find the closing </head> tag (usually near the top of the file)
3. Paste the script above the </head> tag
4. Click Save in the top-right corner

​

Etapa 4: Verifique a instalação

1. Visit your Shopify store in a new browser tab
2. Look for the chat bubble in the bottom-right corner
3. Click the bubble to open the chat widget
4. Send a test message to your AI Employee
5. Verify responses are working correctly

​

4. Configurando seu funcionário de IA

​

Instruções recomendadas para Shopify

You are a helpful customer service assistant for [Your Store Name].
Your goal is to help customers find products, answer questions, and provide excellent shopping support.

PERSONALITY:
- Friendly, enthusiastic, and helpful
- Product-focused and solution-oriented
- Patient with customer questions

CAPABILITIES:
- Answer product questions (features, sizing, materials)
- Provide shopping recommendations
- Help with order tracking
- Explain shipping and return policies
- Assist with account issues
- Offer promotions and discounts when available

PROCESS:
1. Greet customers warmly
2. Understand what they're looking for
3. Search product knowledge base
4. Provide helpful, accurate information
5. Suggest related products when appropriate
6. Ask if they need anything else

PRODUCT RECOMMENDATIONS:
When recommending products:
- Ask about customer preferences and needs
- Suggest 2-3 specific products with details
- Mention key features and benefits
- Include pricing information
- Provide direct product links when possible

WHEN TO ESCALATE:
- Order cancellations or modifications
- Payment issues
- Damaged or defective products
- Complex technical problems
- Custom or bulk orders

Always be enthusiastic about our products and help customers have a great shopping experience!

​

Conectando dados do produto

1. Go to Datastores
2. Click “Create Datastore”
3. Name it “Product Catalog” or similar
4. Add datasources:
   • Product descriptions (copy from Shopify product pages)
   • Sizing guides (PDF or text)
   • Shipping policy
   • Return policy
   • FAQs

1. Open AI Employee → Tools tab
2. Add Datastore Tool
3. Select “Product Catalog” datastore
4. Save

​

Opcional: integração de rastreamento de pedidos

1. Add HTTP Tool to AI Employee
2. Configure endpoint: https://your-store.myshopify.com/admin/api/2024-01/orders.json
3. Add authentication (Shopify API key)
4. Update instructions to mention order tracking capability

​

5. Opções de personalização

​

Aparência do widget

​

Mostrar em páginas específicas

  import Chatbox from 'https://cdn.jsdelivr.net/npm/@zappway/embeds@latest/dist/chatbox/index.js';

  // Only show on product pages
  if (window.location.pathname.includes('/products/')) {
    Chatbox.initBubble({
      agentId: 'YOUR_AGENT_ID',
    });
  }

• Páginas de produtos: /products/
• Páginas de coleção: /collections/
• Página do carrinho: /cart
• Finalização da compra: /checkout
• Todas as páginas: (sem condição)

​

Ocultar no celular

  import Chatbox from 'https://cdn.jsdelivr.net/npm/@zappway/embeds@latest/dist/chatbox/index.js';

  // Only show on desktop
  if (window.innerWidth > 768) {
    Chatbox.initBubble({
      agentId: 'YOUR_AGENT_ID',
    });
  }

​

6. Casos de uso comuns

​

Recomendações de produtos

I'd love to help you find the perfect gift! 
To give you the best recommendations, could you tell me:

1. What are her interests or hobbies?
2. What's your budget range?
3. Are you looking for something specific (jewelry, clothing, accessories)?

• Armazenamento de dados do produto com descrições detalhadas
• Instruções para fazer perguntas de qualificação
• Conhecimento de categorias de produtos

​

Acompanhamento de pedidos

I'll look up your order for you!
[Uses HTTP Tool to query Shopify API]

Your order #12345 was shipped on January 10th via USPS.
Tracking number: 9400111899223344556677
Expected delivery: January 15th

You can track it here: [tracking link]

• Ferramenta HTTP configurada com API Shopify
• Credenciais API com permissão de leitura de pedido
• Instruções para lidar com consultas de pedidos

​

Assistência de dimensionamento

Great choice! To help you find the perfect fit, 
could you share your usual shirt size (S, M, L, XL)?

Our Classic T-Shirt runs true to size. Here's our sizing guide:
- Small: Chest 34-36", Length 28"
- Medium: Chest 38-40", Length 29"
- Large: Chest 42-44", Length 30"
- X-Large: Chest 46-48", Length 31"

Would you like me to recommend a size based on your measurements?

• Guia de dimensionamento carregado no armazenamento de dados
• Instruções para fazer perguntas esclarecedoras
• Informações de tamanho específicas do produto

​

Devoluções e Trocas

I'm sorry to hear that! I can help you with the return process.

Our return policy:
- 30-day return window from delivery date
- Items must be unworn and in original packaging
- Free return shipping

To start your return:
1. What's your order number?
2. Which item(s) would you like to return?
3. Reason for return? (helps us improve)

I'll generate a prepaid return label for you!

• Política de devolução no armazenamento de dados
• Ferramenta de formulário para coletar detalhes de devolução
• Instruções para processo de devolução

​

Recuperação de carrinho abandonado

Hi! I noticed you have some items in your cart. 
Is there anything I can help you with to complete your purchase?

- Questions about the products?
- Need help with sizing?
- Looking for a promo code?
- Issues at checkout?

I'm here to help! 🛍️

• Gatilho de mensagem proativa (implementação personalizada)
• Instruções para recuperação do carrinho
• Conhecimento das promoções atuais

​

7. Solução de problemas

​

Balão de bate-papo não aparece

1. Verify Agent ID is correct:
   • Check for typos in the script
   • Ensure Agent ID matches your dashboard
2. Check script placement:
   • Must be before </head> tag
   • Not inside any other script tags
   • Saved correctly in theme.liquid
3. Clear browser cache:
   • Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
   • Try incognito/private browsing mode
4. Check browser console for errors:
   • Open DevTools (F12)
   • Go to Console tab
   • Look for error messages
   • Common error: “Failed to load module”
5. Verify theme file:
   • Ensure you edited the active theme
   • Check that changes were saved
   • Preview theme before publishing

​

IA não responde

1. Test AI Employee directly:
   • Go to AI Employee in ZappWay dashboard
   • Use test chat interface
   • If it works there, issue is with integration
2. Check AI Employee status:
   • Ensure AI Employee is not disabled
   • Verify instructions are configured
   • Check that datastores are connected
3. Review rate limits:
   • Check if rate limits are exceeded
   • See Rate Limit Guide
4. Check datastore status:
   • Ensure datastores are processed (not “Processing”)
   • Verify content is indexed

​

Problemas de estilo de widget

1. Customize colors:

   theme: {
     primaryColor: '#YOUR_BRAND_COLOR',
   }

2. Adjust position:

   theme: {
     position: 'left',  // or 'right'
     bottom: 30,
     left: 30,
   }

3. Change widget size:

   window: {
     height: 700,
     width: 450,
   }

​

Script carregando lentamente

• Atraso no carregamento do CDN (raro)
• Conexão de rede lenta
• Bloqueio de outros scripts

1. Use async loading:

   
     import Chatbox from 'https://cdn.jsdelivr.net/npm/@zappway/embeds@latest/dist/chatbox/index.js';
     Chatbox.initBubble({ agentId: 'YOUR_AGENT_ID' });
   

2. Self-host the script (advanced):
   • Download library from CDN
   • Upload to Shopify theme assets
   • Update script src to point to local file

​

8. Melhores práticas

​

Estratégia de Conteúdo

• Atualizar o armazenamento de dados quando os produtos mudam
• Incluir informações sazonais do produto
• Adicione novos produtos ao armazenamento de dados imediatamente
• Remover produtos descontinuados

• Informações de preços desatualizadas
• Produtos que não estão mais em estoque
• Descrições de produtos inconsistentes

• Descrições detalhadas dos produtos
• Materiais e especificações
• Instruções de cuidados
• Gráficos de dimensionamento (com medidas)
• Opções e variações de cores
• Casos de uso e benefícios do produto
• Avaliações e depoimentos de clientes
• Comparação com produtos similares

​

Configuração de funcionário de IA

If customers seem unsure, offer to:
- Show bestsellers or new arrivals
- Suggest products based on season
- Offer category-specific recommendations
- Mention current sales or promotions

When discussing pricing:
- Mention current prices accurately
- Highlight any active discounts
- Compare value vs similar products
- Explain what's included (free shipping, warranty, etc.)
- Offer payment plan options if available

For each recommended product, provide:
- Product name
- Key features (2-3 bullet points)
- Price
- Direct link: [View Product](https://your-store.com/products/product-name)

​

Experiência do Cliente

• A IA deve responder dentro de 2 a 3 segundos
• Se o processamento for mais longo (por exemplo, chamadas de API), mostre o indicador de digitação
• Fornece atualizações de status para consultas complexas

Good afternoon. I'm delighted to assist you in finding 
the perfect piece from our collection. How may I be of service today?

Hey there! 👋 Ready to find something awesome? 
I'm here to help you discover your next favorite thing!

Welcome! I can help you find the right product based on your 
specific requirements. What are you looking for today?

​

Análise e Melhoria

• Perguntas mais comuns dos clientes
• Produtos frequentemente questionados
• Pontos de abandono nas conversas
• Perguntas que a IA não conseguiu responder

• Verifique os registros de conversas
• Identificar lacunas de conhecimento
• Atualizar armazenamento de dados com informações ausentes

• Analisar as principais consultas de produtos
• Atualizar instruções de IA com base em tendências
• Adicionar novas perguntas frequentes ao armazenamento de dados

• Grande revisão da base de conhecimento
• Revise e refine a personalidade da IA
• Teste A/B diferentes abordagens

​

Segurança

• Não armazene informações de pagamento no chat
• Não peça dados sensíveis (senhas, números completos de cartões)
• Cumpra os regulamentos de privacidade (GDPR, CCPA)
• Use apenas conexões seguras (HTTPS)

​

📞 Suporte e Recursos

​

Obtendo ajuda

• Botão de ajuda no painel do ZappWay
• Chat ao vivo (disponível nos planos Pro+)

• Documentação do tema Shopify
• Linguagem de modelo líquido

• Guia do funcionário de IA
• Configuração do armazenamento de dados
• Personalização de widget

​

Opinião

• E-mail: support@zappway.ai
• Incluir:
  • URL da loja Shopify
  • ID do agente
  • Capturas de tela do problema
  • Erros no console do navegador (se houver)

​

✅ Referência rápida

​

Lista de verificação de instalação

✓ AI Employee created and configured
✓ Product datastore created and populated
✓ Datastore connected to AI Employee
✓ Agent ID copied
✓ Script added to theme.liquid (before </head>)
✓ Theme saved
✓ Store tested in browser
✓ Chat bubble appears correctly
✓ Test conversation completed
✓ Responses are accurate

​

Modelo de roteiro

  import Chatbox from 'https://cdn.jsdelivr.net/npm/@zappway/embeds@latest/dist/chatbox/index.js';

  Chatbox.initBubble({
    agentId: 'YOUR_AGENT_ID',
    theme: {
      primaryColor: '#4F46E5',
      position: 'right',
    },
    window: {
      title: 'Shopping Assistant',
      welcomeMessage: 'Hi! How can I help you today?',
    },
  })

​

Personalizações comuns

theme: { position: 'left', left: 20 }

if (window.location.pathname.includes('/products/')) {
  Chatbox.initBubble({ agentId: 'YOUR_AGENT_ID' });
}

if (window.innerWidth > 768) {
  Chatbox.initBubble({ agentId: 'YOUR_AGENT_ID' });
}