Nó Shopify

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

Node ID no editor: shopify_request
URL padrão: GET https://{{shopify_shop}}/admin/api/{{shopify_api_version}}/orders.json

O que faz

• Envia requisições HTTP autenticadas para a Shopify Admin API da sua loja
• Suporta GET, POST, PUT e DELETE
• Retorna HTTP status, data da resposta e headers da resposta
• Auth: X-Shopify-Access-Token: {{shopify_access_token}}
• Suporte a connected service — selecione um Shopify service e o engine injeta token, shop domain e API version automaticamente

Pré-requisitos

1. Uma loja Shopify
2. Shopify app com acesso à Admin API (custom app ou public app)
3. Connected Shopify service em Configurações → API Keys → Services — recomendado
   • Client ID e Client Secret do seu Shopify app
   • A WhatsWave gerencia a renovação do access token (tokens expiram a cada ~24 horas)

Alternativamente, defina workflow/integration variables manualmente:

• shopify_access_token
• shopify_shop — domínio da loja (ex.: mystore.myshopify.com)
• shopify_api_version — ex.: 2024-10

Como configurar

Passo 1 — Conectar Shopify service (recomendado)

1. Acesse Configurações → API Keys → Services
2. Conecte Shopify com o Client ID e Client Secret do seu app
3. Autorize o app para sua loja

O engine de workflow resolve um access token válido em runtime e injeta shopify_shop e shopify_api_version a partir dos metadados do serviço.

Passo 2 — Adicionar o nó

1. Abra Automações
2. Arraste Shopify de E-commerce para o canvas

Passo 3 — Selecionar connected service

Templates de operação integrados

Exemplo — buscar cliente por e-mail:

• URL: .../customers/search.json?query=email:{{contact.email}}
• Method: GET

Exemplo — atualizar nota do pedido (PUT body):

{
  "order": {
    "id": {{variables.order_id}},
    "note": "Notificado via WhatsApp em {{date:today}}"
  }
}

Passo 4 — Usar dados da resposta

Order name: {{shopify_1.data.order.name}}
Customer phone: {{shopify_1.data.order.customer.phone}}
Line items: {{shopify_1.data.orders[0].line_items}}

A Shopify encapsula recursos — GET único retorna { "order": {...} }, listas retornam { "orders": [...] }.

Saídas do nó

Dicas e boas práticas

• Use connected service em vez de colar tokens — Admin tokens da Shopify expiram a cada 24h; a WhatsWave os renova automaticamente
• Fixe uma API version (ex.: 2024-10) — a Shopify descontinua versões antigas em cronograma definido
• Registre Shopify webhooks para orders/create, orders/fulfilled; use este nó para enriquecer payloads de webhook
• Respeite Shopify rate limits — adicione nós Delay em loops de alto volume
• Customer search suporta sintaxe de query: email:, phone:, tag:

Exemplos de uso

Notificação de fulfillment no WhatsApp

1. Webhook — Shopify orders/fulfilled
2. Shopify GET — pedido com fulfillments
3. Send WhatsApp — número de rastreamento do fulfillment

Consulta do agente — histórico de pedidos por telefone

1. WhatsWave Agent — cliente informa e-mail
2. Shopify GET — customer search
3. Shopify GET — orders by customer ID
4. Agent — resumir pedidos recentes

FAQ

Por que 401 Unauthorized?
Access token expirado. Conecte um Shopify service para a WhatsWave renovar o token, ou atualize o token manualmente.

Preciso definir shopify_shop manualmente?
Não ao usar connected service — o engine injeta a partir dos metadados do serviço.

Por que minha API version está errada?
Defina shopify_api_version nos metadados do serviço ou em workflow variables. Use uma versão Shopify suportada.

REST vs GraphQL?
Este nó usa Admin REST API. Para GraphQL, use o nó genérico GraphQL com o endpoint da Shopify.

O que difere dos outros nós de e-commerce?
Shopify é o único nó de e-commerce com suporte a connected service e renovação automática de token.

Referência da API

Relacionado

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