loomi-kanban-board

n8n community node for Loomi: cards, boards, sharing, archiving and monthly reports

Package Information

Released: 1 mo ago
Downloads: 16 weekly / 59 monthly
Latest Version: 0.2.0
Author: Kanban Board

Available Nodes

Loomi icon
Loomi
Interact with Loomi API: cards, columns, boards, members, tags, comments and monthly reports

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, membros, tags e comentários e gere relatórios mensais 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 Loomi 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, acesse o painel do Loomi e crie uma chave em Chaves de API.
A chave dá acesso a todos os boards da sua conta (inclusive os compartilhados com você), então
informe o Project ID em cada operação. Para pegar o ID, use Copiar ID do projeto no menu do board.

🧩 Recursos Disponíveis

📋 Card

Operação Descrição
Criar Cria um novo card em uma coluna (via api_alias + Project ID)
Obter Busca um card pelo ID
Listar Lista cards por api_alias, coluna ou projeto. Arquivados ficam de fora, a menos que você escolha incluí-los
Atualizar Atualiza título, descrição, telefone, origem do lead, metadata, etc. A metadata existente é preservada
Excluir Remove um card definitivamente
Mover Move o card para outra coluna do mesmo board, por api_alias ou ID
Arquivar Tira o card do board sem apagar (continua no relatório do dashboard)
Restaurar Devolve um card arquivado para o board

📊 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
Limpar Arquiva todos os cards da coluna de uma vez (não apaga)

📁 Projeto

Operação Descrição
Listar Lista seus projetos e os compartilhados com você (campo role: owner, editor ou viewer)
Criar Cria um projeto (tipo: leads ou tarefas)
Atualizar Renomeia um projeto
Excluir Remove um projeto e tudo associado

👥 Membro

Operação Descrição
Listar Lista o dono e os membros do board (campo status: accepted ou pending)
Convidar Compartilha o board com um e-mail, com permissão Pode editar ou Pode ver (só o dono)
Alterar Permissão Muda a permissão de um membro (só o dono)
Remover Remove o acesso ou cancela um convite pendente

📈 Relatório

Operação Descrição
Mensal Novos cards do mês, leads x tarefas, comparação com o mês anterior, totais por board e por origem do lead

Exemplo de saída:

{
  "month": "2026-09",
  "total": 128,
  "leads": 97,
  "tarefas": 31,
  "archived": 12,
  "previous_month_total": 110,
  "change_pct": 16.4,
  "by_lead_source": { "whatsapp": 54, "instagram": 30, "nao_informada": 13 },
  "by_project": [
    { "project_id": "…", "name": "Comercial", "type": "leads", "new_cards": 97, "previous_month": 80, "change_pct": 21.3, "cards_on_board": 40 }
  ]
}

Permissões: quem tem acesso Pode ver a um board compartilhado consegue ler, mas não criar, editar, arquivar ou excluir. Essas operações retornam 403.

🏷️ 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
  • Project ID: ID do board de leads
  • 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 }}
  • Mover Para: API Alias da Coluna
  • API Alias (Destino): qualificado

Relatório mensal por e-mail

[Schedule: dia 1, 08:00] → [Loomi: Relatório Mensal] → [Gmail/Slack]
  • Recurso: Relatório
  • Operação: Mensal
  • Mês: {{ $now.minus({ months: 1 }).toFormat("yyyy-MM") }} (mês que acabou de fechar)
  • Fuso Horário: -03:00

Limpar a coluna "Perdidos" toda segunda-feira

[Schedule: segunda, 07:00] → [Loomi: Limpar Coluna]
  • Recurso: Coluna
  • Operação: Limpar
  • Column ID: ID da coluna

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