FlowBuilder Chatwoot: chatbot visual, chat interno e projetos

O FlowBuilder Chatwoot é um construtor visual de chatbot que eu desenvolvi na Astra Online para rodar dentro do próprio Chatwoot, com blocos de texto e menu, agente de IA, base de conhecimento e requisição HTTP, ligado direto na caixa de entrada.

Montar um chatbot no Chatwoot quase sempre significa sair dele: Typebot, n8n ou outra ferramenta conectada por webhook. O FlowBuilder resolve isso dentro da própria tela.

Além dos flows, a mesma atualização trouxe chat interno entre a equipe, conexões com Evolution e WAHA, projetos, permissões por empresa e por usuário e várias melhorias no Kanban. Neste artigo eu explico cada módulo, o que precisa para instalar e os detalhes que fazem o bot "não funcionar" para muita gente.

O que é esse pacote de módulos

Esse pacote de módulos é um projeto meu, da Astra Online, que roda ao lado do Chatwoot e entra na interface por Dashboard Scripts. Não é recurso do Chatwoot oficial. Os módulos são:

• Kanban de funis e etapas;
• Conexões (Evolution e WAHA);
• Chats internos;
• Projetos;
• Chat Flows (o FlowBuilder);
• permissões extras e tokens de API.

As imagens Docker são gratuitas, no Docker Hub, e você pode usar e revender. O código-fonte, para quem quer editar, fica na Comunidade Astra Online. A primeira parte do projeto (Kanban e conexões) eu explico no artigo sobre Kanban e funis de venda no Chatwoot.

Antes de instalar: o que precisa estar certo

A instalação desse pacote é sensível. Pelos comentários e grupos, vi muita gente com dificuldade, quase sempre por um destes motivos:

1. Formato de instalação. O formato homologado é Chatwoot em Portainer com Traefik. Com EasyPanel ou Zero Trust do Cloudflare você terá bem mais trabalho, porque o projeto consome os endpoints do Chatwoot e depende de tudo estar na mesma rede.
2. Mesmo servidor. Rode no mesmo servidor do Chatwoot. O projeto acessa o banco do Chatwoot, e em outro servidor você teria que abrir a porta do banco, o que não é seguro.
3. Dashboard Scripts. A página onde o script é colado é oculta e só abre com os recursos Enterprise ativos na instalação.
4. Script novo. Quem instalou a versão anterior precisa trocar o script do super admin. Na stack, basta acrescentar o Redis e as variáveis da WAHA.

Na gravação, em janeiro de 2026, a versão estável era a 0.0.4. A tag develop recebe as novidades antes, para quem quer acompanhar.

Passo a passo da instalação

1. Baixe a stack e o script na página de apoio do vídeo.
2. Com o substituir tudo (Ctrl+H), troque a URL do Kanban e a URL do Chatwoot pelas suas.
3. Preencha host, senha e nome do banco do Chatwoot, copiando da stack dele.
4. No super admin do Chatwoot, em Platform Apps, crie um app e copie o token.
5. Preencha URL e chave global da Evolution, e URL e chave da WAHA (use a primeira chave da WAHA, entre aspas, e https nas duas URLs).
6. No Portainer, crie a stack, desabilite o Access Control e faça o deploy. O projeto sobe com PostgreSQL e Redis próprios. Deixe assim, a não ser que você seja usuário avançado.
7. No script, troque a URL de exemplo pela do seu Kanban, cole na página de Dashboard Scripts e dê submit.
8. Limpe o cache do navegador (Ctrl+Shift+R) ou abra uma janela anônima.

Se não der certo, remova tudo e comece de novo com calma. Seguindo os passos com o Chatwoot bem configurado, funciona.

FlowBuilder: chatbot visual dentro do Chatwoot

Em Chat Flows você cadastra as credenciais de IA e cria um flow para uma caixa de entrada. Funciona com qualquer caixa (Evolution, WAHA, API oficial), mas é um flow por caixa, porque dentro de um flow cabem todos os caminhos.

O gatilho pode ser uma palavra-chave ou ficar vazio, e aí qualquer mensagem inicia. Os blocos disponíveis no vídeo:

Um menu de triagem fica assim: texto "1 suporte, 2 comercial", switch com as duas saídas, mensagem "transferindo" e bloco de atribuir para a pessoa certa. Depois de salvar, ative o flow, senão nada acontece.

No agente de IA, o campo de modelo é aberto, porque sempre aparece modelo novo. Ligando uma base de conhecimento com PDF, o agente consulta o documento quando o cliente pergunta algo relacionado. Para quem quer ir mais fundo em bot com IA, tem o artigo sobre chatbot com IA no WhatsApp.

