loomi-kanban-board

n8n community node for Kanban Board API integration

Package Information

Downloads: 273 weekly / 390 monthly
Latest Version: 0.1.5
Author: Kanban Board

Available Nodes

Loomi icon
Loomi
Interact with Loomi API — manage cards, columns, tags and comments

Documentation

n8n-nodes-loomi-kanban-board

Node comunitário do n8n para integrar com o Loomi — Kanban Board com API integrada.

Gerencie projetos, colunas, cards, tags e comentários diretamente nos seus workflows do n8n.

📦 Instalação

Via Painel do n8n (recomendado)

  1. Vá em Settings → Community Nodes
  2. Clique em Install a community node
  3. Digite: n8n-nodes-loomi-kanban-board
  4. Clique em Install

Via CLI

# Na pasta do n8n (geralmente ~/.n8n)
cd ~/.n8n
npm install n8n-nodes-loomi-kanban-board

Via Docker

# Adicione no seu Dockerfile ou docker-compose
RUN cd /home/node/.n8n && npm install n8n-nodes-loomi-kanban-board

Link local (para desenvolvimento)

# Na pasta do node
cd n8n-nodes-kanban
npm install
npm run build
npm link

# Na pasta do n8n
cd ~/.n8n
npm link n8n-nodes-loomi-kanban-board

🔑 Configuração de Credenciais

  1. No n8n, vá em Credentials → Add credential
  2. Procure por Kanban Board API
  3. Preencha:
    • Base URL: URL do seu Kanban (ex: https://app.loomiboard.com.br)
    • API Key: Chave gerada no painel do Kanban (formato kb_...)

Para gerar uma API Key:

  1. Acesse o Kanban Board → selecione um projeto
  2. Clique em API Key no header do board
  3. Copie a chave gerada

🧩 Recursos Disponíveis

📋 Card

Operação Descrição
Criar Cria um novo card em uma coluna (via api_alias)
Obter Busca um card pelo ID
Atualizar Atualiza título, descrição, telefone, metadata, etc
Excluir Remove um card
Mover Move o card para outra coluna

📊 Coluna

Operação Descrição
Listar Lista todas as colunas de um projeto (com cards)
Criar Cria uma nova coluna com título e api_alias
Atualizar Renomeia uma coluna
Excluir Remove uma coluna e seus cards

📁 Projeto

Operação Descrição
Listar Lista todos os projetos
Criar Cria um projeto (tipo: leads ou tarefas)
Atualizar Renomeia um projeto
Excluir Remove um projeto e tudo associado

🏷️ Tag

Operação Descrição
Listar Lista tags de um projeto
Criar Cria uma tag com nome e cor
Excluir Remove uma tag
Vincular ao Card Associa uma tag a um card
Desvincular do Card Remove a associação

💬 Comentário

Operação Descrição
Listar Lista comentários de um card
Criar Adiciona um comentário
Excluir Remove um comentário

🔄 Exemplos de Workflow

Lead via Webhook → Card no Kanban

[Webhook] → [Kanban Board: Criar Card]

Configure o node Kanban Board:

  • Recurso: Card
  • Operação: Criar
  • API Alias: novo-lead
  • Título: {{ $json.nome }}
  • Campos adicionais:
    • Telefone: {{ $json.telefone }}
    • Descrição: {{ $json.mensagem }}

Mover card quando form é preenchido

[Webhook] → [Kanban Board: Mover Card]
  • Recurso: Card
  • Operação: Mover
  • Card ID: {{ $json.card_id }}
  • Column ID (Destino): ID da coluna alvo

Adicionar comentário automático

[Trigger] → [Kanban Board: Criar Comentário]
  • Recurso: Comentário
  • Operação: Criar
  • Card ID: {{ $json.card_id }}
  • Conteúdo: Atualização automática: {{ $json.status }}

🛠 Desenvolvimento

# Clonar e instalar
git clone <repo>
cd n8n-nodes-kanban
npm install

# Build
npm run build

# Watch mode
npm run dev

# Link para testar no n8n local
npm link
cd ~/.n8n && npm link n8n-nodes-loomi-kanban-board

📄 Licença

MIT

Discussion