Ligue o seu chatbot ChatLab à sua loja Shoper para dar aos clientes acesso em tempo real a informações sobre produtos e acompanhamento de encomendas diretamente no chat.
Importante: Boas Práticas de E-Commerce
Depois de concluir a integração abaixo, leia o guia abrangente sobre como otimizar o seu chatbot para e-commerce: How to set up ChatLab for your E-commerce store
O que a Integração Oferece
Pesquisa de Produtos - Os clientes podem pesquisar no seu catálogo Shoper introduzindo uma frase. O chatbot pesquisa nos nomes dos produtos utilizando correspondência aproximada (fuzzy matching), devolvendo 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 devolver apenas os produtos atualmente disponíveis.
Detalhes da Encomenda - Os clientes podem verificar o estado da sua encomenda fornecendo o ID da encomenda e o endereço de e-mail associado à mesma. Ambos os valores são validados com base nos registos da sua loja Shoper. O chatbot devolve:
- ID da encomenda, data e estado atual
- Valor total da encomenda e moeda
- Artigos encomendados com nomes, quantidades e preços
- Endereço de entrega (rua, cidade, código postal, país, telefone)
- Endereço de faturação
- Notas da encomenda
Pré-requisitos
Antes de iniciar a integração com o Shoper, certifique-se de que:
- Tem uma subscrição STANDARD ou PREMIUM do ChatLab
- Tem acesso ao seu painel de administração do Shoper
- O seu chatbot já se encontra criado no ChatLab
Passo 1: Criar um Grupo de Administradores
- No seu 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 Access type (Tipo de acesso): 'access to webapi' e guarde
Passo 2: Configurar Permissões do Grupo
- Abra o grupo recém-criado e aceda às definições de permissões
- Conceda acesso de Read (Leitura) aos seguintes recursos:
- Sales (Vendas) - read
- Catalog (Catálogo) - read
- Configuration (Configuração) - read
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 - irá 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 no mosaico do Shoper
- Introduza o seu Shop URL (o domínio da sua loja 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 obtém os idiomas disponíveis na sua loja
- Selecione o Shop Language (Idioma da loja) correto no menu suspenso (isto determina em que versão de idioma os dados dos produtos são devolvidos)
- Clique em Connect
O ChatLab testa automaticamente a ligação através de uma pesquisa de produtos de teste. Se for bem-sucedido, verá uma mensagem de confirmação e as ações de pesquisa de produtos e detalhes da encomenda ficam ativadas por predefinição.
Passo 5: Configurar Ações do Shoper
Após estabelecer a ligação, pode ativar e personalizar ações individuais de IA. Navegue até Settings > Actions (Definições > Ações) e filtre pela plataforma Shoper.
Estão disponíveis duas ações:
- 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
Clique no botão de ativação em cada ação para a ativar. Também pode personalizar a etiqueta da ação (a mensagem mostrada 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 Edit (Editar) e aceda ao separador Product Search Settings (Definições de Pesquisa de Produtos). Estão disponíveis duas opções adicionais:
- Include product attachments (Incluir anexos do produto) - quando ativado, o chatbot inclui ficheiros anexos aos produtos (PDFs, documentos) nos resultados da pesquisa
- Products in stock only (Apenas produtos em stock) - quando ativado, o chatbot devolve apenas produtos que se encontram atualmente em stock
Testar a sua Integração
Depois de ativar as ações, abra o widget do seu chatbot e experimente:
- "Mostra-me sapatilhas de corrida" (testa a pesquisa de produtos)
- "Qual é o estado da minha encomenda 12345?" (testa os detalhes da encomenda)
Verifique se as respostas correspondem aos dados da sua loja Shoper e se as ligações para os produtos abrem corretamente.