E-commerce

Os nós de workflow de e-commerce permitem consultar pedidos, produtos, clientes, anúncios e dados de frete — ou acionar ações logísticas — diretamente nas Automações, sem montar requisições HTTP brutas do zero.

Cada nó é um cliente REST pré-configurado para uma plataforma específica. Escolha um template de operação integrado (listar pedidos, obter produto, cotar frete, etc.) ou configure URL, method, headers e body manualmente. Use a resposta em mensagens WhatsApp, atualizações de CRM, loops ou etapas seguintes.

Figura 1: Nós de E-commerce na paleta do editor de workflow

Nós disponíveis

Quando usar nós de e-commerce

• Notificar clientes no WhatsApp quando o status do pedido muda (pago, enviado, entregue)
• Sincronizar catálogo ou estoque entre sua loja e outros sistemas em agendamento
• Cotar frete ou gerar etiquetas após confirmação de pagamento
• Responder perguntas de marketplace ou trazer detalhes de pedidos do Mercado Livre / Shopee para cards do CRM
• Evitar nós HTTP genéricos quando a plataforma já está suportada na paleta

Credenciais (todas as plataformas)

A maioria dos nós de e-commerce autentica usando integration keys armazenadas nas configurações da empresa:

1. Abra Configurações → API Keys
2. Em Integration keys, adicione chaves com os nomes exatos de variável exigidos pelo nó (por exemplo vtex_app_key, nuvemshop_access_token, frenet_token)
3. No editor de workflow, abra o painel Variables → aba Workflow e confirme que as mesmas chaves existem (ou adicione-as lá se preferir secrets no escopo do workflow)
4. O template do nó injeta credenciais nos headers da requisição ou nos query params da URL automaticamente via {{variables.<key_name>}}

Exceção Shopify: conecte um Shopify service em Configurações → API Keys → Services. Selecione o serviço conectado no nó; o engine injeta shopify_access_token, shop domain e API version automaticamente (token renovado a cada 24h).

Nunca cole secret keys diretamente nos campos do nó no canvas — use sempre integration keys, connected services ou workflow variables.

Padrões de fluxo típicos

Notificação de status do pedido

1. Webhook trigger — a loja envia order.updated ou evento equivalente
2. Nó de e-commerce — buscar detalhes completos do pedido (GET order by ID)
3. Condition — ramificar por status (shipped, delivered, etc.)
4. Send message — WhatsApp com link de rastreamento de {{ecommerce_node.data}}

Sincronização de catálogo agendada

1. Schedule trigger — diariamente às 6:00
2. Nó de e-commerce — listar produtos
3. Loop — iterar sobre os itens
4. HTTP / ERP node — upsert no sistema externo

Frete pós-pagamento

1. Webhook trigger — pagamento confirmado
2. Nó de e-commerce — obter pedido com endereço de entrega
3. Frenet ou Melhor Envio — cotar frete
4. Melhor Envio — adicionar ao carrinho, gerar etiqueta
5. Send WhatsApp — código de rastreamento ao cliente

Saídas do nó e variáveis

Todos os nós de e-commerce expõem:

Referencie campos aninhados em nós posteriores:

{{nuvemshop_1.data}}
{{shopify_1.data.orders[0].name}}
{{input.data.trackingCode}}

Use o node ID exibido no canvas, ou {{input.data}} quando o nó anterior for a etapa de e-commerce. Para parsing complexo, adicione um nó JavaScript ou Variable.

Consulte Variáveis no workflow para a sintaxe completa.

Templates de operação integrados

Ao adicionar um nó de e-commerce, o editor oferece templates de operação (atalhos) para chamadas comuns de API — por exemplo "List orders" ou "Quote shipping". Selecionar um template pré-preenche URL, method, headers e body. Você ainda pode editar qualquer campo ou trocar para um endpoint customizado.

Guias relacionados

• Nós de pagamentos — gateways de cobrança e checkout
• Nós de ERP — gestão empresarial e financeira
• Webhooks recebidos
• Como testar e depurar um workflow
• Visão geral dos tipos de nós