kanban-pro

n8n node for Chatwoot Kanban API - Complete integration with Funnels, Kanban Items, Agents, Checklists and Scheduled Messages

Package Information

Downloads: 368 weekly / 1,390 monthly
Latest Version: 1.1.58
Author: Ygor Carrer & Stacklab Digital

Documentation

n8n-nodes-kanban-pro

Este é um n8n community node que permite integração completa com a API Chatwoot Kanban.

n8n é uma plataforma de automação de fluxo de trabalho fair-code que permite conectar qualquer coisa a tudo.

Funcionalidades

Este node fornece acesso completo a todas as funcionalidades da API Chatwoot Kanban:

📊 Funnels (6 operações)

  • Listar todos os funis
  • Criar novo funil
  • Obter detalhes de funil
  • Atualizar funil
  • Excluir funil
  • Obter estatísticas por etapa

📋 Kanban Items (14 operações)

  • Listar itens (com paginação e filtros)
  • Criar, atualizar e excluir itens
  • Mover itens entre funis/etapas
  • Mudar status (won/lost/open)
  • Reordenar itens
  • Relatórios de tempo
  • Operações em massa (mover, definir prioridade)
  • Debug de itens

👥 Agentes (4 operações)

  • Atribuir/remover agente
  • Listar agentes atribuídos
  • Atribuição em massa

✅ Checklist (5 operações)

  • Criar itens de checklist
  • Duplicar checklist
  • Buscar no checklist
  • Atribuir/remover agentes de itens do checklist

📝 Notas (1 operação)

  • Criar notas em itens

⏰ Mensagens Agendadas (4 operações)

  • CRUD completo de mensagens agendadas

Total: 34 operações em 25+ endpoints

Instalação

Via n8n Community Nodes

  1. Acesse Settings > Community Nodes
  2. Clique em Install
  3. Digite n8n-nodes-kanban-pro
  4. Clique em Install

Via NPM

npm install n8n-nodes-kanban-pro

Configuração

Credenciais

Para usar este node, você precisa configurar as credenciais:

  1. Chatwoot URL: URL completa do seu Chatwoot (ex: https://chat.minhaempresa.com)
    • ⚠️ Não inclua /api/v1 no final
  2. API Access Token: Token de acesso da API Chatwoot Kanban

Como obter o API Access Token

  1. Acesse seu Chatwoot
  2. Vá em Settings > Integrations > API
  3. Copie seu Access Token

Uso

Exemplo: Listar Funnels

  1. Adicione o node Kanban-Pro ao seu workflow
  2. Selecione Resource: Funnel
  3. Selecione Operation: Get All
  4. Informe o Account ID
  5. Execute o node

Exemplo: Criar Kanban Item

  1. Adicione o node Kanban-Pro ao seu workflow
  2. Selecione Resource: Kanban Item
  3. Selecione Operation: Create
  4. Preencha os campos obrigatórios:
    • Account ID
    • Funnel ID
    • Stage ID
    • Title
  5. Execute o node

Recursos

Desenvolvimento

Pré-requisitos

  • Node.js >= 16.x
  • npm >= 8.x

Setup

# Clone o repositório
git clone https://github.com/seu-usuario/n8n-nodes-kanban-pro.git
cd n8n-nodes-kanban-pro

# Instale as dependências
npm install

# Build
npm run build

# Desenvolvimento com watch
npm run dev

Estrutura do Projeto

n8n-nodes-kanban-pro/
├── credentials/
│   └── KanbanProApi.credentials.ts
├── nodes/
│   └── KanbanPro/
│       ├── KanbanPro.node.ts
│       └── kanban-pro.svg
├── package.json
├── tsconfig.json
└── README.md

Licença

MIT

Suporte

Para reportar bugs ou solicitar funcionalidades, abra uma issue no GitHub.

Contribuindo

Contribuições são bem-vindas! Por favor, leia o guia de contribuição antes de submeter um PR.

Discussion