Como configurar o ChatLab para a sua loja de e-commerce: AI Search, pesquisa em tempo real na loja ou páginas analisadas

Um chatbot para loja é útil quando encontra o produto certo, mostra o preço atualizado e consegue informar o cliente sobre o estado da sua encomenda. Este guia explica todo o processo de configuração. A decisão principal prende-se com a forma como o chatbot localiza os produtos, existindo três opções:

• Opção A: AI Search (recomendada) - o ChatLab mantém o seu próprio índice do catálogo e o chatbot pesquisa nele por significado.

• Opção B: pesquisa direta na loja - o chatbot envia a expressão do cliente para o motor de pesquisa da própria loja através da API da loja. Nada fica indexado.

• Opção C: treino através de páginas verificadas da loja (possível, mas não recomendado para produtos) - o ChatLab analisa e lê as páginas de produtos para a base de conhecimento de treino. Funciona em qualquer plano e com qualquer site, mas os preços e o stock ficam desatualizados entre verificações.

O chatbot utiliza o AI Search ou a pesquisa direta na loja para produtos, nunca ambos. Quando o AI Search está ativo, substitui a pesquisa direta na loja. As páginas verificadas podem funcionar em conjunto com qualquer uma das opções e são a fonte indicada para conteúdos informativos, como entregas, devoluções e FAQ.

Antes de começar

Crie e treine o seu chatbot antes de o disponibilizar aos clientes. Para a instalação, também precisa de permissões para editar e publicar o website. Consulte Como criar o seu primeiro chatbot.

O Que É Importante num Chatbot para E-Commerce

Comece pela experiência do cliente que pretende apoiar. A descoberta de produtos, as ações no carrinho e a consulta de encomendas são capacidades distintas com requisitos diferentes.

Ajudar o cliente a encontrar um produto

Consulte AI Search para saber como o catálogo é indexado e pesquisado, e Offer Cards para os resultados visuais.

Ajudar o cliente a adicionar um produto selecionado

Isto requer uma integração suportada e a configuração da montra da loja, não apenas um cartão de produto. Leia Adicionar produtos ao carrinho e teste o carrinho real da loja antes de ativar a funcionalidade para os clientes.

Ajudar o cliente a acompanhar uma encomenda existente

Leia Verificar o estado da encomenda para conhecer os requisitos de consulta, considerações de privacidade e consultas sem sucesso. Os detalhes da encomenda não permitem, por si só, efetuar reembolsos ou alterações à encomenda.

Três Formas de o Chatbot Encontrar Produtos: AI Search, Pesquisa Direta na Loja ou Páginas Verificadas

1. AI Search (recomendado)

• O ChatLab mantém o seu próprio índice do catálogo da loja, separado da base de conhecimento de treino. Não consome carateres de treino.
• Indexado por produto: nome, descrição, categorias, palavras-chave e etiquetas, atributos (por exemplo, cor, tamanho, marca), códigos de produto (SKU, EAN, código de barras), preço, URL e imagem.
• O cliente pergunta em linguagem natural, por exemplo "um vestido vermelho abaixo de 300". O chatbot pesquisa pelo significado, não pela frase exata. O intervalo de preços é aplicado como um filtro estrito, e os códigos de produto exatos também são correspondidos.
• Preço, stock e variantes são lidos em tempo real a partir da loja no momento da resposta, para que o cliente veja dados atualizados mesmo entre atualizações do índice.
• Funciona com Shopify, WooCommerce, PrestaShop, Shoper, CS-Cart, Ecwid, um feed de produtos XML (formato Google Merchant) e um ficheiro de produtos XLSX ou CSV carregado.

Plano necessário: incluído em todos os planos E-commerce (Free 100 produtos, Start 2.000, Grow 5.000, Scale 20.000). Num plano Universal, adicione o extra de integrações de E-commerce (30 $ por mês) para ligar a loja, mais um pacote de produtos AI Search (29 $ por mês, 5.000 produtos) atribuído ao chatbot. O pacote é o que ativa o AI Search para esse chatbot.

2. Pesquisa direta na loja

