O Chatwoot é um dos melhores softwares open source que o mundo do atendimento já produziu, e essa frase precisa abrir qualquer análise honesta dele. Caixa de entrada multicanal, multiagente, gratuita para hospedar, com código aberto e comunidade global: não é pouca coisa, e explica as 18 mil buscas mensais pelo nome no Brasil. A análise honesta também precisa da segunda frase: o Chatwoot é uma caixa de entrada, e boa parte de quem o adota está tentando fazer dele o que ele não é: uma plataforma de vendas, um CRM, um produto white label. Este guia cobre as duas frases.
TL;DR: Chatwoot é uma plataforma open source de atendimento ao cliente: caixa de entrada compartilhada que unifica canais (site, e-mail, redes, WhatsApp via API oficial) para equipes responderem juntas, self-hosted ou na nuvem paga. O que ele entrega bem: conversas multiagente, automações de atendimento, base de conhecimento. O que ele não tem nativo: CRM de vendas com funil e kanban (a busca “chatwoot kanban” existe aos milhares porque a demanda existe e o recurso não), white label real e conexão de WhatsApp sem os requisitos da API oficial. O custo real do self-hosted: infraestrutura, atualizações que exigem cuidado e o plantão sendo seu.
Neste guia: o que é · a arquitetura por dentro · tour pelos recursos · o que faz bem · o que ele não é · da instalação ao 1º atendimento · custo real · Chatwoot vs vizinhos de prateleira · segurança e LGPD · erros de adoção · para quem serve · um cenário completo · glossário
O que é o Chatwoot?
Chatwoot é um software de atendimento ao cliente de código aberto, alternativa às plataformas comerciais de suporte: centraliza conversas de vários canais numa caixa de entrada compartilhada onde uma equipe atende com atribuição, notas internas, etiquetas e relatórios. Ele existe em duas formas: a versão cloud paga (hospedada pela empresa Chatwoot) e a versão self-hosted, que qualquer um baixa e roda na própria infraestrutura, a forma que domina o uso brasileiro pela combinação de custo zero de licença com controle dos dados.
A arquitetura é Ruby on Rails com PostgreSQL e Redis, madura e conhecida. E o modelo de negócio é o clássico open core: o código aberto cobre o essencial; recursos avançados moram na edição enterprise e na nuvem paga.
A arquitetura por dentro: as quatro peças que você vai operar
Quem hospeda o Chatwoot opera, na prática, quatro serviços, e cada um tem um jeito próprio de falhar. Conhecer o mapa antes encurta cada diagnóstico depois.
O Rails (web) é a aplicação principal: serve o painel, as APIs e os websockets que mantêm as conversas atualizando em tempo real na tela dos agentes. É a peça que sente cada agente logado, e a primeira a engasgar quando a máquina é menor que a equipe, o padrão do relato público de lentidão com 10-15 usuários (issue #3425).
O Sidekiq é o trabalhador de bastidor: processa filas de e-mail, automações, webhooks e tarefas agendadas. O modo de falha dele é o mais traiçoeiro do conjunto, porque nada quebra na tela: o painel funciona, e os e-mails simplesmente não saem, as automações não rodam. “Funciona mas não acontece nada” é Sidekiq até prova em contrário.
O PostgreSQL guarda tudo: contas, conversas, contatos, configurações. É o único componente cuja perda é irreversível sem backup, e o protagonista dos incidentes de atualização (as migrações de esquema que, esquecidas, produzem o famoso “Account Suspended” da discussão #5518).
O Redis sustenta cache, filas e o pub/sub dos websockets. Pequeno, essencial e frequentemente esquecido no dimensionamento: Redis sufocado aparece como lentidão generalizada difusa, sem culpado óbvio.
A consequência operacional do desenho: monitorar o Chatwoot é monitorar quatro processos e duas dependências, não “um site”. O checklist de operação da seção de custos parte daí.
Tour pelos recursos: o que existe dentro da caixa
| Bloco | O que entrega | Nota de operação |
|---|---|---|
| Inboxes multicanal | Widget de site, e-mail, WhatsApp (Cloud API oficial), Instagram, Facebook, Telegram, SMS e canal de API genérico | Cada canal tem requisitos próprios; o de WhatsApp é o mais burocrático e o mais valioso |
| Trabalho em equipe | Atribuição, times, etiquetas, notas privadas, menções, visão de quem atende o quê | O núcleo maduro do produto |
| Automações e macros | Regras por evento (criação, atribuição, resolução), respostas prontas, atalhos | Automação de atendimento, não de funil comercial |
| Relatórios | Tempo de primeira resposta, volume por canal/agente, CSAT | Métricas de suporte; conversão de venda não existe aqui |
| Campanhas | Mensagens proativas no widget e em canais suportados | Não confundir com disparo em massa de WhatsApp |
| Base de conhecimento | Central de ajuda pública (help center) integrada | Recurso subestimado; bom para desafogar o time |
| Apps móveis | Aplicativos iOS e Android para agentes | Dependem da configuração correta da instância self-hosted |
| IA (edições novas) | Recursos de assistência por IA nas versões recentes/pagas | A divisão exata community vs pago muda por release; confira a matriz vigente |
O tour deixa visível o padrão que o guia inteiro repete: é um conjunto completo para atender, e nada na caixa gerencia vender. A tabela não tem linha de funil porque o produto não tem.
O que ele faz bem (a lista é séria)
- Caixa de entrada compartilhada com atribuição, times, etiquetas, notas privadas e visão de quem está atendendo o quê: o núcleo do produto, e é sólido.
- Multicanal real: widget de chat no site, e-mail, e canais sociais, com o WhatsApp entrando via Cloud API oficial da Meta como canal nativo.
- Automações de atendimento: regras de atribuição, respostas prontas, macros, chatbots via integrações.
- Relatórios de suporte: tempos de resposta, volume, CSAT.
- Código aberto auditável e dados na sua infraestrutura, argumento real para conversas de LGPD.
O que ele não é (e o mercado insiste em tentar)
Aqui mora a parte do guia que economiza meses de frustração. Três ausências definem a fronteira do produto:
Não é CRM de vendas. Não há funil, etapas de negociação, kanban de oportunidades, previsão de receita. A demanda brasileira por “chatwoot kanban” soma centenas de buscas mensais justamente porque quem opera vendas pelo WhatsApp bate nessa parede na segunda semana. As soluções da comunidade (plugins, integrações com CRMs externos) existem e têm custos próprios, tema que aprofundamos em kanban e CRM no Chatwoot, em Chatwoot é um CRM? e no improviso documentado de funil de vendas no Chatwoot.
Não é white label de prateleira. Remover a marca e revender como plataforma própria esbarra em limites técnicos e de licença que analisamos em Chatwoot white label: viável com engenharia e edição adequada, distante do “coloca meu logo e vende”.
Não conecta WhatsApp “fácil”. O canal nativo é a API oficial, com seus requisitos. Quem quer o atalho da conexão por pareamento acopla ferramentas de terceiros (Evolution API, Z-API) por pontes, com os atritos documentados que descrevemos em WhatsApp no Chatwoot.
Da instalação ao primeiro atendimento: o resumo executivo
O caminho completo, com as travas documentadas, está em instalação do Chatwoot; aqui vai o esqueleto para dimensionar o esforço. Máquina de 4 GB com Docker; Compose oficial subindo web, Sidekiq, PostgreSQL e Redis separados; variáveis de ambiente completas antes do primeiro start (URL definitiva e SMTP são as que todo mundo adia e paga); migração de banco; proxy reverso com SSL e websockets; e o teste do circuito completo (conta, convite por e-mail, widget, conversa, resposta) antes de conectar canal real.
Tempo realista com método: meio dia. O relato público de semanas de luta (discussão #8954) existe, e a diferença entre os dois números não é sorte: é seguir o Compose oficial em ambiente limpo em vez de adaptar a instalação a um servidor cheio de serviços conflitantes.
O custo real do self-hosted
A licença é gratuita; a operação, não. Os relatos públicos da própria comunidade dão as coordenadas do que esperar: instalação que pode consumir dias de tentativa (a discussão #8954 no GitHub do projeto documenta semanas de luta com Docker, filas do Sidekiq travadas e widget com erros), instância que exige recursos de verdade sob carga (a issue #3425 relata lentidão severa com 10 a 15 agentes), e atualizações que pedem método: há registro público de conta suspensa após update por migração de banco pendente (discussão #5518) e de release que quebrou funcionalidades (v2.16.0, discussão #6917). Nada disso desqualifica o projeto; tudo isso dimensiona o trabalho de quem o opera. O detalhamento por item está em instalação do Chatwoot, requisitos e custo de self-host e quanto custa o Chatwoot.
Chatwoot vs os vizinhos de prateleira
Contra os SaaS globais de suporte (Zendesk, Intercom e afins): o Chatwoot compete por custo e soberania de dados, e perde em polimento, ecossistema de apps e suporte contratual. Para equipes técnicas com orçamento curto, a troca costuma valer; para operações que precisam de fornecedor com SLA, não há edição community que substitua contrato.
Contra o ecossistema brasileiro de WhatsApp (Whaticket e forks): aqui a diferença é de natureza, não de qualidade: o Chatwoot é multicanal com WhatsApp oficial nativo; o Whaticket nasceu em volta do pareamento por QR code. O duelo completo, incluindo a linha dos forks, está em Whaticket ou Chatwoot.
Contra as plataformas conversacionais com CRM: essa é a comparação que a maioria dos avaliadores brasileiros deveria fazer e não faz, porque compara caixas de entrada entre si quando o problema é de vendas. Se as conversas terminam em “ganho/perdido”, a prateleira certa tem funil, automação comercial e atendimento no mesmo banco, a categoria que discutimos em Chatwoot é um CRM? e onde o Cubo Suite se posiciona, interesse declarado.
Segurança e LGPD: a soberania que vem com fatura de responsabilidade
O self-hosted entrega o argumento de LGPD mais forte da categoria: os dados de atendimento (conversas, contatos, anexos) ficam em servidor seu, sem suboperador estrangeiro na cadeia, com retenção e exclusão sob seu controle. Para contratos com áreas jurídicas exigentes, isso abre portas que SaaS global não abre.
A mesma frase, lida do outro lado, é a fatura: você vira o responsável técnico pela segurança desses dados. O mínimo profissional: TLS na borda e entre serviços quando separados; acesso ao banco restrito por rede; backups criptografados e testados (backup de conversa de cliente é dado pessoal em cópia); atualizações em cadência, porque instância congelada acumula vulnerabilidades conhecidas (o ritual seguro está em como atualizar o Chatwoot); e política de acesso ao painel, porque todo administrador enxerga todas as conversas. Agências que operam instâncias de clientes somam a camada contratual: papel de operador definido por escrito e aviso de privacidade do cliente final refletindo o arranjo.
Erros de adoção que custam caro (e nenhum é bug)
1. Adotar sem nomear o responsável. A pergunta “quem cuida da instância?” respondida com um cargo (“a equipe”) em vez de um nome é o preditor número um de instância abandonada em versão velha seis meses depois.
2. Esperar CRM da caixa de entrada. As 400 buscas mensais por “chatwoot kanban” são o custo coletivo desse erro. Defina antes da adoção onde vive o funil, ou a planilha paralela nasce na segunda semana.
3. Prometer white label sem ler as condições. Revender “plataforma própria” sobre rebranding cujas condições você não verificou é assinar passivo, como detalhamos em Chatwoot white label.
4. Dimensionar pela instalação, não pela carga. Instância vazia voa em 2 GB; segunda-feira com a equipe logada é outro produto. O relato de lentidão com 10-15 usuários é o memorial desse erro.
5. Conectar o WhatsApp pelo atalho errado para o caso. Ponte não oficial para canal de receita, ou burocracia oficial para projeto de teste: os dois desalinhamentos custam, cada um à sua maneira. A régua está em WhatsApp no Chatwoot.
Um cenário completo: o e-commerce que adotou certo (e esbarrou no teto certo)
Cenário declaradamente hipotético, com premissas explícitas, do uso que dá certo. Um e-commerce de suplementos com 4 agentes de atendimento adota o Chatwoot self-hosted: VPS de 8 GB (R$ 180/mês), um desenvolvedor da casa como responsável nomeado, canais de widget, e-mail e WhatsApp pela Cloud API oficial.
Mês 1: instalação em um dia, migração dos e-mails em uma semana, equipe treinada nas macros. Mês 3: a central de ajuda derruba 30% dos tickets repetitivos (premissa plausível para FAQ de logística); o CSAT integrado passa a pautar a reunião semanal. A operação de suporte está melhor do que no SaaS anterior, por um décimo do custo de licença. Mês 5: o comercial pede para usar “aquele sistema do atendimento” para o time de vendas B2B da empresa, e o responsável técnico faz a avaliação correta: conversas de venda precisam de etapa, valor e cobrança de follow-up, e etiquetas não entregam isso. O suporte fica no Chatwoot; a operação comercial vai para plataforma com CRM. Cada ferramenta na própria categoria.
A moral é a régua deste guia funcionando: o final feliz não veio de a ferramenta ser boa (ela é), veio do problema certo ter sido colocado dentro dela, com responsável, máquina e canal certos.
Glossário rápido
- Inbox: a representação de um canal (widget, e-mail, WhatsApp) dentro do Chatwoot; conversas nascem em inboxes.
- Agente: usuário de atendimento com acesso às conversas das inboxes em que trabalha.
- Sidekiq: o processador de filas da pilha (e-mails, automações, webhooks); quando trava, tudo “funciona” e nada acontece.
- Open core: modelo de negócio em que o núcleo é open source e recursos avançados moram nas edições pagas.
- Community edition: a versão self-hosted gratuita do Chatwoot, sem limite de agentes por licença.
- CSAT: pesquisa de satisfação pós-atendimento integrada aos relatórios.
- Cloud API: a API oficial do WhatsApp (Meta), canal nativo de WhatsApp do Chatwoot.
- Coexistência: modalidade da Meta (2025) que mantém o aplicativo WhatsApp Business ativo junto da Cloud API, com histórico individual sincronizado.
- Migração (de banco): alteração de esquema executada a cada atualização; esquecê-la é a causa clássica de instância quebrada pós-update.
Chatwoot para quem? A régua honesta
| Perfil | Veredicto | Por quê |
|---|---|---|
| Time técnico interno, atendimento de suporte | Escolha forte | O produto é exatamente isso, e a equipe absorve a operação |
| Empresa sem equipe técnica | Cloud paga do Chatwoot ou plataforma nacional | Self-hosted sem operador vira passivo |
| Operação de vendas pelo WhatsApp | Vai faltar peça | Sem CRM/funil nativo; a stack cresce em pontes |
| Agência revendendo para clientes | Repense a arquitetura | White label limitado + plantão multiplicado por cliente |
Para os dois últimos perfis, o interesse declarado desta casa: o Cubo Suite nasceu exatamente da fronteira que o Chatwoot não cruza: atendimento, CRM com funil, automação e construtor de páginas na mesma plataforma, com API oficial do WhatsApp nativa (incluindo o modo coexistência documentado pela Meta em 2025, que preserva o aplicativo no celular) e white label de verdade para agências. A comparação de quando cada caminho compensa está em Chatwoot para agências; o duelo clássico do ecossistema em Whaticket ou Chatwoot; e as rotas de saída por motivo em alternativas ao Chatwoot.
O Chatwoot tem aplicativo para celular?
Tem apps de agente para iOS e Android, que funcionam também com instâncias self-hosted corretamente configuradas (URL pública com SSL válido). A administração completa continua no painel web.
O Chatwoot faz disparo em massa no WhatsApp?
Não é a função dele: as campanhas do produto cobrem mensagens proativas em canais como o widget. Disparo ativo de WhatsApp em volume passa pelas regras da Cloud API (templates e tarifas da Meta), independentemente da ferramenta na frente.
O Chatwoot tem inteligência artificial?
As versões recentes trazem recursos de IA assistiva, com a divisão entre community e edições pagas mudando por release. Bots externos sempre puderam ser acoplados via API e integrações; a IA embutida é camada nova e convém conferir a matriz vigente antes de contar com ela.
Uma instância atende várias empresas ou marcas?
O Chatwoot suporta múltiplas contas na mesma instalação, o que tecnicamente permite servir vários clientes. Operacionalmente, todos dividem a mesma versão, a mesma janela de manutenção e o mesmo incidente, o ponto central da análise de Chatwoot para agências.
O Chatwoot é gratuito?
O código é aberto e a versão self-hosted não tem licença a pagar; o custo vira infraestrutura e operação. A versão cloud e a edição enterprise são pagas. A fronteira exata entre grátis e pago está em Chatwoot gratuito: até onde vai.
O Chatwoot funciona com WhatsApp?
Sim, nativamente via API oficial da Meta (Cloud API), com os requisitos e tarifas da plataforma. Conexões por pareamento entram apenas via ferramentas de terceiros, com pontes e atritos próprios.
O Chatwoot tem kanban ou funil de vendas?
Não nativamente: o produto é caixa de entrada de atendimento. Kanban e funil exigem extensões da comunidade ou integração com CRM externo, o motivo de “chatwoot kanban” ser uma das buscas mais comuns sobre a ferramenta.
Qual servidor preciso para rodar o Chatwoot?
Para equipe pequena, uma VPS dedicada com 4 GB de RAM é o piso confortável, com PostgreSQL e Redis; sob carga de dezenas de agentes, os relatos públicos indicam necessidade de dimensionamento bem maior. Os números estão no artigo de requisitos.
Deixe um comentário