O erro que faz o bot "não responder"

O flow só interage com tickets não atribuídos. Se o ticket já está com um atendente, o bot fica quieto, porque já tem um humano na conversa.

O caso mais comum: a caixa está com atribuição automática ligada (em Configurações da caixa, aba Agentes). O Chatwoot atribui o ticket na hora e o bot nunca entra. Desligue a atribuição automática e deixe o próprio flow fazer a triagem e transferir.

Chat interno, conexões e projetos

Chat interno. Antes, para a equipe conversar dentro do Chatwoot, o jeito era criar caixa e conversa falsas. Agora você cria um chat (financeiro, por exemplo), escolhe os membros da conta e troca texto, áudio e anexos, com o nome de quem enviou.

Conexões. O usuário escolhe o provedor (Evolution ou WAHA), cria a conexão e lê o QR code. Dá para controlar mostrar o nome do agente, rejeitar ligações e ignorar grupos, status e listas de transmissão. A API oficial estava no roadmap na época do vídeo. Para várias linhas na WAHA, veja vários números de WhatsApp com WAHA e Chatwoot.

Projetos. Você cria um projeto para o cliente com prazo, marcos (como "front end") e tarefas dentro de cada marco. Dá para vincular cards do Kanban, subir arquivos, abrir discussões e ver a linha do tempo de atividades. No vídeo eu deixo claro que esse módulo ainda estava amadurecendo.

Kanban mais completo

A atualização que trouxe o FlowBuilder também mexeu no Kanban:

• lista todos os cards (antes parava em 25);
• visualização em agenda, mostrando os agendamentos;
• funis recolhíveis nas configurações;
• templates de itens: produtos ou serviços que você associa ao lead;
• campos personalizados, com opção de obrigatório;
• o card abre num painel maior, com tarefas e prazo, anexos, mensagens agendadas, itens, campos extras e o histórico de mensagens.

No widget da conversa você continua associando o ticket ao funil e agendando, editando ou apagando mensagens.

Permissões e API

São dois níveis de controle:

1. Config extra (super admin): só aparece para o super admin. Define quais módulos cada empresa recebe (Kanban, chat interno, conexões, projetos, flows) e quais provedores aparecem em Conexões.
2. Permissões extras (dono da empresa): dentro da conta, o gestor define o que cada agente vê. Exemplo: esconder Conexões da atendente.

Há também a criação de tokens com escopo. Você manda o token no cabeçalho Authorization como Bearer e usa a documentação para mexer em tudo via API: Kanban, funis, agendamentos, chat interno, flows, permissões, projetos e tarefas.

Perguntas frequentes

O que é o FlowBuilder do Chatwoot?

É um módulo da Astra Online que roda ao lado do Chatwoot e permite montar chatbots com blocos visuais dentro da própria tela, ligados direto na caixa de entrada. Tem blocos de texto, menu, condição, mídia, agente de IA, base de conhecimento e requisição HTTP. Não é um recurso do Chatwoot oficial.

Por que o chatbot do Chatwoot não responde?

O flow só interage com tickets não atribuídos. Se a caixa de entrada está com atribuição automática ligada, o Chatwoot atribui o ticket a um atendente na hora e o bot não entra. Desligue a atribuição automática e confira se o flow foi ativado depois de salvo.

O Chatwoot tem chat interno entre a equipe?

Com o módulo de chats internos da Astra Online, sim. Você cria um chat, escolhe os membros da conta e troca texto, áudio e anexos com a equipe, sem precisar criar caixas ou conversas falsas.

Dá para ter mais de um flow na mesma caixa de entrada do Chatwoot?

Não. É um flow por caixa de entrada, porque dentro de um único flow cabem todos os caminhos do atendimento. O flow funciona com caixas da Evolution, da WAHA e da API oficial.

Como conectar Evolution ou WAHA no Chatwoot pelo menu Conexões?

No módulo Conexões, o usuário escolhe o provedor (Evolution ou WAHA), cria a conexão e lê o QR code. Dá para controlar se o nome do agente aparece, rejeitar ligações e ignorar grupos, status e listas de transmissão.

Quer isso instalado e mantido?

Se você não quer mexer em stack, o AstraChat (o Chatwoot Pro da Astra Online) entrega Kanban, flows, chat interno, agentes de IA, disparador, ligações pelo WhatsApp e white label no seu servidor, com atendentes ilimitados.

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 com o fluxo de atendimento que você quer automatizar.