• O chatbot envia a frase do cliente para o motor de pesquisa interno da loja através da API da loja e responde com o que a loja devolver. Nada é indexado, nada precisa de sincronização e os dados estão sempre atualizados em tempo real.
• Trata-se de uma pesquisa por palavras-chave. Encontra apenas o que a pesquisa interna da loja encontraria para essa frase. Não compreende descrições de necessidades, sinónimos ou gralhas da forma como o AI Search compreende.

Plano necessário: um plano Universal com o extra de integrações de E-commerce (30 $ por mês). Não é necessário qualquer pacote de produtos. Nos planos E-commerce, o AI Search é a opção predefinida e substitui a pesquisa direta na loja.

3. Treino com páginas verificadas da loja (possível, não recomendado para produtos)

• O ChatLab analisa o seu site, incluindo páginas de produto, e armazena o texto das páginas na base de conhecimento de treino. Não requer qualquer integração.
• Adequado para conteúdo informativo: envios, devoluções, métodos de pagamento, guias de tamanhos, sobre nós e FAQ.
• Pouco eficaz para produtos: preços e stock ficam desatualizados entre análises, e as páginas de produtos consomem carateres de treino.

Plano necessário: qualquer plano, incluindo o Free. Fica limitado pelos carateres de treino e pelo número de páginas do plano. Recomendado para páginas informativas, não para produtos.

Um chatbot utiliza o AI Search ou a pesquisa direta na loja para produtos, nunca ambos em simultâneo. As páginas verificadas servem de alternativa para produtos quando a loja não tem integração, funcionando em paralelo com qualquer uma das outras duas opções para tudo o que não seja um produto. Se tiver dúvidas sobre qual escolher, comece pelo AI Search. A comparação completa está disponível em AI Search, live store search or scanned pages.

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.

O ChatLab suporta as seguintes plataformas de e-commerce:

• Shopify - AI Search ou pesquisa na loja em tempo real, estado da encomenda
• WooCommerce - AI Search ou pesquisa na loja em tempo real, estado da encomenda
• PrestaShop - AI Search ou pesquisa na loja em tempo real, estado da encomenda
• Shoper - AI Search ou pesquisa na loja em tempo real, estado da encomenda
• CS-Cart - AI Search ou pesquisa na loja em tempo real, estado da encomenda
• Ecwid - AI Search, estado da encomenda
• Wix - apenas estado da encomenda
• BaseLinker - apenas estado da encomenda
• Abicart - pesquisa na loja em tempo real por frase, estado da encomenda
• Feed de produtos (XML) - AI Search num feed do Google Merchant, sem estado da encomenda

Caminho A: Configurar a AI Search

Utilize este caminho num plano E-commerce ou num plano Universal com o extra de integrações de e-commerce e um pacote de produtos AI Search atribuído ao chatbot.

1. Ligue a loja. Abra o separador Connect (Ligar) e associe a sua plataforma. Siga o artigo correspondente à sua plataforma na lista acima. Se a sua plataforma não tiver uma integração nativa, associe um feed de produtos em XML ou carregue um ficheiro de produtos em XLSX ou CSV em Training > E-commerce catalog (Treino > Catálogo de e-commerce).
2. Aguarde pela indexação do catálogo. A indexação começa automaticamente assim que a loja é associada. Não precisa de analisar as páginas de produtos.
3. Verifique o catálogo. Abra Training > E-commerce catalog (Treino > Catálogo de e-commerce) e consulte os separadores Products (Produtos) e Categories (Categorias). É isto que o chatbot consegue encontrar. O menu Shop > Products (Loja > Produtos) apresenta o painel Product catalog (Catálogo de produtos) com os pacotes de AI Search ativos neste chatbot.
4. Agende a reindexação automática. Em Training > E-commerce catalog (Treino > Catálogo de e-commerce), utilize Schedule auto-retrain (Agendar retreino automático). A reindexação pode ser executada até diariamente e está disponível em todos os planos E-commerce e com qualquer pacote de produtos. As atualizações são incrementais: os produtos inalterados são ignorados e os produtos removidos são eliminados do índice. A opção Train now (Treinar agora) ou Retrain (Retreinar) executa uma atualização a pedido.
5. Reveja a ação de pesquisa. Em Settings > Actions (Definições > Ações), abra a ação de pesquisa de produtos por IA da sua plataforma, por exemplo Shopify - AI product search. As suas opções são Include product card (Incluir cartão de produto), Products in stock only (Apenas produtos em stock) e Number of products to return (Número de produtos a devolver).
6. Ative as Offer Cards. Ative a opção Enable Offer Cards (Ativar Offer Cards) em Settings > Model & Advanced (Definições > Modelo e Avançado) para que os resultados apareçam como cartões de produto, até 5 por resposta. Consulte Offer Cards.

