Ligue o seu chatbot ChatLab à sua loja Shoper para que os clientes possam encontrar produtos e verificar as suas encomendas diretamente no chat. Os produtos são encontrados através da AI Search, que pesquisa o seu catálogo indexado da Shoper pelo significado, ou através da pesquisa em direto na loja, que consulta a API da loja.
Exemplo de conversa
Consultar uma encomenda
Requer uma loja associada e a respetiva ação de encomendas ativada. Os campos disponíveis dependem da integração. A correspondência de um endereço de e-mail não constitui prova de identidade.
Visitante: Onde está a minha encomenda?
Reproduza o exemplo ou leia-o abaixo. Não são utilizados dados reais de clientes.O cliente pergunta sobre uma encomenda existente.
A reprodução pausa quando este exemplo sai do ecrã. Isto é uma simulação, não um chat em direto. Os controlos do widget dentro da reprodução não são interativos.Ler o exemplo completo
- O cliente pergunta sobre uma encomenda existente.
Visitante: Onde está a minha encomenda?
- A pesquisa predefinida necessita de ambos os identificadores.
Assistente: Por favor, indique o número da sua encomenda e o endereço de e-mail utilizado na finalização da compra.
- Utilize dados fictícios neste exemplo.
Visitante: 41982, anna@example.com
- A ação consulta a loja associada.
A verificar a encomenda 41982...
- Apresente apenas as informações devolvidas pela loja.
Assistente: A encomenda 41982 está marcada como enviada. A transportadora é a DPD. Por favor, consulte a página de acompanhamento para ver atualizações sobre a entrega.
O exemplo ilustra a experiência do cliente. As ações disponíveis e as informações devolvidas dependem desta integração e da sua configuração.
Importante: Boas práticas de e-commerce
Depois de concluir a integração abaixo, leia o guia completo sobre como otimizar o seu chatbot para e-commerce: Como configurar o ChatLab para a sua loja de e-commerce
Como o Chatbot Encontra Produtos no Shoper: AI Search e Pesquisa em Tempo Real na Loja
Existem duas formas de um chatbot ChatLab encontrar produtos numa loja Shoper. O chatbot utiliza uma ou outra, nunca ambas.
AI Search (recomendado) - O ChatLab mantém o seu próprio índice do catálogo da Shoper e o chatbot pesquisa por significado.
- Os clientes perguntam em linguagem natural, por exemplo "um vestido vermelho abaixo de 300". Um intervalo de preços é aplicado como filtro rigoroso, e códigos exatos de produto (SKU, EAN) também são correspondidos.
- Preço, stock e variantes são lidos em tempo real a partir da Shoper no momento da resposta, garantindo que os clientes veem dados atualizados mesmo entre atualizações do índice.
- Os resultados surgem como cartões de produto no chat, até 5 por resposta.
- A indexação inicia-se automaticamente quando a loja é associada. O catálogo não consome carateres de treino.
- 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) juntamente com um pacote de produtos AI Search ($29 por mês, 5.000 produtos) atribuído ao chatbot.
Pesquisa em tempo real na loja - o chatbot envia o termo do cliente para a pesquisa da Shoper através da API da loja e responde com os dados devolvidos pela loja.
- Nada é indexado e não é necessário manter nada sincronizado. Os dados estão sempre atualizados.
- Trata-se de uma pesquisa por palavras-chave: encontra o que a própria pesquisa da sua loja encontraria para essa expressão. Não compreende descrições de necessidades, sinónimos ou erros de digitação da mesma forma que a AI Search.
- Plano necessário: um plano Universal com o extra de integrações de e-commerce ($30 por mês). Não é necessário nenhum pacote de produtos.
Quando a AI Search está ativa, substitui a pesquisa em tempo real na loja. O estado da encomenda funciona exatamente da mesma forma em ambas as opções. Uma terceira via, o treino em páginas da loja analisadas, está disponível em qualquer plano e destina-se a conteúdos informativos como envios e devoluções, não a produtos. Para uma comparação completa, consulte AI Search: how your chatbot finds products e, para limites de produtos, consulte E-commerce plans and limits.
O que a integração oferece
Pesquisa na loja em tempo real (pesquisa de produtos por termo) - O chatbot envia o termo do cliente para a pesquisa da Shoper. Efetua a pesquisa nos nomes dos produtos através de correspondência aproximada (fuzzy matching), apresentando até 10 produtos correspondentes com:
- Nome e descrição do produto
- Preço e SKU
- Ligação direta para a página do produto na sua loja
- Imagem do produto
- Estado do stock
- Opcional: anexos do produto (PDFs, documentos)
Também pode ativar o filtro de produtos em stock para apresentar apenas artigos atualmente disponíveis.
Detalhes da encomenda - Os clientes podem verificar o estado da sua encomenda indicando o ID da encomenda e o endereço de e-mail associado à mesma. Ambos os dados são validados com os registos da sua loja Shoper. O chatbot apresenta:
- ID da encomenda, data e estado atual
- Valor total da encomenda e moeda
- Artigos encomendados com nomes, quantidades e preços
- Morada de entrega (rua, cidade, código postal, país, telefone)
- Morada de faturação
- Notas da encomenda
Duas formas de ligar a sua loja
Existem duas formas de ligar o Shoper ao ChatLab:
- Método 1: Aplicação ChatLab da Shoper App Store (recomendado) - instalação com um clique. A aplicação cria a ligação, ativa a pesquisa de produtos e os detalhes das encomendas, e adiciona o widget de chat à sua montra. Sem chaves de API para copiar.
- Método 2: Configuração manual - cria um administrador WebAPI no Shoper e introduz as respetivas credenciais no ChatLab. Utilize este método apenas se não conseguir instalar a aplicação ou se pretender ligar a loja a um chatbot gerido de uma forma específica.
Escolha um dos métodos. Não crie uma segunda ligação com o Método 2 se a aplicação já tiver ligado a loja.
Método 1: Instalar a aplicação ChatLab a partir da App Store do Shoper
A aplicação gratuita ChatLab na App Store do Shoper é a forma mais rápida de começar. Não precisa de ter uma conta ChatLab nem um chatbot - ambos são criados durante a instalação.
- Na administração do Shoper, aceda a Add-ons and integrations > Applications (Suplementos e integrações > Aplicações), procure ChatLab - AI Chatbot for Customer Support and Sales e instale-a
- Abra a aplicação ChatLab na administração do Shoper - o painel do ChatLab abre numa nova janela
- Defina a sua palavra-passe (nova conta) ou inicie sessão com a sua conta ChatLab existente
- Se começou no assistente de configuração do chatbot, confirme a ligação da loja a esse chatbot; caso contrário, é criado um chatbot para a loja na sua conta
- Escolha um plano ou permaneça no plano gratuito - pode fazer o upgrade mais tarde em Account > Subscription (Conta > Subscrição)
Está concluído. A loja está ligada, as ações de pesquisa de produtos e de detalhes da encomenda estão ativadas e o chatbot fica visível na sua loja assim que a ligação for estabelecida. Prossiga com Configurar Ações do Shoper abaixo para rever as ações, ou abra Deploy > Shoper (Implementar > Shoper) no ChatLab para ver novamente os mesmos passos de instalação.
Método 2: Configuração manual
Utilize este método quando não for possível instalar a aplicação. Antes de começar, certifique-se de que:
- A sua subscrição do ChatLab inclui a integração com o Shoper
- Tem acesso ao painel de administração do Shoper
- O seu chatbot já se encontra criado no ChatLab
A configuração manual liga apenas os dados da loja. O widget de chat tem de ser adicionado à sua montra separadamente; consulte Instalar o Chatbot na sua loja Shoper no final deste artigo.
Passo 1: Criar um grupo de administradores
- No painel de administração do Shoper, aceda a Settings > Store administrators (Definições > Administradores da loja)
- Clique em MORE (Mais) > Add administrators group (Adicionar grupo de administradores)
- Introduza um nome para o grupo (por exemplo, "ChatLab Integration"), selecione o tipo de acesso: 'access to webapi' (acesso à webapi) e guarde
Passo 2: Configurar as permissões do grupo
- Abra o grupo recém-criado e aceda às definições de permissões
- Conceda acesso de leitura (Read) aos seguintes recursos:
- Sales (Vendas) - leitura
- Catalog (Catálogo) - leitura
- Configuration (Configuração) - leitura
Passo 3: Adicionar um administrador de API
- Aceda a Administrators (Administradores) e clique em Add administrator (Adicionar administrador)
- Preencha o login e a palavra-passe e associe o administrador ao grupo criado no Passo 1
- Guarde o administrador. Anote o login e a palavra-passe - vai precisar deles no passo seguinte.
Passo 4: Ligar o Shoper no ChatLab
- Inicie sessão no ChatLab e selecione o seu bot
- Aceda ao separador Connect (Ligar)
- Clique em Connect (Ligar) no mosaico do Shoper
- Introduza o seu Shop URL (o domínio do seu Shoper, por exemplo,
myshop.shoper.pl) - Introduza o seu WebAPI Login (do Passo 3)
- Introduza a sua WebAPI Password (do Passo 3)
- Clique em Initialize Configuration (Inicializar configuração) - isto carrega os idiomas disponíveis na sua loja
- Selecione o Shop Language correto no menu pendente (isto define qual a versão linguística dos dados dos produtos a devolver)
- Clique em Connect (Ligar)
O ChatLab testa a ligação automaticamente realizando uma pesquisa de teste de produtos. Se for bem-sucedido, verá uma mensagem de confirmação e ambas as ações de pesquisa de produtos e detalhes da encomenda ficam ativadas por predefinição.
Configurar ações da Shoper
Após ligar através de qualquer um dos métodos, pode ativar e personalizar ações individuais de IA. Aceda a Definições > Ações (Settings > Actions) e filtre pela plataforma Shoper.
As ações padrão incluem:
- Shoper - product search - permite que o chatbot pesquise no seu catálogo de produtos
- Shoper - order details - permite que o chatbot consulte informações sobre encomendas
A configuração da ligação ativa as ações padrão. Reveja o seu estado e desative as que não pretende que os clientes utilizem. Abra uma ação para a editar e utilize Ativar (Enable) ou Atualizar (Update) na respetiva janela. Também pode personalizar a etiqueta da ação (a mensagem apresentada aos utilizadores enquanto a ação é executada) e as instruções que orientam a forma como a IA utiliza cada ação.
Para a pesquisa de produtos, clique no botão Editar (Edit) e aceda ao separador Definições de Pesquisa de Produtos (Product Search Settings). Estão disponíveis duas opções adicionais:
- Incluir anexos de produtos (Include product attachments) - quando ativado, o chatbot inclui ficheiros anexos aos produtos (PDFs, documentos) nos resultados da pesquisa
- Apenas produtos em stock (Products in stock only) - quando ativado, o chatbot devolve apenas produtos que estejam atualmente em stock
AI Search para a Shoper: Catálogo, Reindexação e Definições
Num plano E-commerce, ou num plano Universal quando um pacote de produtos AI Search está atribuído ao chatbot, o AI Search fica ativo e substitui a pesquisa em tempo real na loja. A indexação inicia-se automaticamente assim que a loja é associada.
- Verifique o catálogo - abra Training > E-commerce catalog (Treino > Catálogo de e-commerce) e consulte os separadores Products (Produtos) e Categories (Categorias). O menu Shop > Products (Loja > Produtos) apresenta o painel Product catalog (Catálogo de produtos) e o cartão AI Search packs on this chatbot (Pacotes AI Search neste chatbot).
- Agende a reindexação - utilize a opção Schedule auto-retrain (Agendar retreino automático) em Training > E-commerce catalog. A reindexação pode ser executada até diariamente e está disponível em todos os planos E-commerce e com qualquer pacote de produtos. O botão Train now (Treinar agora) ou Retrain (Retreinar) executa o processo a pedido. As atualizações são incrementais: os produtos inalterados são ignorados e os produtos removidos são eliminados do índice.
- Reveja a ação - em Settings > Actions (Definições > Ações), abra Shoper - AI product search (Shoper - Pesquisa de produtos por IA). As opções disponíveis 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).
- Apresente cartões de produtos - ative Enable Offer Cards (Ativar Offer Cards) em Settings > Model & Advanced (Definições > Modelo e Avançado). Consulte Offer Cards.
Quando o catálogo ultrapassa o limite de produtos, a indexação para ao atingir esse limite e o proprietário do chatbot recebe um e-mail. As opções da ação de pesquisa em tempo real na loja descritas acima não se aplicam necessariamente ao AI Search.
Testar a sua integração
Após ativar as ações, abra a secção Overview (Visão geral) e experimente:
- "Mostra-me sapatilhas de corrida" (testa a pesquisa de produtos)
- "Qual é o estado da minha encomenda 12345?" (testa os detalhes da encomenda; forneça o e-mail correspondente a uma encomenda à qual tenha autorização de acesso)
Verifique se as respostas correspondem aos dados da sua loja Shoper e se as ligações dos produtos abrem corretamente.
Instalar o chatbot na sua loja Shoper
Se utilizou o Método 1 (a aplicação), o widget de chat já se encontra na sua loja e não precisa de adicionar nada. Se utilizou o Método 2 (configuração manual), abra Deploy > Shoper no ChatLab, mude para Manual Installation (Instalação manual), copie o código e cole-o no painel de administração da Shoper em Add-ons and integrations > Custom integrations (Suplementos e integrações > Integrações personalizadas), no campo Page header (Cabeçalho da página). Consulte Adding chatbot to your website para mais detalhes.