Chatwoot-Kanban — a Kanban board with task management for Chatwoot CRM

[CrisAlva1414]

Hey everyone!

I built and open-sourced Chatwoot-Kanban, a Kanban board and task management integration for Chatwoot CRM. It runs as a Dashboard App (iframe) inside the agent conversation view.

What it does

• Drag-and-drop Kanban board — pipeline stages map directly to Chatwoot contact custom attributes. Move contacts between columns and they sync instantly.
• Bidirectional sync — custom attributes (pipeline_01_etapas, kanban_view_mensaje, kanban_view_fecha_termino) are read from and written to Chatwoot via REST API and webhooks.
• Task management — one task per contact with automatic lifecycle states (active → due today → overdue → closed). Cron-driven transitions.
• Webhook receiver — handles contact_updated and conversation_updated events with HMAC signature verification.
• Agent dashboard — stats per agent: tasks created, closed, overwritten. Full audit history.
• Dark mode — light/dark theme following system preference.

How it integrates with Chatwoot

Everything lives in Chatwoot custom attributes — no separate pipeline system:

Chatwoot Contact
├── pipeline_01_etapas        ← Kanban column (synced on drag & drop)
├── kanban_view_mensaje       ← Task description (bg sync after create/edit/close)
└── kanban_view_fecha_termino ← Task due date

The board polls Chatwoot API (filtered by pipeline stage) and webhooks keep it synchronized across agents in real time.

Tech Stack

• Python 3.12 / FastAPI
• PostgreSQL 16 via asyncpg
• Vanilla JavaScript SPA (no framework)
• Docker multi-arch builds to GHCR

Quick Start

git clone https://github.com/CrisAlva1414/Chatwoot-Kanban.git
cp .env.example .env
docker network create chatwoot_shared
docker compose up -d

Then install as Dashboard App in Chatwoot pointing to https://your-domain/kanban.

Links

• 🏠 Repo: https://github.com/CrisAlva1414/Chatwoot-Kanban
• 📖 License: MIT

Feedback and contributions welcome!

[Kairon-ag]

Hola Cristian, ¿cómo estás?

Vi tu proyecto Chatwoot-Kanban y me pareció muy interesante. Trabajo con Chatwoot + n8n en proyectos de automatización para clientes y estamos buscando justamente algo sencillo: mantener Chatwoot como la interfaz principal y tener un Kanban visual para organizar los leads, mientras n8n se encarga de las automatizaciones, follow-ups y movimientos automáticos del pipeline.

La idea sería poder replicarlo en diferentes proyectos de clientes que todavía no tienen CRM, sin agregarles una herramienta compleja.

¿Crees que Chatwoot-Kanban, tal como está actualmente, encaja bien con este tipo de uso? ¿Lo estás utilizando actualmente en algún entorno real?

Me gustaría probarlo y conocer un poco más tu experiencia con el proyecto.

[CrisAlva1414]

Hola Kairon, bien y tu?

el proyecto al momento donde lo hice publico esta bastante operativo, sobretodo por que los últimos commits hice muchas optimizaciones de seguridad... efectivamente lo que buscas es lo que desarrolle, si lo vendes a terceros sera genial porque use el mismo frontend que el proyecto entonces no parece una integración o app externa, ahora bien, el proyecto lo hice para un cliente personal que queria migrar de un CRM privado a uno publico, este con los meses se dio cuenta que no era lo que buscaba y cerramos el proyecto, para no perder un proyecto tan noble como este lo publique para que la comunidad lo pueda usar... puedes contactarme para ver algunos datos adicionales, ya que, es una integración dockerizada que se integra por medio de las Dashboard apps y la forma de publicarlas para los distintos clientes es importante, no olvides dar upvote al proyecto para que mas gente la vea

[SmarterCL]

Hola Cristian; consulta demo hay; video o imagen ?

[CrisAlva1414]

te agrego algunas de las fotografías para que veas como funciona el complemento