Centro de Ajuda
Integrações do chatbot

Como configurar o ChatLab para a sua loja de e-commerce

Última atualização:

Configurar o ChatLab corretamente é fundamental para garantir que o seu chatbot fornece informações precisas sobre os produtos e atualizações de encomendas em tempo real. Com a configuração adequada, o ChatLab pode responder a perguntas detalhadas sobre produtos, consultar o estado de encomendas e prestar assistência aos clientes 24 horas por dia.

O Que É Importante num Chatbot para E-Commerce

  • Informações precisas sobre os produtos - assegure que os clientes recebem detalhes corretos sobre especificações e ofertas
  • Apresentação clara das ofertas - destaque descontos, pacotes de produtos e promoções de forma eficaz
  • Dados atualizados - forneça preços, níveis de stock e estado das encomendas em tempo real (com a integração ativada)
  • Acompanhamento de encomendas e dados do utilizador - permita que os clientes consultem os detalhes das encomendas e o estado do envio quando integrado

Como Fornecer Informações de Produtos ao ChatLab

Antes de ensinar o ChatLab sobre a sua loja, decida como este irá processar os dados dos produtos:

  • Verificação do Website (Website Scan): O ChatLab rastreia e indexa as páginas dos seus produtos (descrições, especificações e imagens) numa base de conhecimento estática. Ideal para contexto rico e respostas detalhadas quando o catálogo é relativamente estável. Saiba mais: Adicionar Novas Fontes de Website

  • Integração por API: Ligue através das API da Shopify, WooCommerce, PrestaShop ou de outras plataformas para obter dados de produtos em tempo real, preços, níveis de stock e gerir consultas de encomendas no momento. Algumas integrações também suportam a pesquisa de produtos por SKU ou código de referência. Ideal para inventários que mudam frequentemente e gestão de encomendas. Os produtos não são importados para a base de conhecimento estática do ChatLab; em vez disso, o ChatLab consulta dinamicamente a sua plataforma de e-commerce em resposta às perguntas dos utilizadores.

  • Combinar Ambos: Utilize uma verificação para conhecimento contextual aprofundado e mantenha a integração ativa para garantir a máxima precisão e dados atualizados.

Integrações de E-Commerce Disponíveis

Aceda ao seu bot e selecione o separador Connect (Ligar) para ver todas as integrações disponíveis.

Separador Connect mostrando as integrações de e-commerce

O ChatLab suporta as seguintes plataformas de e-commerce:

  • Shopify - pesquisa de produtos (com filtro de stock disponível), acompanhamento de encomendas
  • WooCommerce - pesquisa de produtos por nome ou SKU, navegação por categorias, acompanhamento de encomendas
  • PrestaShop - pesquisa de produtos por nome ou referência/SKU, suporte para variantes, acompanhamento de encomendas
  • Shoper - pesquisa de produtos, acompanhamento de encomendas
  • Wix - pesquisa de produtos, acompanhamento de encomendas
  • CS-Cart - pesquisa de produtos, acompanhamento de encomendas
  • Abicart - pesquisa de artigos, acompanhamento de encomendas
  • Baselinker - gestão de encomendas multiplataforma

O ChatLab também suporta integrações para o setor hoteleiro e reservas:

  • Beds24 - disponibilidade de quartos, detalhes do alojamento, preços
  • Mews - categorias de quartos, pesquisa de disponibilidade, consulta de reservas
  • Hotres - listagens de apartamentos, verificação de disponibilidade
  • IdoBooking - reserva de apartamentos, gestão de reservas
  • NfHotel - disponibilidade e detalhes de apartamentos

Verificação vs. Integração: Qual É a Melhor Opção?

Verificação do Website (Website Scan)

Vantagens:

  • Pesquisa por IA com contexto integral e respostas ricas
  • Compreensão profunda das descrições dos produtos

Desvantagens:

  • Exige novo treino manual ou automático para capturar produtos novos ou atualizados
  • Pode atingir o limite da quota de carateres de treino ao indexar catálogos grandes
  • Potencial interpretação incorreta de especificações detalhadas
  • Pode falhar na extração de informações de tabelas ou listas de parâmetros

Integração por API

Vantagens:

  • Preços e stock sempre atualizados através de chamadas diretas à API
  • Consulta de encomendas em tempo real para verificar estado e histórico
  • Pesquisa por SKU e código de referência disponível para WooCommerce e PrestaShop
  • A Shopify suporta filtragem de artigos em stock para mostrar apenas produtos disponíveis

Desvantagens:

  • Pesquisa baseada em palavras-chave (ou consulta por SKU), sem compreensão contextual profunda
  • Dependente da disponibilidade da API e dos limites de pedidos (rate limits)
  • Exige credenciais e configuração adequadas
  • Modelos de IA mais avançados são fortemente recomendados para uma navegação correta pelas ferramentas

