Saltar para o conteúdo principal

WooCommerce

Com a integração do WooCommerce, seu agente do ChatNorris responde sobre os pedidos e o estoque da sua loja sem sair do chat. Conforme o que você ativar, o agente:
  • informa o status, o total e os itens de um pedido, só depois de verificar que ele é do visitante;
  • procura produtos (por SKU ou por nome) e responde a disponibilidade e o preço naquele momento;
  • usa seu catálogo de produtos e as variações (tamanho, cor, medida) como fonte de conhecimento para responder a perguntas gerais.
Funciona no widget web, WhatsApp, Instagram, Messenger, Telegram, Email e na API.

Requisitos

  • Uma conta do ChatNorris no plano Standard ou Premium. Você pode ver os planos em chatnorris.ai/pricing.
  • Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga Criar um agente.
  • Uma loja WooCommerce com a REST API habilitada e acesso ao painel do WordPress para gerar as chaves da API (Consumer key e Consumer secret).
  • Função Owner ou Admin na sua organização do ChatNorris.

Conectar o WooCommerce

Cada agente se conecta a uma loja WooCommerce. A conexão é feita uma única vez em Integrações e é usada tanto pela Ação WooCommerce quanto pela fonte de conhecimento WooCommerce.
1

Gere as chaves da API no WooCommerce

No painel do WordPress, abra WooCommerce → Configurações → Avançado → API REST e gere uma chave. Copie a Consumer key e o Consumer secret.
2

Abra o hub de Integrações do agente

No ChatNorris, entre em Agentes → [seu agente] → Integrações e escolha WooCommerce.
3

Preencha os dados e conecte

Informe a URL da loja, a Consumer key e o Consumer secret, e clique em Conectar.
4

Teste a conexão

Use Testar conexão para confirmar que as credenciais funcionam antes de usá-las na Ação ou na fonte de conhecimento.
As chaves são salvas criptografadas: no hub só aparecem os últimos 4 caracteres. Se você trocar as chaves no WooCommerce, use Substituir chave no menu ··· da linha; a conexão continua sendo a mesma, então a Ação e a fonte que a usam não são afetadas.
O ChatNorris só lê pedidos e produtos da sua loja: não cria nem modifica nada no WooCommerce.

Configurar a Ação

Conectar a loja ainda não ativa nada. Para escolher o que o agente pode consultar:
1

Crie a Ação WooCommerce

Entre em Agentes → [seu agente] → Ações, clique em Nova ação e escolha WooCommerce. Se você ainda não conectou a loja, a tela leva você direto para Integrações.
2

Escolha quais dados o agente pode consultar

Em Acesso a dados (veja a tabela abaixo).
3

Configure a verificação de pedidos

Com Verificação do pedido ativa, o agente exige o número do pedido e pelo menos um destes dados antes de mostrar informações: Email de faturamento, Telefone de faturamento ou CEP de faturamento.
4

Habilite a Ação e salve

Ative Habilitado na seção Geral e salve. A partir desse momento, o agente usa sua loja em todas as conversas.
Recomenda-se Claude Sonnet ou superior como modelo principal do agente (Configurações → IA). A ação revela dados de um pedido só depois de verificá-lo e, em testes, o Haiku às vezes responde como se os dados já estivessem confirmados, mesmo sem estarem. O formulário da ação mostra esse aviso com um link para a configuração de IA.
Uma única loja por agente. Um agente pode ter apenas uma loja ativa para consultar pedidos e estoque (por exemplo, WooCommerce ou Odoo). Se você tentar habilitar uma segunda, o ChatNorris pede que você desative primeiro a consulta de pedidos e de estoque da outra. O Odoo pode continuar ativo para leads e tickets junto com uma loja WooCommerce.

Como o visitante consulta um pedido

