Nó NuvemShop

O nó de workflow NuvemShop é um cliente REST para a API Nuvemshop / Tiendanube. Use-o para listar e gerenciar pedidos, produtos e clientes da sua loja Nuvemshop dentro de automações.

Node ID no editor: nuvemshop_request
URL padrão: GET https://api.nuvemshop.com.br/v1/{{nuvemshop_store_id}}/orders.json

O que faz

• Envia requisições HTTP autenticadas para a API Nuvemshop
• Suporta GET, POST, PUT e DELETE
• Retorna HTTP status, data da resposta e headers da resposta
• Auth padrão: Authentication: bearer {{nuvemshop_access_token}}

Pré-requisitos

1. Uma loja Nuvemshop
2. Store ID (nuvemshop_store_id) — identificador numérico da sua loja
3. Access token do app Nuvemshop / integração OAuth
4. Integration keys em Configurações → API Keys:
   • nuvemshop_store_id
   • nuvemshop_access_token

Como configurar

Passo 1 — Definir credenciais

Adicione integration keys com os nomes exatos acima. O token é enviado no header Authentication (convenção Nuvemshop — não Authorization).

Passo 2 — Adicionar o nó

1. Abra Automações e edite seu workflow
2. Na paleta, abra E-commerce
3. Arraste NuvemShop para o canvas

Passo 3 — Escolher operação ou configurar manualmente

Templates de operação integrados

Exemplo — criar cliente (POST):

{
  "customer": {
    "firstname": "{{contact.first_name}}",
    "lastname": "{{contact.last_name}}",
    "email": "{{contact.email}}",
    "phone": "{{contact.phone}}"
  }
}

Todos os campos suportam workflow variables.

Passo 4 — Usar dados da resposta

Order total: {{nuvemshop_1.data.total}}
Customer email: {{nuvemshop_1.data.customer.email}}

Inspecione o histórico de execução para os caminhos exatos da resposta.

Saídas do nó

Dicas e boas práticas

• A Nuvemshop usa header Authentication: bearer TOKEN — não troque para Authorization a menos que a documentação da API exija
• Armazene nuvemshop_store_id como integration key para URLs consistentes entre workflows
• Configure webhooks Nuvemshop para eventos de pedido em tempo real; use este nó para buscar detalhes completos após o webhook
• Paginate listas grandes com query params (page, per_page) conforme a documentação da API
• Combine com nós Loop ao processar múltiplos pedidos de uma resposta em lista

Exemplos de uso

Notificação WhatsApp em novo pedido

1. Webhook — Nuvemshop order/created
2. NuvemShop GET — buscar pedido por ID do payload do webhook
3. Send WhatsApp — "Obrigado {{contact.name}}! Pedido #{{nuvemshop_1.data.number}} confirmado."

Sincronizar cliente a partir de lead WhatsApp

1. WhatsWave Agent — captura nome, e-mail, telefone
2. NuvemShop POST — criar cliente
3. CRM update — armazenar Nuvemshop customer ID no contato

FAQ

Por que 401 Unauthorized?
Access token expirado ou incorreto. Regenere o token nas configurações do app Nuvemshop e atualize nuvemshop_access_token.

Por que a URL mostra {{nuvemshop_store_id}} sem resolver?
Adicione nuvemshop_store_id como integration key ou workflow variable.

Posso atualizar status do pedido via este nó?
Sim — use PUT no endpoint de pedido conforme documentação de pedidos Nuvemshop.

Isso difere do nó HTTP?
Pré-configurado com base URL Nuvemshop, template de auth header e atalhos de operação comuns.

Referência da API

Relacionado

• Visão geral de E-commerce
• Webhook trigger
• Variáveis no workflow