A Fórmula Vencedora: Combinar Verificação e Integração

Ao combinar uma verificação completa do site com uma integração em tempo real, o ChatLab mantém o catálogo de produtos e o estado da loja sincronizados. Os clientes vêem sempre os níveis de stock atuais, preços corretos e descrições detalhadas.

Para obter tanto respostas contextuais aprofundadas como precisão em tempo real, configure o comportamento personalizado do ChatLab em Settings > Role & Behavior (Definições > Função e Comportamento). Clique em Enable custom role and behavior instructions (Ativar instruções personalizadas de função e comportamento) e adicione o seguinte:

Definições de Role & Behavior com o botão de instruções personalizadas destacado

When a user asks about products or categories, first invoke API tools to retrieve current data; fallback to the scanned knowledge base only for contextual enrichment. After fetching live data, augment responses with detailed descriptions and recommendations from the knowledge base when relevant.

Saiba mais sobre a personalização de funções: Definições de Role & Behavior

Utilize Sempre Modelos Mais Avançados

A integração com API exige que o chatbot consiga raciocinar sobre as chamadas de API e os respetivos resultados. Modelos mini (como o GPT-5-mini) têm capacidades limitadas para esta tarefa. Utilize sempre modelos mais avançados (como o GPT-4o ou GPT-4.1) ao integrar com plataformas de e-commerce.

Altere o modelo em Settings > Model & Advanced (Definições > Modelo e Avançado).

Configuração do Prompt Personalizado

Para o WooCommerce

A integração com o WooCommerce dispõe das ferramentas searchProducts, searchCategories e searchProductBySku. Adicione estas instruções em Settings > Role & Behavior:

First, classify the user question into one of:
- PRODUCT-BY-SKU (user provides a SKU, reference number, or product code)
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-BY-SKU:
- Call searchProductBySku with the provided SKU or reference code.
- Return the product details to the user.

If PRODUCT-SPECIFIC:
- Call searchProducts(text) first using normalized English singular lowercase query.
- If results are empty/weak:
  1) Call searchCategories(normalized noun) to choose best categoryId.
  2) Call searchProducts(categoryId) to show a few items as examples.
- Answer using tool results as primary truth (name/price/availability). Use Knowledge Base only to add extra details if consistent.

If ASSORTMENT-OVERVIEW:
- Build the overview primarily from tools, then enrich using Knowledge Base:
  1) Call searchCategories(normalized noun) to find relevant categoryIds.
  2) For up to 3-5 top categories, call searchProducts(categoryId).
  3) Aggregate from tool results; always label as non-exhaustive.
  4) Enrich the overview with Knowledge Base ONLY where it adds coverage the tools may miss.
- If tool results and KB conflict: prefer tool for concrete product facts; prefer KB for store-level statements.

Para a Shopify

A integração com a Shopify inclui a ferramenta searchProducts com a opção de mostrar apenas produtos em stock. Ative a opção "In-stock only" na configuração da ação de pesquisa de produtos da Shopify para filtrar automaticamente os artigos indisponíveis. Adicione estas instruções:

First, classify the user question into one of:
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-SPECIFIC:
- Call searchProducts first using normalized English singular lowercase query.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as primary truth; use Knowledge Base only for relevant extra context.

If ASSORTMENT-OVERVIEW:
- Use Knowledge Base as the primary source.
- Do not rely on searchProducts for full lists; optionally call it only to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Para o PrestaShop

A integração com o PrestaShop suporta as ferramentas searchProducts e searchProductByReference. A pesquisa por referência permite aos clientes encontrar produtos por SKU, código de barras EAN-13, ISBN ou código MPN. Adicione estas instruções:

First, classify the user question into one of:
- PRODUCT-BY-REFERENCE (user provides a SKU, EAN barcode, ISBN, MPN, or reference code)
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-BY-REFERENCE:
- Call searchProductByReference with the provided reference code.
- Return the product details to the user.

If PRODUCT-SPECIFIC:
- Call searchProducts first using normalized English singular lowercase query.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as primary truth; use Knowledge Base only for relevant extra context.

If ASSORTMENT-OVERVIEW:
- Use Knowledge Base as the primary source.
- Do not rely on searchProducts for full lists; optionally call it only to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Para AbiCart, Wix, CS-Cart, Shoper

Estas integrações dispõem da ferramenta searchProducts. Adicione estas instruções:

First, classify the user question into one of:
- PRODUCT-SPECIFIC (variant/price/availability/recommendation)
- ASSORTMENT-OVERVIEW (brands we carry, categories, "do you sell X at all", broad offer)

If PRODUCT-SPECIFIC:
- Call searchProducts first using normalized English singular lowercase query.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as primary truth; use Knowledge Base only for relevant extra context.

If ASSORTMENT-OVERVIEW:
- Use Knowledge Base as the primary source.
- Do not rely on searchProducts for full lists; optionally call it only to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Como Verificar Corretamente o Seu Website de E-Commerce

