Chatwoot Kanban: funis de venda e agendamento de mensagens

O Chatwoot open source não tem Kanban nativo, mas dá para adicionar um Chatwoot Kanban gratuito pela página Dashboard Scripts, com funis, etapas e agendamento de mensagens.

Quem usa o Chatwoot open source sente falta de um Chatwoot Kanban: uma tela de funil onde cada conversa vira um card e você enxerga em que etapa cada cliente está. O Chatwoot transfere conversas entre pessoas e setores muito bem, mas não mostra o pipeline de vendas. Para isso, muita gente acaba pagando outro CRM ou trocando de plataforma.

Eu desenvolvi aqui na Astra Online um Kanban que entra no Chatwoot sem alterar o código dele, usando um recurso chamado Dashboard Scripts. Neste artigo eu explico como ele funciona, o que ele adiciona (funis, aba de conexões e agendamento de mensagens), o que você precisa ter antes de instalar e os erros que mais vejo na instalação.

Por que o Chatwoot precisa de um Kanban

O Chatwoot organiza o atendimento por caixas de entrada, abas (minhas, não atribuídas, todas) e etiquetas. Funciona bem para suporte. Para venda, falta a visão de funil: quantos leads estão em negociação, quem está parado, quem já fechou.

Com o Kanban, cada conversa pode ser associada a um funil e a uma etapa. Você arrasta o card conforme o cliente avança, sem sair do Chatwoot. Se você ainda está conhecendo a plataforma, comece pelo guia do que é o Chatwoot e como funciona.

Como o Kanban entra no Chatwoot sem mexer no código

O Chatwoot permite injetar código pela página de Dashboard Scripts. Eu construí o Kanban inteiro por ali: funil, agendamento e conexões. Isso traz duas vantagens práticas:

• não precisa rebuildar o Chatwoot nem editar o código dele;
• se der problema, você remove o script e o Chatwoot volta ao normal.

Um cuidado: o Kanban conecta direto no banco de dados do Chatwoot, então precisa rodar no mesmo servidor dele.

O Kanban roda como um projeto à parte, com backend, frontend e um banco PostgreSQL próprio, e "abraça" o Chatwoot: conecta no banco de dados dele e consome os recursos que ele já tem. Mexer direto no código do Chatwoot também é possível, mas dá muito mais trabalho, porque cada alteração exige um novo build.

O que é gratuito e o que não é

Deixo claro o que é gratuito porque sempre aparece a pergunta:

A maioria das pessoas só precisa usar o Kanban, e isso é de graça. O código-fonte serve para quem quer criar funções novas.

Pré-requisitos antes de instalar

Antes de começar, confira:

1. Chatwoot rodando em Docker Swarm com Portainer e Traefik, no formato que eu ensino no canal. O passo a passo está em como instalar o Chatwoot.
2. Acesso à página de Dashboard Scripts. Ela é uma URL oculta que você abre logado como super admin. No vídeo eu mostro que ela só abre quando os recursos Enterprise estão ativos na instalação. Sem isso, não tem como colar o script.
3. Um subdomínio novo para o Kanban, apontado para a sua VPS (eu uso o Cloudflare).
4. A URL e a chave global da sua Evolution API, se quiser usar a aba de conexões.
5. Versão do Chatwoot compatível. O Kanban foi construído sobre a 4.9.1, versão que eu usava na gravação, em janeiro de 2026. Testei também na 4.8 e na 4.5 e funcionou. Em outras versões pode funcionar ou não. Se aparecer bug, confira a versão primeiro.

Passo a passo da instalação

1. Abra a stack do Kanban (está na página de apoio) num editor de texto.
2. Use o substituir tudo (Ctrl+H, no Sublime Text ou no próprio bloco de notas) para trocar a URL de exemplo do Kanban pela sua.
3. Repita para a URL do Chatwoot.
4. Preencha a URL da Evolution e a chave global, que está na stack da Evolution.
5. Confira a rede: se você instalou com outra rede que não a dos tutoriais do canal, ajuste na stack.
6. No Portainer, crie uma nova stack, cole o conteúdo, desabilite o Access Control e faça o deploy. Vão subir backend, frontend e banco.
7. Abra o arquivo do script, troque a URL de exemplo pela URL do seu Kanban, também com substituir tudo.
8. Logado como super admin, abra a página de Dashboard Scripts, cole o script e clique em submit.
9. Atualize o Chatwoot. O item Kanban aparece no menu lateral.

Na gravação eu subi a versão 0.0.2 do backend e do frontend. As atualizações saem pelo Docker Hub, e você puxa na sua VPS quando quiser.

Funis e etapas do Kanban