Em seguida, faça testes como se fosse um cliente: descreva uma necessidade em vez de escrever o nome de um produto, indique um orçamento e procure um produto pelo respetivo SKU ou EAN.

Caminho B: Configurar a pesquisa em tempo real na loja (Live store search)

Utilize este caminho quando pretender a pesquisa de produtos sem índice. Requer um plano Universal com o extra de integrações de E-commerce. Não é necessário nenhum pacote de produtos.

1. Ligue a loja. Abra o separador Connect (Ligar) e associe Shopify, WooCommerce, PrestaShop, Shoper, CS-Cart ou Abicart. Siga o artigo correspondente à sua plataforma.
2. Reveja as ações. Em Settings > Actions (Definições > Ações), filtre pela sua plataforma e verifique se a ação de pesquisa de produtos está ativada. Não existe catálogo para indexar nem agendamento a definir.
3. Ative as Offer Cards em Settings > Model & Advanced (Definições > Modelo e Avançado) para que os resultados sejam apresentados como cartões de produto.
4. Ajude o chatbot a construir boas frases. A pesquisa em tempo real na loja baseia-se em palavras-chave, pelo que a frase utilizada é fundamental. As instruções personalizadas abaixo ajudam nesse processo.

Poderá mudar para o AI Search mais tarde, atribuindo um pacote de produtos AI Search ao chatbot. O AI Search substituirá então a pesquisa em tempo real na loja.

Instruções personalizadas para a pesquisa em tempo real na loja

Configure o comportamento personalizado em Settings > Role & Behavior (Definições > Papel e Comportamento). Clique em Enable custom role and behavior instructions (Ativar instruções personalizadas de papel e comportamento) e adicione as instruções referentes à sua plataforma.

Estes exemplos destinam-se às ações de pesquisa em tempo real na loja. Se o AI Search estiver ativado, substituirá estas ações, pelo que deve adaptar as instruções às ações realmente ativadas em Settings > Actions em vez de forçar uma ferramenta indisponível. Utilize o idioma dos produtos da sua loja, não automaticamente o inglês. As definições do bot guardam automaticamente; aguarde pelo estado de guardado antes de testar.

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

Para WooCommerce

A integração do WooCommerce disponibiliza as ferramentas searchProducts, getProductCategories e searchProductBySku:

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 a concise query in the shop's product language.
- If results are empty/weak:
  1) Call getProductCategories(normalized noun) to choose best categoryId.
  2) Call searchProductsInCategory with the chosen category ID and search phrase to show a few items as examples.
- Answer using tool results as the source of truth for name, price and availability.

If ASSORTMENT-OVERVIEW:
  1) Call getProductCategories(normalized noun) to find relevant categoryIds.
  2) For up to 3-5 top categories, call searchProductsInCategory with the chosen category ID and search phrase.
  3) Aggregate from tool results; always label the list as non-exhaustive.

Para Shopify

A integração do Shopify possui a ferramenta searchProducts com a opção de apresentar apenas produtos em stock. Ative a opção Products in stock only (Apenas produtos em stock) na ação de pesquisa de produtos do Shopify para filtrar artigos indisponíveis automaticamente:

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 a concise query in the shop's product language.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as the source of truth for name, price and availability.

If ASSORTMENT-OVERVIEW:
- Call searchProducts to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Para PrestaShop

A integração do 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:

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 a concise query in the shop's product language.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as the source of truth for name, price and availability.

