Nó Bling

O nó de workflow Bling chama a Bling API v3 — ERP brasileiro amplamente usado para pedidos de venda, produtos, contatos, estoque, ordens de compra e NF-e/NFC-e. Usa OAuth via Connected services WhatsWave; o access token é injetado automaticamente em runtime.

Node ID no editor: bling_request
Base URL: https://api.bling.com.br/Api/v3
Auth: Authorization: Bearer {{bling_access_token}} (auto-injetado do connected service)

O que faz

• Envia requisições REST autenticadas para Bling API v3
• Suporta GET, POST, PUT e DELETE
• Retorna status, data e headers
• Oferece 20+ operações pré-construídas para pedidos, produtos, contatos, estoque, NF-e e mais
• Em chamadas GET list, mescla campos Page, Limit e filtros na query string automaticamente

Pré-requisitos

1. Conta Bling com acesso à API
2. Bling conectado como Connected service na WhatsWave:
   • Configurações → API Keys → Connected services
   • Adicione Bling e complete autorização OAuth
3. O workflow deve pertencer a uma company (obrigatório para resolução de token OAuth)
4. Selecione a conta Bling conectada no campo Connected service do nó

O Bling usa OAuth 2.0 — você não armazena bling_access_token manualmente em integration keys. A WhatsWave renova e injeta o token quando o nó executa.

Como configurar

Passo 1 — Conectar Bling (OAuth)

1. Acesse Configurações → API Keys
2. Em Connected services, clique Add service → Bling
3. Faça login no Bling e autorize a WhatsWave
4. Anote o nome do connected service — você o selecionará no nó do workflow

Passo 2 — Adicionar o nó

1. Abra Automações
2. Arraste Bling da paleta ERP para o canvas
3. Em Connected service, selecione sua conexão Bling (obrigatório)

Passo 3 — Escolher operação ou endpoint customizado

Filtros de listagem (requisições GET)

Para endpoints de listagem, use os campos de filtro dedicados — a WhatsWave os mescla na query string como o Bling espera (pagina, limite, nome, etc.):

Você pode manter a URL apenas como caminho base de listagem — ex.: https://api.bling.com.br/Api/v3/pedidos/vendas — e definir filtros nos campos do nó. Campos de filtro vazios são omitidos da query.

Operações pré-construídas

Exemplo — listar pedidos recentes

• Connected service: sua conta Bling
• Operation: Listar pedidos de venda
• Data inicial: 2026-01-01
• Data final: 2026-01-31
• Página: 1
• Limite: 50

Exemplo — criar contato (POST)

• URL: https://api.bling.com.br/Api/v3/contatos
• Method: POST
• Body:

{
  "nome": "{{contact.name}}",
  "tipo": "F",
  "situacao": "A",
  "email": "{{contact.email}}",
  "celular": "{{contact.phone}}"
}

Passo 4 — Usar dados da resposta

Bling v3 tipicamente retorna { "data": [...] } para listas. Referencie em nós posteriores:

{{bling_1.data.data}}
{{bling_1.data.data[0].id}}

Use Loop ou JavaScript para processamento de arrays.

Saídas do nó

Dicas e boas práticas

• Sempre selecione Connected service — sem isso, o nó não obtém token OAuth
• Use campos de filtro em GET lists — mais limpo que montar query strings manualmente na URL
• Paginação padrão — se pagina e limite estiverem vazios, WhatsWave usa página 1 e limite 100
• Path variables — use {{pedido_id}}, {{produto_id}}, {{contato_id}} em URLs para operações get-by-ID
• Payloads NF-e são complexos — comece pela referência da API Bling e teste em conta sandbox antes de automação em produção
• Armazene Bling IDs nos contatos — salve contato_id e order IDs em custom fields para reutilização entre workflows
• Combine com E-commerce — sincronize pedidos Bling após webhooks NuvemShop/Shopify para notificações unificadas de fulfillment
• Reautorize se 401 persistir — reconecte Bling em Connected services se a grant OAuth foi revogada

Exemplos de uso

Alerta WhatsApp em novo pedido Bling

1. Schedule — a cada 15 minutos
2. Bling — listar pedidos com dataAlteracaoInicial = timestamp da última execução (armazenar em workflow variable)
3. Loop novos pedidos
4. Send WhatsApp — confirmação de pedido ao telefone do cliente a partir dos dados de contato

Notificação de estoque baixo

1. Schedule — diário
2. Bling — Consultar saldos de estoque
3. JavaScript — filtrar SKUs abaixo do limite
4. Send WhatsApp — alerta interno para equipe de operações

Criar contato Bling a partir de lead CRM

1. Webhook — card CRM movido para "Won"
2. Bling — Criar contato com nome, e-mail e telefone do lead
3. Variable — salvar contact ID retornado no custom field do card CRM

Emitir NF-e após aprovação do pedido

1. Webhook — evento interno de aprovação com pedido_id
2. Bling — Emitir NF-e com referência do pedido no body (conforme spec Bling API)
3. Condition — verificação de sucesso no HTTP status
4. Send WhatsApp — link NF-e ao cliente

FAQ

Por que erro "Select connected service"?
O nó exige conexão OAuth Bling. Conecte Bling em Configurações → API Keys → Connected services e selecione no nó.

Por que erro "Associate workflow to a company"?
Tokens OAuth são escopados por company. Garanta que o workflow executa em contexto de company (normal em workflows de produção).

Preciso definir Authorization header manualmente?
Não — a WhatsWave injeta Bearer {{bling_access_token}} do connected service. Pode manter o template de header padrão.

Por que meus query params são ignorados em POST?
Merge de query roda apenas em requisições GET para caminhos de listagem api.bling.com.br/Api/v3/. POST bodies usam o campo Body (JSON).

Posso chamar Bling API v2?
Este nó aponta para v3 (/Api/v3/). Para endpoints v2 legados, use o nó HTTP com auth manual.

Como paginar todos os pedidos?
Use Loop incrementando bling_pagina até o array data da resposta estar vazio.

Referência da API

Relacionado

• Visão geral de ERP
• Nós de e-commerce
• Nó HTTP
• Variáveis no workflow
• Como testar e depurar um workflow