Centro de Ajuda
Integrações do chatbot

Integração com o WooCommerce

Última atualização:

Ligue o seu chatbot ChatLab à sua loja WooCommerce para dar aos clientes acesso em tempo real a informações sobre produtos, navegação por categorias e acompanhamento de encomendas diretamente no chat.

Importante: Melhores 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

O que a Integração Oferece

Product Search - Os clientes podem pesquisar no catálogo da sua loja WooCommerce introduzindo uma frase. O chatbot pesquisa nos títulos e descrições dos produtos, devolvendo os 5 produtos publicados mais relevantes com:

  • ID, nome e descrição do produto
  • Preço e SKU
  • Imagem do produto e link direto para a página do produto

Product Search by SKU - Os clientes podem procurar produtos utilizando um SKU específico, número de referência ou código de produto. Isto é útil quando os clientes já conhecem o identificador exato do produto - por exemplo, a partir de um catálogo impresso, de uma encomenda anterior ou de uma recomendação. Devolve os mesmos campos de produto que a pesquisa de produtos padrão.

Product Search in Category - Uma pesquisa mais direcionada que combina uma palavra-chave com uma categoria de produtos específica. O chatbot identifica primeiro a categoria correta e, em seguida, pesquisa dentro dela por produtos correspondentes. Devolve os mesmos campos de produto que a pesquisa de produtos padrão.

Get Categories - O chatbot pode obter uma lista das categorias de produtos disponíveis na sua loja, ajudando os clientes a navegar no seu catálogo ou a filtrar pesquisas de produtos. Cada categoria inclui:

  • ID, nome e slug da categoria
  • Descrição da categoria

Order Details - Os clientes podem verificar o estado da sua encomenda fornecendo o ID da encomenda e o endereço de e-mail. Ambos os valores são validados com os registos da sua loja WooCommerce. O chatbot devolve:

  • Número da encomenda, valor total e estado (por exemplo: em processamento, concluída, cancelada)
  • Endereço de envio com nome e apelido do destinatário, empresa, morada completa (rua, cidade, distrito/região, código postal, país)
  • Artigos encomendados com nomes, quantidades, preços individuais e totais de linha

Pré-requisitos

Antes de iniciar a integração com o WooCommerce, certifique-se de que:

Passo 1: Gerar Chaves de API no WooCommerce

  1. Inicie sessão no painel de administração do WordPress
  2. Aceda a WooCommerce > Settings (Definições)
  3. Clique no separador Advanced (Avançado)
  4. Selecione REST API
  5. Clique em Add Key (Adicionar chave)
  6. Introduza uma descrição (por exemplo, "ChatLab Integration")
  7. Selecione o utilizador ao qual atribuir a chave - este tem de ser um utilizador com a função de Administrator (Administrador) ou Shop Manager (Gestor de loja) (outras funções como Customer ou Subscriber não possuem as permissões necessárias para aceder aos dados do WooCommerce)
  8. Defina as permissões como Read (Leitura)
  9. Clique em Generate API Key (Gerar chave de API)
  10. Copie a Consumer Key e a Consumer Secret - guarde-as em segurança, pois a Consumer Secret não poderá ser visualizada novamente

Passo 2: Ligar o WooCommerce no ChatLab

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

Separador Connect mostrando o mosaico da integração WooCommerce

  1. Clique em Connect no mosaico do WooCommerce
  2. Introduza o URL of WooCommerce store (o URL completo da sua loja, por exemplo, https://www.mystore.com)
  3. Introduza a Customer Key (Consumer Key do Passo 1)
  4. Introduza a Customer Secret (Consumer Secret do Passo 1)

Formulário de integração do WooCommerce com os campos de URL da loja, chave e segredo

  1. Clique em Connect

O ChatLab testa a ligação automaticamente, verificando se as suas credenciais de API têm os acessos necessários. Se for bem-sucedido, verá uma mensagem de confirmação.

Opções de Ligação

O formulário de ligação do WooCommerce inclui definições adicionais:

  • Use order search instead of retrieve - Ative esta opção se a sua loja utilizar plugins de numeração personalizada de encomendas. Utiliza uma consulta baseada em pesquisa em vez de recuperação direta, sendo compatível com esquemas de numeração modificados.
  • Use product short description - Quando ativado, os resultados da pesquisa de produtos devolvem a descrição curta do WooCommerce em vez da descrição completa. Útil para lojas com descrições de produtos muito longas.
  • Include in-stock products only - Quando ativado, os resultados da pesquisa de produtos incluem apenas artigos que estejam atualmente em stock.

Passo 3: Configurar Ações do WooCommerce

Após a ligação, pode ativar e personalizar ações individuais de IA. Aceda a Settings > Actions (Definições > Ações) e filtre pela plataforma WooCommerce.

Ações do WooCommerce em Settings mostrando todas as ações disponíveis

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

  • WooCommerce - Product Search - permite ao chatbot pesquisar no catálogo de produtos por palavra-chave
  • WooCommerce - Product Search by SKU - permite ao chatbot encontrar produtos pelo respetivo SKU, número de referência ou código de produto
  • WooCommerce - Product Search in Category - permite ao chatbot pesquisar dentro de uma categoria de produtos específica
  • WooCommerce - Get Categories - permite ao chatbot listar as categorias de produtos na sua loja
  • WooCommerce - Get Order - permite ao chatbot consultar informações de encomendas através do ID da encomenda e do e-mail

Clique no botão de ativação em cada ação para ativá-la. 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 sapatilhas de corrida" (testa a pesquisa de produtos)
  • "Procuro o produto com o SKU WH-1234" (testa a pesquisa de produtos por SKU)
  • "Que categorias têm?" (testa a obtenção de categorias)
  • "Mostra-me calçado na categoria Roupa Desportiva" (testa a pesquisa de produtos numa categoria)
  • "Qual é o estado da minha encomenda #1001?" (testa os detalhes da encomenda)

Verifique se as respostas correspondem aos dados da sua loja WooCommerce e se os links dos produtos abrem corretamente.

Instalar o Chatbot na Sua Loja WooCommerce

Para adicionar o widget de chat ao seu site WordPress/WooCommerce, consulte o guia detalhado: Instalar o Chatbot numa Loja WooCommerce

Ver Demonstração

Pode ver uma integração WooCommerce em tempo real e em funcionamento: https://yourwear.chatlab.com/shop