Planeie a verificação do seu website em partes em vez de fazer tudo de uma só vez para ter um melhor controlo. A verificação possui dois níveis de filtragem: filtragem de URL (quais as páginas que entram no treino) e filtragem de elementos (quais as partes de cada página que se tornam conteúdo). A lista de verificação abaixo abrange o essencial.

  1. Defina o âmbito adequado da verificação - utilize o filtro de exclusão de URL:

    • Inclua apenas URL de páginas de produtos e categorias (por exemplo, /products/ e /collections/)
    • Exclua caminhos de baixo valor, como /blog/, /tags/ e páginas de arquivo
    • Para lojas multilingues, restrinja a verificação ao idioma principal
  2. Exclua elementos repetitivos - utilize o filtro HTML Element Exclusion para cabeçalho, rodapé e barra lateral

  3. Inclua apenas conteúdo relevante - utilize CSS Selector Inclusion para focar nas descrições e especificações dos produtos, excluindo avaliações, classificações e secções de produtos semelhantes

  4. Utilize o Sitemap se disponível - ajuda a identificar todas as páginas de produtos e categorias de forma mais eficiente do que o rastreio simples

Para consultar o método completo - ambos os níveis de filtragem explicados em detalhe, a divisão recomendada em treinos separados de informação e de produtos, e seletores de elementos prontos a usar para WooCommerce, Shopify, PrestaShop, Magento, Shoper, CS-Cart e mais - consulte Treinar um bot numa loja de e-commerce sem integração. É especialmente útil quando não pode (ou não pretende) ativar uma integração.

Saiba mais sobre como otimizar a verificação do seu website: Como Reduzir os Carateres de Treino ao Verificar um Website

Funcionalidades Adicionais Que Vale a Pena Ativar

Offer Cards

Ative esta definição em Settings > Model & Advanced para permitir que o chatbot apresente cartões de produtos com nomes, imagens e preços. Isto melhora a apresentação visual, especialmente com consultas de API em tempo real.

Definições de Model & Advanced com a opção Offer Cards destacada

Adicione o seguinte às suas instruções personalizadas para evitar links duplicados:

If knowledge base provides URLs of the source information, provide them as comma separated list in the response as a reference - only after you have answered user's question in the conversation and only if the links are not included in the product list

Saiba mais: Offer Cards

Perguntas Sugeridas (Suggested Questions)

Pré-configure botões de resposta rápida (envio, devoluções, horário de funcionamento) em Settings > Conversation (Definições > Conversação). Ative dynamic suggested follow-ups (perguntas de seguimento sugeridas dinâmicas) para obter sugestões geradas por IA.

Saiba mais: Perguntas de Seguimento Sugeridas Dinâmicas

Transmissão para Assistente Humano (Human Hand-off)

Ative o formulário Contact Human (Contactar Humano) e forneça o seu e-mail de suporte para encaminhamento de situações complexas.

Saiba mais: Formulário de Contacto com o Suporte Humano

Resumos da Conversa e do Cliente

Quando ativado, o ChatLab gera automaticamente um resumo para cada conversa e mantém um perfil de resumo atualizado para clientes que regressam.

Saiba mais: Resumos do Chatbot e Memória

Chat Frontend API

Transmita informações sobre o utilizador com sessão iniciada (por exemplo, ID de utilizador, e-mail ou token de segurança) para permitir que o chatbot aceda em segurança ao histórico de encomendas sem exigir nova introdução de dados.

Saiba mais: Chat API

Configuração do Idioma

O ChatLab suporta mais de 90 idiomas. Saiba mais: Configuração do Idioma do Chatbot

Ao utilizar a integração com a Shopify, WooCommerce ou outras plataformas de e-commerce, tenha em conta o idioma em que o seu sistema devolve os produtos. Adicione esta instrução às suas definições de Role & Behavior:

When searching for products use [shop language] product and category names in singular form.

Monitorizar e Iterar Diariamente

Para garantir que o ChatLab se mantém preciso e eficaz:

  • Analise os registos de conversação regularmente. Ajuste as respostas ou adicione conteúdo nos pontos em que o bot hesita. Saiba mais: Registos de Conversação
  • Ative o AI Conversation Insights para identificar padrões e problemas. Saiba mais: AI Conversation Insights
  • Aproveite o relatório automatizado Daily Activity Report. Saiba mais: E-mail de Resumo Diário

Otimizar as Respostas do Chatbot

Mesmo os chatbots bem configurados beneficiam de ajustes regulares. Analise os registos de conversação para identificar pontos fracos, perguntas mal interpretadas ou respostas alternativas repetitivas. Aperfeiçoe os prompts, atualize o material de treino e experimente diferentes instruções de sistema.

Saiba mais: Como Melhorar as Respostas do Chatbot