n8n-nodes-kanbanparachatwoot

Community node do n8n para a API do Kanban da StackLab/Chatwoot.

O que está incluído

O node StackLab Kanban expõe as 47 operações documentadas em roadmap_kanban/docs/openapi.yml, incluindo funis, itens, movimentação, agentes, notas, checklist, importação/exportação, relatórios e operações em massa.

Cada execução recebe campos dinâmicos em português, conforme a operação selecionada:

• Operação: operação correspondente ao operationId do OpenAPI;
• Parâmetros de caminho: campos como ID do item e ID do funil;
• Parâmetros de consulta: filtros e paginação;
• Corpo da requisição: campos individuais conforme o schema da operação.

Os campos avançados em JSON ficam disponíveis apenas para estruturas especiais ou endpoints de importação.

Exemplo de parâmetros:

{
  "id": 123
}

O account_id é obtido da credencial e nunca é aceito como parâmetro livre do workflow, reduzindo o risco de acessar outra conta.

Credencial

Crie uma credencial API StackLab Kanban com:

1. URL base da instalação, sem /api/v1 e sem barra final;
2. ID da conta;
3. Token de acesso da API.

O node envia o token no header api_access_token e prefixa as rotas com /api/v1.

Desenvolvimento

npm install
npm run build
npm test

Para instalar localmente em uma instância n8n self-hosted, execute npm pack e instale o .tgz como community node, ou use o diretório de custom nodes da instância durante o desenvolvimento.

Fonte do contrato

As operações em src/operations.ts são mantidas alinhadas com:

/Users/macbookpro/Documents/develop/repos/roadmap_kanban/docs/openapi.yml

Quando o OpenAPI mudar, atualize a lista de operações, execute o build e rode os testes de cobertura antes de publicar uma nova versão.