If ASSORTMENT-OVERVIEW:
- Call searchProducts to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Para Abicart, CS-Cart e Shoper

Estas integrações suportam a pesquisa em tempo real na loja, mas os nomes das ações variam. Utilize a ação de pesquisa de produtos ativada em vez de searchProducts neste exemplo. O Wix e o BaseLinker apenas disponibilizam o estado das encomendas, não a pesquisa de produtos:

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 a concise query in the shop's product language.
- If results are empty/weak, try up to 3 reformulations (simplify, synonym, category).
- Answer using tool results as the source of truth for name, price and availability.

If ASSORTMENT-OVERVIEW:
- Call searchProducts to provide a few examples and label them "examples".
- Always be explicit when a list is non-exhaustive (e.g., "Examples include ...").

Caminho C: Treinar com páginas da loja lidas

Pode ignorar a integração e deixar o ChatLab aprender os seus produtos a partir das páginas da sua loja. Este caminho está disponível em qualquer plano, incluindo o FREE, dentro dos limites de carateres de treino e do número de páginas do plano, e funciona com qualquer website.

É possível, mas não o recomendamos para produtos:

• Os preços e o stock ficam desatualizados entre leituras. O chatbot responde com o que a página indicava na última leitura.
• As páginas de produto consomem carateres de treino, pelo que um catálogo grande esgota o limite rapidamente.
• Não existe verificação de stock em tempo real, adição ao carrinho nem estado da encomenda.

Utilize o Caminho C para produtos apenas quando a sua loja não tiver integração e não puder fornecer um feed de produtos em XML ou um ficheiro de produtos. Nesse caso, siga Treinar um bot numa loja de e-commerce sem integração: explica como dividir a leitura entre um treino informativo e um treino de produtos, disponibilizando seletores de elementos prontos a usar para as plataformas de comércio eletrónico mais populares.

Independentemente do caminho que escolher para os produtos, a leitura do website continua a ser a fonte certa para conteúdos informativos: envios, devoluções, métodos de pagamento, guias de tamanhos, sobre nós e FAQ. Consulte a secção "Como ler as páginas informativas da sua loja" abaixo e Adicionar novas fontes de website.

Estado da encomenda e Adicionar ao carrinho

O estado da encomenda e a adição ao carrinho são ações distintas da integração da loja. Funcionam da mesma forma em ambos os caminhos.

• Estado da encomenda - disponível para todas as integrações nativas da loja, incluindo Wix e BaseLinker. Consulte Verificar o estado da encomenda.
• Adicionar ao carrinho - disponível onde quer que a integração e a loja suportem esta funcionalidade. Consulte Adicionar produtos ao carrinho.

Um feed de produtos em XML e um ficheiro de produtos carregado fornecem ao chatbot os produtos para a funcionalidade AI Search, mas não o estado das encomendas.

Planos e limites

Todos os planos E-commerce incluem o AI Search para um número definido de produtos, um limite mensal de respostas do chatbot e uma loja por chatbot. Catálogos maiores podem adicionar pacotes de produtos AI Search. Os planos universais também podem adquirir o suplemento de integrações de e-commerce e pacotes de produtos AI Search. O detalhe completo, incluindo o que conta como produto e o que acontece acima do limite, encontra-se em E-commerce plans and limits.

Escolher e testar o seu modelo de IA

Utilize um modelo que processe o seu catálogo e as perguntas dos clientes com consistência. Teste descrições de produtos ambíguas, códigos de produto exatos, variantes e consultas de encomendas. Compare a qualidade e a utilização de créditos de mensagens antes de mudar de modelo.

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

Como verificar as páginas informativas da sua loja

Planeie a análise do seu website por partes em vez de analisar tudo de uma só vez para obter um melhor controlo. O rastreio tem 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 de análise adequado - utilize a filtragem de URL:

   • Inclua apenas URL de páginas informativas (por exemplo, envios, devoluções, FAQ, contacto)
   • Exclua caminhos de produtos e categorias (por exemplo, /products/ e /collections/) quando os produtos vierem da AI Search ou da pesquisa em direto na loja
   • Exclua caminhos de baixo valor como /tags/ e páginas de arquivo
   • Para lojas multilingues, restrinja a análise ao idioma principal

