# WooCommerce

> Conecte a loja WooCommerce em Configurações › Integrações e receba cada pedido por webhook, para avisar o cliente no WhatsApp.

Endereço: https://help.nextags.com.br/integracoes/woocommerce/
Tipo: Integração

Atualizado em: 25/10/2026

O WooCommerce se liga à NexTags de dois jeitos. O cartão **WooCommerce**, em **Configurações** › **Integrações**, conecta a loja ao E-commerce da NexTags pelo endereço do site ("Conecte seu WooCommerce e venda dentro do seu bot"). Os avisos de pedido vêm pelos webhooks do próprio WooCommerce: a cada pedido criado ou atualizado, a loja manda os dados para um webhook de entrada da NexTags, que acha ou cria o contato e inicia o fluxo do aviso.

## O que dá para fazer

- Ligar a loja ao E-commerce da NexTags. Veja [Importar produtos e sincronizar o catálogo da Meta](https://help.nextags.com.br/tutoriais/ecommerce/importar-e-catalogo/).
- Avisar no WhatsApp que o pedido foi recebido ou mudou de situação. Veja [Pedidos da loja avisando o cliente no WhatsApp](https://help.nextags.com.br/trilhas/loja-avisa-no-whatsapp/).
- Começar o pós-venda depois da compra. Veja [Pós-venda automático](https://help.nextags.com.br/trilhas/pos-venda-automatico/).

## Como conectar

### Passo 1: Conecte a loja em Configurações › Integrações

Na NexTags, abra **Configurações** › **Integrações**, clique no cartão **WooCommerce** e em **Conectar**.

![Cartão WooCommerce aberto na aba Integrações das Configurações, com o botão Conectar e o texto Conecte seu WooCommerce e venda dentro do seu bot.](https://help.nextags.com.br/_img/integracoes-3/woocommerce-cartao.webp)
*O cartão WooCommerce na aba Integrações.*

1. **WooCommerce**: abre e fecha o cartão. Enquanto a loja não está ligada, ele mostra **Não conectado**.
2. **Conectar**: abre a janela do endereço da loja.

### Passo 2: Informe o endereço da loja

Em **Link do site**, escreva o endereço da loja e clique em **Continuar**. Se o navegador abrir outra página, siga o que ela pedir.

![Janela WooCommerce de Configurações › Integrações, com o campo Link do site e os botões Cancelar e Continuar.](https://help.nextags.com.br/_img/ecommerce/woocommerce.webp)
*1. Link do site.*

1. **Link do site**: o endereço da loja, como https://www.sualoja.com.br.

### Passo 3: Crie o webhook de entrada para os pedidos

Em **Ferramentas** › **Webhooks de entrada**, crie um webhook, como "Pedidos do WooCommerce", e copie o link pelo ícone **Obter Link**. Em **Sample JSON**, cole um pedido de exemplo da [documentação da API REST do WooCommerce](https://woocommerce.github.io/woocommerce-rest-api-docs/): o webhook manda o pedido nesse mesmo formato.

![Quadro Find or create contact com os caminhos de um pedido do WooCommerce: o telefone e o e-mail do bloco billing, com o resultado de cada um embaixo, e o Nome completo vazio.](https://help.nextags.com.br/_img/integracoes-3/woocommerce-contato.webp)
*Os caminhos de um pedido do WooCommerce em Find or create contact.*

1. **Número de telefone**: `$.billing.phone`, o telefone de cobrança.
2. **Endereço de e-mail**: `$.billing.email`.

O nome e o sobrenome vêm separados: em **Save incoming data**, guarde `$.billing.first_name` em **Nome** e `$.billing.last_name` em **Sobrenome**. Guarde também o número (`$.number`) e a situação do pedido (`$.status`, como `processing` ou `completed`). Escolha o fluxo do aviso em **Enviar Fluxo** e clique em **Salvar**.

### Passo 4: Cadastre o webhook no WooCommerce

No painel do WordPress, abra **WooCommerce** › **Configurações** › **Avançado** › **Webhooks** e clique em **Adicionar webhook**. Dê um **Nome**, deixe o **Status** em **Ativo**, escolha o **Tópico** **Pedido criado**, cole o link da NexTags em **URL de entrega** e clique em **Salvar webhook**.

![Formulário Webhook data do WooCommerce, em Settings › Advanced › Webhooks, com os campos Name, Status, Topic, Delivery URL, Secret e API Version e o botão Save webhook (imagem da documentação do WooCommerce, em inglês).](https://help.nextags.com.br/_img/integracoes-3/woocommerce-webhook.webp)
*O formulário de webhook do WooCommerce, em inglês na imagem.*
Imagem: [Documentação do WooCommerce](https://woocommerce.com/document/webhooks/)

Para avisar as mudanças de situação, crie outro webhook com o tópico **Pedido atualizado**. Ele dispara a cada mudança no pedido: no fluxo, use uma condição com a situação para mandar só o aviso certo. Veja [Etapa Condição: caminhos diferentes para cada contato](https://help.nextags.com.br/tutoriais/fluxos/condicoes/). Passo a passo do WooCommerce: [Webhooks](https://woocommerce.com/document/webhooks/).

Para conferir, faça um pedido de teste com o seu telefone: o aviso chega no seu WhatsApp e os dados do pedido aparecem no seu contato.

## Se não funcionou

### Apareceu "Erro: URL de entrega retornou um código de resposta"

Ao salvar um webhook **Ativo**, o WooCommerce manda um teste ao link. Confira se o link é o do webhook de entrada, inteiro, e se ele foi salvo e está **Ativo** na NexTags. Se o erro continuar, fale com o suporte, de segunda a sexta, das 8h às 17h (horário de Brasília).

### O webhook ficou Desativado no WooCommerce

O WooCommerce desativa o webhook depois de mais de cinco falhas seguidas. Corrija o link ou o webhook de entrada, volte o **Status** para **Ativo** e veja os envios em **WooCommerce** › **Status** › **Logs**, na fonte `webhooks-delivery`.

### O aviso demora a chegar

O WooCommerce envia os webhooks em segundo plano, pelo wp-cron do WordPress. Se os avisos atrasam, peça a quem cuida da loja para conferir o wp-cron.

### O pedido chegou, mas o cliente não recebeu nada no WhatsApp

Confira o telefone no contato: ele precisa ter o código do país e o DDD. Confira também se o fluxo começa com um Modelo de Mensagem aprovado. Veja [Meu webhook de entrada não recebe os dados](https://help.nextags.com.br/perguntas/integracoes/webhook-nao-recebe/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Vou ligar a minha loja WooCommerce à NexTags. Leia esta página: https://help.nextags.com.br/integracoes/woocommerce.md

Os avisos que quero mandar no WhatsApp: [pedido recebido, pagamento confirmado, pedido enviado, pedido cancelado]. Diga quais webhooks criar no WooCommerce, os caminhos (JSONPath) do telefone, do e-mail e da situação do pedido, a condição do fluxo para cada situação e um Modelo de Mensagem de utilidade para cada aviso.
```