No widget web, quando o agente detecta que o visitante quer saber o status de um pedido, ele não pede os dados por texto: mostra um formulário incorporado dentro do chat com dois campos — Número do pedido e Email ou telefone da compra. O formulário e a resposta aparecem no idioma do widget (espanhol, inglês ou português), e ele é o mesmo para WooCommerce e Odoo. Enquanto o formulário estiver pendente, o visitante não pode escrever outra mensagem até preenchê-lo ou cancelá-lo.
  • Se os dados corresponderem a um pedido real, o agente responde com o status, o total e os itens.
  • Se não corresponderem, o agente informa que não conseguiu verificar o pedido e pede que o visitante revise o número e o dado de contato — nunca mostra informações sem verificação.
  • Um pedido que não existe e um dado que não corresponde recebem a mesma resposta, para que ninguém consiga adivinhar números de pedido. Depois de 5 tentativas com falha na mesma conversa, a consulta de pedidos é bloqueada.
No WhatsApp e no Instagram (onde não há formulários incorporados), o agente pede esses mesmos dados de forma conversacional, dentro do chat de texto.

Consulta de preço e estoque

Com Estoque ativo, o agente consulta a loja toda vez que vai falar do preço ou do estoque de um produto, mesmo que já o tenha consultado antes na conversa: o preço e a disponibilidade saem da sua loja naquele momento, não da base de conhecimento. Se o visitante pedir uma recomendação sem citar um produto (“o que você recomenda para 5 pessoas?”), o agente consulta o catálogo em tempo real e propõe uma ou duas opções concretas com o preço, evitando as que estão esgotadas. Com a Ação ativa, a lista de fontes da Base de conhecimento também mostra a linha informativa Catálogo do WooCommerce ao vivo, com a etiqueta Ao vivo e o link Ver ação. Não é uma fonte: indica que o agente consulta preço e estoque direto na loja em cada conversa, então não ocupa caracteres nem precisa ser sincronizada.

Importar o catálogo para a base de conhecimento

Você pode trazer o catálogo de produtos da sua loja WooCommerce para a base de conhecimento como mais uma fonte, para que o agente responda a perguntas gerais sobre produtos (não só sobre disponibilidade pontual). Basta ter a loja conectada em Integrações: não é preciso ter a Ação WooCommerce ativa, que é configurada separadamente (consulta de pedidos e estoque).
1

Abra a fonte WooCommerce

Vá para Agentes → [seu agente] → Base de conhecimento → Adicionar fonte e escolha WooCommerce. Se a loja ainda não estiver conectada, clique em Conectar em Integrações: ali você informa a URL da loja e as chaves da API do WooCommerce, uma única vez por agente.
2

Clique em Sincronizar catálogo

Com a loja conectada, volte para a fonte WooCommerce e clique em Sincronizar catálogo (ou Ressincronizar, se você já tinha trazido o catálogo antes). Você também pode fazer isso na seção Base de conhecimento da tela de configuração da Ação WooCommerce.
3

Aguarde o processamento

São trazidos até 2.000 produtos publicados. De cada um, são indexados: nome, SKU, preço, disponibilidade (em estoque / esgotado) e descrição. Passa pelo mesmo pipeline de processamento que qualquer outra fonte (Pendente → Processando → Pronto).
Se você também tem a Ação WooCommerce ativa para consultar pedidos ou estoque, sincronize também o catálogo para que o agente responda a perguntas gerais sobre produtos.
Esta fonte aparece com seu próprio filtro WooCommerce na tabela da base de conhecimento e não tem botão Editar — o conteúdo é gerado automaticamente a partir da sua loja, não é editado manualmente.
A sincronização do catálogo é manual: não há sincronização automática para esta fonte. Se preços, estoque ou produtos mudarem na sua loja, clique novamente em Sincronizar catálogo para atualizar a base de conhecimento.
Isso é diferente da consulta de estoque em tempo real da Ação WooCommerce: o catálogo sincronizado serve para perguntas gerais sobre produtos (“que camisetas vocês têm?”), enquanto a Ação consulta o estoque e o preço pontual no momento da conversa.

