kanban

Nós comunitários do n8n para a API Kanban (cards, databases e webhooks).

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.3
Author: Rentatec

Available Nodes

Documentation generating…

Kanban icon
Kanban
Consome a API Kanban v1 (cards, databases e metadados)
Kanban Trigger icon
Kanban Trigger
Dispara fluxos a partir de webhooks da API Kanban

Documentation

n8n-nodes-kanban

Community node do n8n para a API Kanban v1. Permite criar, buscar e atualizar cards/registros e disparar fluxos a partir dos webhooks do Kanban.

Repositório: github.com/RentatecDev/n8n-kanban

O backend Laravel não muda. Este pacote só consome /api/v1/kanban.

Instalação

No n8n (self-hosted):

npm install n8n-nodes-kanban

Ou copie esta pasta para o diretório de nós customizados e aponte a variável:

N8N_CUSTOM_EXTENSIONS=/caminho/para/n8n-nodes-kanban

Depois:

cd n8n-nodes-kanban
npm install
npm run build

Reinicie o n8n. Os nós Kanban e Kanban Trigger aparecem na paleta.

Credenciais

Crie um token em Integrações no Kanban (começa com kb_) e preencha:

Campo Exemplo
Base URL https://kanban.rentatec.com.br
Token de Integração kb_...

O teste da credencial chama GET /api/v1/kanban/processes.

Operações (nó Kanban)

  • Process: listar processos
  • Field: listar campos de um processo ou database
  • Responsible: listar responsáveis
  • Card: obter, listar, buscar, criar, atualizar e mover
  • Database Record: obter, listar, buscar, criar e atualizar

Trigger

O Kanban Trigger cadastra um webhook no Kanban ao ativar o fluxo e remove (desativa) ao desativar.

Eventos:

  • card.created
  • card.moved
  • field.created
  • field.updated
  • comment.created
  • comment.updated

A assinatura HMAC SHA-256 (X-Kanban-Signature) é validada com o secret retornado na criação do webhook.

Em card.moved, a opção Enriquecer Card Moved busca o card completo na API, porque o payload nativo não inclui o card inteiro.

O n8n precisa estar acessível pela URL pública usada no webhook. Instalações locais exigem túnel (Cloudflare, ngrok, etc.).

Desenvolvimento

npm install
npm run build

O npm run dev usa o n8n mais recente e exige Node >=22.22.

Neste projeto, com Node 22.15, use:

$env:N8N_CUSTOM_EXTENSIONS = (Resolve-Path .).Path
$env:N8N_USER_FOLDER = (Resolve-Path ..\.n8n-local).Path
$env:N8N_SECURE_COOKIE = "false"
npm run start:n8n

Abra http://localhost:5678 — os nós Kanban e Kanban Trigger aparecem na paleta.

Observações

  • Ações feitas pela API não disparam webhook de volta (proteção contra loop).
  • IDs de card/processo vão no body da API, não na URL. O nó esconde isso.
  • A API v2 (JWT) ainda não está neste pacote.

Recursos

Discussion