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