WooCommerce no n8n: automatize pedidos da loja
Prepare a loja em HTTPS, gere a chave REST e teste com Product Get Many. Depois monte aviso de pedido novo, troca de status, estoque e relatório com o nó e o Trigger.
Por Redação Eleven Host · @robson.direitodigital · 16 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o guia: WooCommerce no n8n: automatize pedidos da loja Arte: Eleven Host
Usar o WooCommerce no n8n é ligar a sua loja a fluxos automáticos: o nó WooCommerce lê e altera clientes, pedidos e produtos pela API da loja, e o WooCommerce Trigger inicia um fluxo quando um pedido, um produto, um cliente ou um cupom muda.
A operação Delete do nó apaga de vez, sem lixeira. Para cancelar um pedido, use Update com o status Cancelled.
Atualizado em 16/11/2026. Em 16/11/2026, a versão estável do n8n na página de lançamentos do projeto é a 2.47.7, publicada em 13/11/2026.
O que é o nó WooCommerce
O WooCommerce é um plugin de e-commerce para WordPress, de código aberto e personalizável. No n8n, o nó WooCommerce consome a API dele. Ele tem o campo Resource, com três opções: Customer, Order e Product, sendo Product o padrão.
Nos três recursos, o campo Operation traz as mesmas cinco operações: Create (o padrão), Delete, Get, Get Many e Update. No editor elas aparecem como ações, por exemplo "Create an order", "Get many products" e "Get a customer".
O segundo nó é o WooCommerce Trigger, que trata eventos da loja por webhooks. Os dois usam a mesma credencial, a WooCommerce API. Cupom não é um recurso do nó de ação: ele só existe como evento do Trigger.
Quando falta uma operação no nó, a documentação do n8n indica o nó HTTP Request com a credencial do WooCommerce, escolhida em Predefined Credential Type.
Para quem serve
Serve para quem tem uma loja WooCommerce e roda o n8n na própria VPS: avisar a equipe de cada pedido novo, mudar o status de um pedido, ajustar o estoque ou montar um relatório de vendas sem abrir o painel da loja. Para quem está começando, há o guia do servidor VPS e, para planejar o orçamento da loja, o artigo Quanto custa uma loja virtual: como montar a conta.
Cada faixa de VPS tem mensalidade em reais na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver planos
Passo 1: preparar a loja
Antes de criar qualquer chave, confira duas coisas na loja. A primeira é o HTTPS: o nó envia a chave da API por Basic Auth (ou na própria URL, como se verá adiante), e por isso recomendamos a loja em HTTPS. A segunda são os links permanentes: no WordPress, em Configurações > Links permanentes (em inglês, Settings > Permalinks), escolha uma estrutura diferente de Plain. A documentação do WooCommerce sugere, por exemplo, Day and name.
Passo 2: deixar o n8n atualizado e acessível
Recomendamos manter o n8n atualizado, na 2.47.6 ou mais nova. A versão estável de hoje é a 2.47.7.
Só o WooCommerce Trigger exige mais: ele é um webhook, e quem chama é a loja. Por isso o n8n precisa ter uma URL pública em HTTPS, e a URL de webhook que ele anuncia tem de ser essa. Se ele roda atrás de um proxy, ajuste a variável de ambiente correspondente e confira o nome dela na documentação do n8n da sua versão. Se a Delivery URL for localhost ou um IP interno, a loja não consegue entregar o evento.
Passo 3: gerar a chave REST
No painel da loja, abra WooCommerce > Configurações > Avançado > REST API (WooCommerce > Settings > Advanced > REST API em inglês) e clique em Adicionar chave (Add key). Preencha a descrição e o usuário: a chave age em nome desse usuário, então recomendamos um administrador da loja.
Em Permissions, há Read, Write e Read/Write. Escolha Read/Write: as operações de escrita pedem essa permissão, e o WooCommerce Trigger também, porque ele cria e apaga o webhook na loja. Com só Read, o Trigger não funciona.
Clique em Generate API Key e copie o Consumer Key e o Consumer Secret. O Consumer Secret aparece uma única vez, então copie antes de sair da página. Se a chave vazar, use o link Revoke Key para revogá-la.
Passo 4: criar a credencial WooCommerce API
No n8n, crie a credencial WooCommerce API. Os campos são:
- Consumer Key: a chave gerada no passo anterior, que fica oculta;
- Consumer Secret: o segredo, também oculto;
- WooCommerce URL: o endereço do site WordPress, começando por
https://; - Include Credentials in Query: desligado por padrão.
Por padrão, o n8n usa Basic Auth, com a Consumer Key como usuário e o Consumer Secret como senha. Se o teste da credencial mostrar o erro Consumer key is missing, o servidor da loja não leu o cabeçalho Authorization numa conexão SSL. Nesse caso, ligue Include Credentials in Query, que envia a chave como parâmetros da URL, e teste de novo.
Passo 5: testar com Product e Get Many
Crie um workflow com gatilho manual e adicione o nó WooCommerce. Em Resource, deixe Product; em Operation, escolha Get Many; em Limit, coloque 5. Selecione a credencial e execute o nó. Se a saída trouxer até cinco produtos da loja, a conexão está certa.
O que cada recurso aceita
- Customer, Create: Email e, em Additional Fields, Billing Address, First Name, Last Name, Metadata, Password, Shipping Address e Username;
- Customer, Update: Customer ID e Update Fields, sem Password e sem Username;
- Order, Create: Additional Fields como Currency, Customer ID, Customer Note, Payment Method ID, Set Paid, Status e Transaction ID, além de Billing, Shipping, Line Items, Shipping Lines, Fee Lines, Coupon Lines e Metadata;
- Order, Update: Order ID e os mesmos campos, sem Set Paid;
- Product, Create: Name (obrigatório) e Additional Fields como Regular Price, Sale Price, SKU, Manage Stock, Stock Quantity, Stock Status, Type e Status;
- Get e Delete: pedem o ID do recurso (Customer ID, Order ID ou Product ID).
Os status de pedido, em Create e Update, são Cancelled, Completed, Failed, on-hold, Pending, Processing, Refunded e Trash. No Get Many, o Customer usa Filters (Email, Sort Order e Order By), enquanto Order e Product usam Options.
O WooCommerce Trigger
O campo Event define qual evento dispara o fluxo. Cada nó aceita um evento só. As opções são:
- cupons:
coupon.created,coupon.updatedecoupon.deleted; - clientes:
customer.created,customer.updatedecustomer.deleted; - pedidos:
order.created,order.updatedeorder.deleted; - produtos:
product.created,product.updatedeproduct.deleted.
Para reagir a mais de um evento, use um nó Trigger para cada um. Ao ativar o fluxo, o n8n cria o webhook na loja; ao desativar o fluxo, ele remove o webhook. É por isso que a chave precisa da permissão Read/Write.
Exemplos para começar
Um exemplo: aviso de pedido novo. Um nó WooCommerce Trigger com Event igual a order.created alimenta um nó de e-mail ou de planilha. Para guardar os pedidos num banco de dados, veja o artigo Banco de dados para loja virtual: como escolher.
Um exemplo: mudar o status de um pedido. Use Order com Update, informe o Order ID e, em Update Fields, escolha Status igual a Completed.
Um exemplo: ajustar o estoque. Use Product com Update, informe o Product ID e, em Update Fields, ligue Manage Stock e preencha Stock Quantity.
Um exemplo: relatório de pedidos. Use Order com Get Many, ligue Return All e, em Options, escolha Status igual a Processing e uma data em After.
Um exemplo: cadastrar um cliente. Use Customer com Create, preencha Email e, em Additional Fields, o nome e o sobrenome.
São exemplos de montagem, não fluxos testados. Confira o resultado no seu servidor e ajuste os campos ao que o seu n8n mostra. Se o Order ID ou o Product ID vier de dados externos, como o corpo de um webhook, recomendamos conferir o valor antes de passá-lo ao nó.
Passo 6: ativar o fluxo e conferir o webhook
O teste do editor usa uma URL de teste, que só vale enquanto o n8n escuta. Para a loja entregar pedidos de verdade, ative o fluxo no botão de ativação, para valer a Production URL.
Depois, volte à loja, em WooCommerce > Configurações > Avançado > Webhooks. O webhook criado pelo n8n deve aparecer com o status Active.
Se os eventos pararem de chegar
O WooCommerce desativa o webhook depois de mais de cinco falhas seguidas de entrega, e considera falha qualquer resposta que não seja 2xx, 301 ou 302. O n8n fora do ar e uma assinatura recusada com erro 401 contam como falha. Nesse caso, o status do webhook muda para Disabled e os eventos deixam de chegar até alguém reativá-lo.
Para investigar, abra WooCommerce > Status > Logs e procure a origem webhooks-delivery, onde a loja registra os eventos que disparam webhooks. Para reativar, mude o status no painel de Webhooks ou desative e ative de novo o fluxo no n8n, que recria o webhook. Depois de reativar, vale conferir no painel os pedidos desse intervalo.
Próximos passos
Com o primeiro fluxo ativo, vale acompanhar alguns pedidos reais no painel da loja e no histórico de execuções do n8n antes de criar automações maiores.
A loja traz mais de uma faixa de VPS, cada uma com a sua mensalidade. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer a loja
Perguntas frequentes
O WooCommerce Trigger funciona com o n8n só em localhost?
Não. O Trigger é um webhook, e a loja precisa alcançar a URL pública do n8n, com o fluxo ativo. Com localhost ou IP interno, a entrega não acontece.
O Delete manda o pedido para a lixeira?
Não. O Delete apaga de vez. Para pedido, use Update com o status Cancelled.
Posso receber pedidos novos e produtos alterados no mesmo Trigger?
Não. Cada nó WooCommerce Trigger aceita um único evento. Use um nó para order.created e outro para product.updated, por exemplo.