Ir para o conteúdo
Promovaweb

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
  1. A mensagem chega por um canal
  2. Histórico e cadastro do contato
  3. Distribuição entre agentes e automações
  4. A central pode rodar na sua VPS
  5. Condições de envio de cada canal

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.

  1. Canal

    WhatsApp, email ou widget do site.

  2. Caixa de entrada

    A conexão identifica a origem da mensagem.

  3. Conversa

    Mensagens e atribuições ficam no histórico.

  4. Atendimento

    O agente responde pelo canal de origem.

O canal entrega a mensagem à caixa de entrada. A conversa guarda o histórico usado por atendentes e integrações.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.