O Kanban já vem com um funil padrão que espelha os status do Chatwoot: aberto, pendente e resolvido. Esse funil não pode ser apagado, só ganhar colunas novas.

Os funis que você cria são 100% editáveis. Nas configurações você:

• cria funis e escolhe a cor;
• define quais agentes veem cada funil, ou deixa público;
• renomeia, cria e apaga etapas (ele já cria três colunas para você editar);
• marca uma etapa para receber automaticamente todos os tickets novos;
• configura a passagem entre funis: quando o card chega ao fim de um funil, ele é criado numa etapa de outro.

Dentro de cada card dá para adicionar tarefas e anexos e agendar mensagens. Também dá para filtrar a visão por caixa de entrada.

Agendamento de mensagens direto do ticket

Dentro da conversa aparece um widget do Kanban. A posição muda conforme a tela e a versão: às vezes no topo, às vezes ao lado. Por ele você:

• associa o ticket a um funil e a uma etapa;
• agenda uma mensagem para dia e hora definidos;
• anexa um arquivo à mensagem agendada.

Na hora marcada, a mensagem sai com o anexo para aquele cliente. Isso resolve o follow-up simples sem depender de outra ferramenta. Para cadências mais elaboradas, veja o artigo sobre follow-up automático no Chatwoot.

Aba de conexões: WhatsApp sem abrir o painel da Evolution

O script do Kanban também adiciona o item Conexões no menu. Ali o usuário cria a conexão, lê o QR code e pronto: o Kanban cria a instância na Evolution e já cria a caixa de entrada no Chatwoot. Se você ativar a importação, as mensagens antigas também chegam.

Para quem revende, isso economiza suporte, porque o cliente final consegue conectar o próprio número sem ver painel técnico nenhum. O projeto já foi estruturado para várias empresas, com cada conta separada.

Funciona também no Mega

O Mega é uma distribuição do Chatwoot criada pelo Nestor, com várias melhorias próprias, como chat interno. Ele já tem a opção de Dashboard Scripts no menu. No vídeo eu instalei a mesma stack apontando para a URL do Mega, colei o mesmo script e o Kanban apareceu. Se der cache, um refresh resolve.

Erros comuns e o lado honesto

• Barra no final da URL: a URL da Evolution não pode terminar com "/". Com a barra, não funciona.
• URL esquecida: trocar URL na mão deixa sobras. Use o substituir tudo, porque um espaço ou vírgula a mais derruba o projeto.
• Rede errada na stack: se o Chatwoot está em outra rede, o Kanban não conversa com ele.
• Versão diferente: o script foi feito para a 4.9.1. Versões muito distantes podem ter bug.
• Recursos de servidor: o projeto é leve, mas sobe mais três containers. Confira se a VPS tem folga.

Bug ou dúvida, o lugar é o grupo gratuito de WhatsApp da Astra Online (tem um formulário de cadastro para entrar).

Perguntas frequentes

O Chatwoot tem Kanban?

O Chatwoot open source não tem uma tela de funil de vendas. O Kanban da Astra Online adiciona essa visão pelo recurso Dashboard Scripts, sem alterar o código do Chatwoot, e cada conversa pode ser associada a um funil e a uma etapa.

O Kanban para Chatwoot é gratuito?

Sim. As imagens Docker do backend e do frontend estão gratuitas no Docker Hub, a stack e o script ficam na página de apoio do vídeo e o uso em produção, inclusive para clientes, é liberado. Só o código-fonte para editar fica na Comunidade Astra Online.

Como agendar mensagem no Chatwoot?

Com o Kanban instalado, aparece um widget dentro da conversa onde você define dia e hora da mensagem e pode anexar um arquivo. Na hora marcada, a mensagem sai com o anexo para aquele cliente.

Qual versão do Chatwoot é compatível com o Kanban?

O Kanban foi construído sobre o Chatwoot 4.9.1 e também foi testado nas versões 4.8 e 4.5. Em outras versões ele pode funcionar ou não, então se aparecer bug, confira a versão primeiro.

O Kanban do Chatwoot funciona no Mega?

Sim. No teste do vídeo, a mesma stack foi instalada apontando para a URL do Mega, o mesmo script foi colado na opção de Dashboard Scripts e o Kanban apareceu. Se der cache, um refresh resolve.

O Kanban já pronto, com o resto junto

Se você prefere não montar peça por peça, o AstraChat, nosso Chatwoot Pro, já traz Kanban, agentes de IA, disparador, ligações pelo WhatsApp, flows, chat interno e white label, no seu servidor e sem limite de atendentes.

Ele vem na Comunidade Astra Online, com código-fonte, atualizações, grupo VIP e a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Me chame no WhatsApp e me conte como é o seu funil hoje.