O que é o Chatwoot e para que serve
O Chatwoot é uma central de atendimento que reúne mensagens do WhatsApp, do email e do chat do site num painel compartilhado. Ele recebe cada mensagem pela conexão do canal e a associa a uma conversa, por isso você acompanha o histórico e responde sem alternar entre os aplicativos.
Ficha e sumário da página
- Referência técnica
- Chatwoot v4.19.1
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
A mensagem chega por um canal
Uma caixa de entrada representa uma conexão com um canal de comunicação. O widget colocado no site entrega mensagens à caixa daquele site. O endereço de email tem outra conexão. O WhatsApp usa a integração com o provedor configurado. O Chatwoot reúne essas entradas na mesma interface, mas preserva a origem de cada conversa para enviar a resposta pelo caminho correspondente.
Você atende pelo navegador enquanto o cliente continua no aplicativo usado para entrar em contato. Isso permite compartilhar o atendimento sem distribuir a senha do email ou depender de uma única sessão aberta no celular. Cada atendente entra com seu próprio acesso e trabalha nas caixas às quais tem permissão. A conexão do canal continua ligada à central mesmo quando outro agente assume a conversa.
Canal
WhatsApp, email ou widget do site.
Caixa de entrada
A conexão identifica a origem da mensagem.
Conversa
Mensagens e atribuições ficam no histórico.
Atendimento
O agente responde pelo canal de origem.
Histórico e cadastro do contato
A conversa reúne as mensagens recebidas e enviadas durante um atendimento, com os anexos e os registros de atividade associados. A atribuição indica o agente encarregado de responder. O estado distingue o atendimento aberto daquele já resolvido, adiado ou pendente, como ocorre durante o atendimento por um bot. Você consulta esses campos junto do histórico para retomar o trabalho do atendente anterior.
Uma nota privada acrescenta informação para os agentes sem enviar uma mensagem ao cliente. Você pode registrar a análise de um erro ou mencionar outro atendente para solicitar apoio dentro do histórico. A distinção entre nota e resposta pública precisa permanecer visível durante o trabalho, porque cada uma tem destinatários diferentes. O próximo agente encontra essa informação no histórico e a lê antes de responder.
O cadastro do contato e a conversa também têm funções diferentes. O contato guarda informações como nome e canais associados. A conversa representa uma interação de atendimento. Ter vários canais na mesma central não significa que mensagens com identificações distintas serão reunidas automaticamente numa única conversa. Você continua precisando conferir a associação do contato e a origem da mensagem.
Distribuição entre agentes e automações
Os grupos reúnem agentes por área, como suporte ou comercial. Uma conversa pode ser encaminhada para um desses grupos e atribuída a um atendente. A distribuição permite organizar o trabalho por assunto sem exigir uma caixa de entrada diferente para cada departamento. O canal descreve a origem da mensagem, enquanto a atribuição ao grupo indica a área responsável pelo atendimento.
As automações executam ações após eventos e condições configurados no Chatwoot. Uma conversa recém-criada pode receber uma etiqueta ou ser atribuída a um grupo. Respostas prontas ajudam no texto que o atendente envia manualmente. Macros juntam várias ações num comando da interface. Cada recurso atua numa parte diferente do trabalho, detalhada na página de automações e respostas prontas.
Um bot externo recebe eventos do Chatwoot pela integração Agent Bot. A central envia esses eventos ao endereço do bot, que processa a mensagem e usa a API para responder ou transferir o atendimento. Você pode montar esse processamento num fluxo do n8n, com consulta a outro sistema antes da resposta. O Chatwoot fornece o canal e o histórico, enquanto o fluxo externo define o que consultar e quando chamar um atendente.
A central pode rodar na sua VPS
Na instalação própria, o serviço web do Chatwoot atende o navegador. O PostgreSQL guarda os registros das conversas. O Redis participa das filas consumidas pelos processos Sidekiq. Anexos precisam de armazenamento persistente, local ou num serviço compatível. Uma central acessível no navegador depende desse conjunto, por isso a disponibilidade do container web não comprova que todas as tarefas estão sendo executadas.
Você administra o domínio, o acesso e as atualizações dessa instalação. O Traefik pode receber a conexão HTTPS e encaminhá-la ao serviço web. O banco e o Redis ficam acessíveis aos serviços que precisam deles, sem ganhar um endereço público de atendimento. A ligação entre essas peças e o motivo de cada processo existir estão em arquitetura.
A Chatwoot Inc. mantém o projeto. Na referência v4.19.1, o código fora de enterprise/ e das exceções de terceiros usa a licença MIT Expat. O diretório empresarial tem licença própria. A edição hospedada pelo fornecedor e os recursos comerciais têm condições próprias, por isso a possibilidade de hospedar o código não significa que todos os recursos anunciados estejam incluídos na mesma edição.
Condições de envio de cada canal
O WhatsApp mantém as condições do provedor, os modelos de mensagem e as limitações de envio da integração utilizada. O email depende de recebimento e entrega configurados. O widget depende do acesso do navegador ao servidor. Centralizar essas conexões permite atender pelo mesmo painel, mas cada falha ainda precisa ser localizada no canal que transporta a mensagem.
Para entender essa diferença, acompanhe o caminho de cada entrada na página de caixas e canais. Ali o widget, o email e o WhatsApp aparecem com seus próprios mecanismos de recepção e resposta, antes da distribuição da conversa entre os agentes.