> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce

> Como conectar sua loja WooCommerce a um agente do ChatNorris para consultar pedidos verificados e responder preço e estoque em tempo real, e importar o catálogo e as variações de produto para a base de conhecimento.

# 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](https://chatnorris.ai/pricing).
* Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md).
* 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.

> [!TIP]
>
> 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.

| Recurso | O que faz |
| - | - |
| **Pedidos** | Consulta o status, o total e os itens de um pedido, só depois de verificar a identidade do comprador. |
| **Estoque** | Procura produtos por SKU ou por nome e responde a disponibilidade e o preço daquele momento. |
| **Dados do cliente** | Reservado para uso futuro. Mantenha desativado: por enquanto não faz nada, mesmo se você ativar. |

> [!WARNING]
>
> **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.

> [!NOTE]
>
> **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](https://docs.chatnorris.ai/pt/guias/odoo.md) 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).

> [!TIP]
>
> 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.

> [!NOTE]
>
> 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.

> [!WARNING]
>
> 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.

> [!TIP]
>
> 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.

> [!NOTE]
>
> 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)](https://docs.chatnorris.ai/pt/guias/knowledge-base.md#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](https://docs.chatnorris.ai/pt/guias/modelos-ia-creditos.md).

## 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

> [accordion] O WooCommerce funciona com qualquer loja?
>
> 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.

> [accordion] O formulário de consulta de pedido também aparece no WhatsApp e no Instagram?
>
> 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.

> [accordion] O catálogo de produtos é atualizado sozinho?
>
> 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.

> [accordion] Eu já tinha o WooCommerce conectado pela própria Ação. Preciso reconectar?
>
> 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**.

> [accordion] Posso conectar duas lojas WooCommerce no mesmo agente?
>
> Não. Cada provedor admite uma única conexão por agente. Se você precisar conectar lojas diferentes, use agentes separados.

> [accordion] Posso usar Jumpseller e WooCommerce no mesmo agente?
>
> 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](https://docs.chatnorris.ai/pt/guias/jumpseller.md).

> [accordion] Posso usar Laudus e WooCommerce no mesmo agente?
>
> 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](https://docs.chatnorris.ai/pt/guias/laudus.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.