Nó WooCommerce

O nó de workflow WooCommerce é um cliente REST para a WooCommerce REST API. Use-o para consultar e gerenciar pedidos, produtos e clientes da sua loja WordPress/WooCommerce.

Node ID no editor: woocommerce_request
URL padrão: GET https://{{woocommerce_store}}/wp-json/wc/v3/orders

O que faz

• Envia requisições HTTP para a REST API da sua loja WooCommerce (/wp-json/wc/v3/)
• Suporta GET, POST, PUT e DELETE
• Retorna HTTP status, data da resposta e headers da resposta
• Autentica via consumer key e consumer secret na query string da URL

Pré-requisitos

1. Loja WooCommerce com REST API habilitada
2. REST API keys em WooCommerce → Settings → Advanced → REST API
3. Integration keys em Configurações → API Keys:
   • woocommerce_store — domínio da loja sem https:// (ex.: loja.example.com)
   • woocommerce_consumer_key — começa com ck_
   • woocommerce_consumer_secret — começa com cs_

Como configurar

Passo 1 — Gerar REST API keys

No admin WooCommerce, crie uma key com permissões Read/Write (ou Read-only se só buscar dados). Copie consumer key e secret imediatamente — o secret é exibido uma única vez.

Passo 2 — Definir credenciais

Adicione as três integration keys listadas acima. Templates integrados acrescentam ?consumer_key=...&consumer_secret=... a toda URL automaticamente.

Passo 3 — Adicionar e configurar o nó

Templates de operação integrados

Exemplo — criar produto (POST body):

{
  "name": "{{variables.product_name}}",
  "regular_price": "{{variables.price}}",
  "description": "{{variables.description}}"
}

Auth alternativa: você pode usar Basic auth nos headers em vez de query params:

{"Authorization": "Basic base64(consumer_key:consumer_secret)"}

Passo 4 — Usar dados da resposta

Order status: {{woocommerce_1.data.status}}
Billing phone: {{woocommerce_1.data.billing.phone}}

Saídas do nó

Dicas e boas práticas

• Garanta HTTPS na loja — WooCommerce REST API exige SSL em produção
• Use keys Read/Write apenas quando workflows precisarem criar ou atualizar recursos
• Filtre pedidos com query params: ?status=processing&after=2026-01-01T00:00:00
• Webhooks WooCommerce (Settings → Advanced → Webhooks) combinam bem com este nó para fluxos orientados a eventos
• Para catálogos grandes, pagine com page e per_page nos query parameters

Exemplos de uso

Notificação de pedido enviado

1. Webhook — WooCommerce order.updated quando status = completed
2. WooCommerce GET — detalhes do pedido
3. Send WhatsApp — "Seu pedido #{{woocommerce_1.data.number}} foi enviado!"

Criar cliente a partir do CRM

1. CRM trigger — novo lead com e-mail
2. WooCommerce POST — /customers
3. Variable — salvar woocommerce_1.data.id no contato

FAQ

Por que 401 ou 403?
Consumer key/secret inválidos, permissões insuficientes da key ou REST API desabilitada. Regenere keys com escopo Read/Write correto.

Posso usar HTTP Basic auth em vez de query params?
Sim — sobrescreva Headers (JSON) com ck:cs codificado em Base64. Templates integrados usam auth por query string por padrão.

Por que a resposta é HTML em vez de JSON?
URL da loja incorreta, problemas de permalink ou plugin de segurança bloqueando REST API. Verifique /wp-json/wc/v3/ no navegador.

Funciona com WooCommerce HPOS?
Sim — a REST API abstrai o armazenamento de pedidos. Use endpoints padrão /orders.

Referência da API

Relacionado

• Visão geral de E-commerce
• Webhook trigger
• Nó HTTP