Variações de produto (tamanho, cor etc.)

Se a sua loja tem produtos variáveis (por exemplo, uma camiseta com diferentes tamanhos e cores), no mesmo painel você encontra Variações de produtos. Com Gerar variações, é criado um mapa de atributos (medida, cor etc.) para SKU de todos os produtos com variações, para que o agente possa responder a perguntas por características sem depender só da consulta em tempo real. Com Ver conteúdo gerado você revisa o resultado e com Baixar .txt você o baixa. Esse conteúdo é regenerado a cada sincronização e não pode ser editado: se precisar de correções, adicione-as em uma fonte de texto separada. Ao contrário do catálogo, as variações são ressincronizadas sozinhas com a frequência do seu plano: semanal no Standard e diária no Premium.
Um agente usa uma loja via API ou via site público, não as duas. Se ele já tiver a Ação WooCommerce com consulta de pedidos ou estoque ativa, o painel da fonte Loja on-line (site público) avisa você e leva você para Ações.

Créditos

Conectar e testar a loja não consome créditos. Cada resposta do agente que consulta sua loja em tempo real (pedidos, ou preço e estoque) soma 0,5 crédito de IA ao custo normal da resposta, uma única vez por resposta. Os testes no Playground não somam essa cobrança. O catálogo e as variações importadas ocupam caracteres da sua base de conhecimento como qualquer outra fonte. Veja Modelos de IA e créditos.

Pausar ou desconectar

  • Pausar: desative a chave Ativa da linha do WooCommerce em Integrações. As credenciais são mantidas, mas a Ação não consegue consultar a loja e a fonte de conhecimento não é sincronizada; o conteúdo já indexado continua sendo usado. Ative a chave novamente para retomar.
  • Desconectar: no menu ··· ou no detalhe do WooCommerce, clique em Desconectar. Antes de confirmar, o ChatNorris mostra o que depende da conexão. A Ação WooCommerce é desativada, mas sua configuração é mantida; a fonte de conhecimento é desativada, mas o conteúdo já indexado é mantido. As chaves são apagadas do ChatNorris.
Para voltar a usar a Ação e a fonte, conecte a loja novamente e reative-as. Se você não for mais usar as chaves, revogue-as em WooCommerce → Configurações → Avançado → API REST.

Perguntas frequentes

Você precisa de uma loja WooCommerce com a REST API habilitada e credenciais (Consumer key e Consumer secret) geradas no painel do WordPress. Use Testar conexão em Integrações para confirmar que está tudo bem configurado.
Não, o formulário incorporado é exclusivo do widget web. No WhatsApp e no Instagram, o agente pede o número do pedido e o dado de verificação de forma conversacional, dentro do chat de texto.
Não. A sincronização do catálogo com a base de conhecimento é manual — clique em Sincronizar catálogo sempre que quiser trazer as mudanças de preço, estoque ou produtos novos. Já as variações são ressincronizadas sozinhas com a frequência do seu plano, e o preço e o estoque que a Ação responde sempre saem da loja em tempo real.
Não. As conexões existentes foram migradas automaticamente para o hub de Integrações — você vai encontrá-las já conectadas ali. Você só precisa reconectar se a conexão aparecer como Requer atenção.
Não. Cada provedor admite uma única conexão por agente. Se você precisar conectar lojas diferentes, use agentes separados.
Não. Um agente usa uma única loja para não responder dois preços diferentes para o mesmo produto. Se você tem duas lojas, crie um agente para cada uma. Veja Jumpseller.
Sim, com uma condição: preços e estoque saem de apenas uma das duas. O mais comum é deixar no Laudus o estoque e o preço, e no WooCommerce a consulta de pedidos. Se você importar os dois catálogos para a base de conhecimento, o agente vê os produtos duas vezes: deixe apenas um ativo. Veja Laudus.