Centro de Ajuda
Integrações do chatbot

Integração com o CS-Cart

Última atualização:

Ligue o seu chatbot ChatLab à sua loja CS-Cart para dar aos clientes acesso em tempo real às informações dos produtos e ao seguimento de encomendas diretamente no chat.

Importante: Boas Práticas de E-Commerce

Depois de concluir a integração abaixo, leia o guia completo sobre a otimização do seu chatbot para e-commerce: Como configurar o ChatLab para a sua loja de e-commerce

O Que a Integração Oferece

Pesquisa de produtos - Os clientes podem pesquisar o seu catálogo CS-Cart introduzindo uma frase. O chatbot apresenta os produtos correspondentes com:

  • Nome e descrição do produto
  • Preço
  • SKU (código do produto)
  • Link direto para o produto na sua loja
  • Imagem do produto
  • Variantes disponíveis (tamanhos, cores, etc.)

Pode configurar quais os campos de produto abrangidos pela pesquisa (nome, descrição curta, descrição completa, palavras-chave) e quantos resultados devolver.

Detalhes da encomenda - Os clientes podem verificar o estado da encomenda indicando o respetivo ID de encomenda e o endereço de e-mail. O chatbot apresenta:

  • Estado da encomenda
  • Artigos encomendados com nomes, preços, quantidades, imagens dos produtos e variantes selecionadas
  • Total da encomenda e portes de envio
  • Transportadora, número de rastreio e estado do envio
  • Nome do destinatário e morada de entrega completa
  • Telefone do cliente

Passo 1: Ativar o Acesso à API no CS-Cart

  1. Inicie sessão no seu painel de administração do CS-Cart
  2. Aceda a Customers > Administrators (Clientes > Administradores)

Navegar para Administrators no CS-Cart

  1. Clique na conta de administrador que será utilizada para a ligação à API
  2. Mude para o separador API access (Acesso à API)
  3. Marque "Yes, allow this user to use the API" ("Sim, permitir que este utilizador utilize a API")
  4. Clique em Save (Guardar)

Separador de acesso à API que mostra a chave de API gerada

  1. Copie a API key (chave de API) apresentada após guardar - guarde-a em segurança
  2. Registe o email address (endereço de e-mail) associado a esta conta de administrador

Passo 2: Ligar o CS-Cart no ChatLab

  1. Inicie sessão no ChatLab e selecione o seu bot
  2. Aceda ao separador Connect (Ligar)

Separador Connect a mostrar o mosaico de integração do CS-Cart

  1. Clique em Connect no mosaico do CS-Cart
  2. Introduza a sua API Key (do Passo 1)
  3. Introduza o seu Account Email (o e-mail de administrador com acesso à API)
  4. Introduza o seu Shop Url (por exemplo, https://yourstore.com)

Também pode configurar as opções de pesquisa:

  • Searchable fields - selecione os campos de produto em que o chatbot pesquisa (nome do produto, descrição curta, descrição completa, palavras-chave)
  • Number of search results - quantidade de produtos a devolver por consulta (predefinição: 5)

Formulário de integração do CS-Cart com credenciais e opções de pesquisa

  1. Clique em Connect

Após uma ligação bem-sucedida, verá uma mensagem de confirmação com a opção para configurar as ações de IA.

Passo 3: Configurar as Ações do CS-Cart

Após a ligação, ative e personalize as ações individuais de IA. Aceda a Settings > Actions (Definições > Ações) e filtre pela plataforma CsCart.

Ações do CS-Cart nas Definições a mostrar a pesquisa de produtos e os detalhes da encomenda

Estão disponíveis duas ações:

  • CsCart - product search - permite que o chatbot pesquise no seu catálogo de produtos
  • CsCart - order details - permite que o chatbot consulte as informações da encomenda

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.

Testar a Sua Integração

Depois de ativar as ações, abra o widget do seu chatbot e experimente:

  • "Mostra-me luvas de treino" (testa a pesquisa de produtos)
  • "Qual é o estado da minha encomenda 12345?" (testa os detalhes da encomenda)

Verifique se as respostas coincidem com os dados da sua loja CS-Cart.

Dicas para a Configuração da Pesquisa

  • Ative Product name e Short description para obter o melhor equilíbrio entre velocidade e precisão
  • Adicione Keywords se os seus produtos tiverem metadados completos de palavras-chave
  • Só ative Full description se os campos mais curtos não apresentarem bons resultados - isto pode tornar as pesquisas mais lentas
  • Comece com 5 resultados por consulta e ajuste com base no tamanho do seu catálogo

Instalar o Chatbot na Sua Loja CS-Cart

Para adicionar o widget de chat à sua montra do CS-Cart:

  1. No ChatLab, aceda ao separador Deploy (Implementar) do seu bot
  2. Selecione o separador da plataforma CS-Cart
  3. Copie o fragmento de código
  4. Na administração do seu CS-Cart, aceda a Design > Layouts (Design > Esquemas)
  5. Cole o fragmento de código num bloco HTML personalizado
  6. Guarde as alterações do esquema