2. Exclua elementos repetitivos - utilize o filtro de exclusão de elementos HTML (HTML Element Exclusion) para o cabeçalho, rodapé e barra lateral

3. Inclua apenas conteúdo relevante - utilize a inclusão por seletores CSS (CSS Selector Inclusion) para se focar no conteúdo principal de cada página

4. Utilize o Sitemap se estiver disponível - ajuda a identificar as páginas de forma mais eficiente do que o rastreio tradicional

Para o método completo - ambos os níveis de filtragem explicados em detalhe, a divisão recomendada em treinos separados para conteúdos informativos e produtos, e seletores de elementos prontos a utilizar para WooCommerce, Shopify, PrestaShop, Magento, Shoper, CS-Cart e mais - consulte Treinar um chatbot numa loja de e-commerce sem integração. Destina-se a lojas que não podem utilizar uma integração, um feed XML ou um ficheiro de produtos.

Saiba mais sobre como otimizar a análise do seu website: Como reduzir carateres de treino ao analisar um website

Funcionalidades adicionais que vale a pena ativar

Offer Cards

Ative esta definição em Settings > Model & Advanced (Definições > Modelo e avançado) para permitir que o chatbot apresente cartões de produtos com nomes, imagens e preços. Os cartões são gerados a partir dos resultados da AI Search ou da pesquisa em tempo real na loja, até um máximo de 5 por resposta com a AI Search.

Adicione o seguinte às suas instruções personalizadas para evitar hiperligações duplicadas:

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

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

Saiba mais: Perguntas de seguimento dinâmicas sugeridas

Human Hand-off

Ative o formulário Contact Human (contactar agente humano) e indique o seu e-mail de suporte para situações de encaminhamento.

Saiba mais: Formulário de contacto com suporte humano

Resumos de conversas e clientes

Quando esta funcionalidade está ativa, o ChatLab gera automaticamente um resumo de cada conversa e mantém um resumo de perfil atualizado para clientes recorrentes.

Saiba mais: Resumos e memória do chatbot

Chat Frontend API

Pode transmitir o contexto do visitante, como o ID de utilizador ou e-mail, através da API de frontend. O contexto fornecido pelo navegador não constitui prova de identidade e não autoriza automaticamente o acesso ao histórico de encomendas. Nunca exponha chaves de API da loja nem tokens de segurança privados na configuração do widget.

Saiba mais: Chat API

Configuração de idioma

O ChatLab suporta mais de 90 idiomas. Saiba mais: Chatbot Language Setup

Ao utilizar a pesquisa na loja em tempo real com a Shopify, WooCommerce ou outras plataformas de e-commerce, tenha em conta o idioma em que a sua loja devolve os produtos, uma vez que a correspondência da frase é feita pelo próprio motor de pesquisa da loja. Adicione esta instrução nas definições de Role & Behavior (Papel e comportamento):

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

Monitorizar e iterar diariamente

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

• Analise regularmente o histórico de conversas. Ajuste respostas ou adicione conteúdos onde o bot apresente dúvidas. Saiba mais: Histórico de conversas
• Ative o AI Conversation Insights para identificar padrões e problemas. Saiba mais: AI Conversation Insights
• Aproveite o relatório diário de atividade automatizado. Saiba mais: E-mail de resumo diário

Otimizar as respostas do chatbot

Mesmo chatbots bem configurados beneficiam de ajustes regulares. Analise o histórico de conversas para identificar pontos fracos, pedidos mal interpretados ou respostas padronizadas repetitivas de contingência. Ajuste instruções, atualize o material de treino e faça testes com as instruções do sistema.

Saiba mais: Como melhorar as respostas do chatbot

Artigos relacionados

• AI Search: como o seu chatbot encontra produtos
• Planos e limites de e-commerce
• Adicionar o chatbot ao seu website
• Treinar um bot numa loja de e-commerce sem integração
• Integração com um feed de produtos