Ir para o conteúdo
Promovaweb

Conversas, agentes e grupos no Chatwoot

A conversa do Chatwoot é o registro que reúne as mensagens de um atendimento e sua atribuição a agentes e grupos. Ela mantém o histórico quando você transfere o atendimento, por isso o próximo agente lê as respostas anteriores antes de continuar pelo mesmo canal.

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 conversa é a unidade do atendimento
  2. Atribuição manual e automática
  3. Grupos de suporte e comercial
  4. Notas privadas ficam dentro da central
  5. Permissões de acesso às conversas

A conversa é a unidade do atendimento

O Chatwoot associa cada mensagem a uma conversa. Nesse registro ficam o canal de origem, o contato e os atributos usados na distribuição do atendimento. Você trabalha na conversa, envia respostas e acompanha mudanças de estado. A caixa de entrada mantém a conexão com o canal, enquanto a conversa reúne o que já aconteceu naquela interação com o cliente.

Uma conversa aberta representa atendimento disponível para continuidade. A resolução registra que aquele atendimento terminou. O adiamento retira temporariamente a conversa da fila de trabalho imediato, com retomada conforme a configuração utilizada. Esses estados descrevem o andamento do atendimento. Eles não apagam mensagens nem substituem a atribuição do agente encarregado de responder.

O estado pendente também aparece no atendimento com bots. A integração pode manter a conversa nesse estado enquanto processa as mensagens e abri-la ao transferir o atendimento a um agente humano. Você consegue separar a etapa automática da fila dos atendentes, desde que o bot use as mudanças de estado previstas na integração. Uma resposta escrita pelo bot, sozinha, não demonstra que houve transferência.

  1. Conversa

    Mensagens chegam pela caixa de entrada.

  2. Grupo

    Reúne os agentes de uma área de atendimento.

  3. Agente

    A atribuição identifica o atendente.

  4. Continuidade

    Notas e respostas acompanham a transferência.

A caixa recebe a conversa, o grupo organiza a distribuição e o agente continua o atendimento com o histórico disponível.

Atribuição manual e automática

O agente é um acesso individual ao painel. A atribuição liga a conversa a esse agente para indicar o atendimento pelo qual ele responde. Você pode trabalhar com atribuição manual ou usar os mecanismos de distribuição disponíveis na configuração da caixa. A distribuição automática precisa considerar as opções da edição e a disponibilidade dos agentes, sem pressupor que todo acesso conectado recebe novas conversas.

Essa informação reduz a ambiguidade dentro da fila compartilhada. Ao abrir uma conversa já atribuída, outro agente consegue identificar o atendente atual antes de escrever. O histórico permanece acessível conforme as permissões concedidas. Uma transferência troca a atribuição para dar continuidade ao atendimento, sem exigir que o cliente envie novamente todas as mensagens pelo canal.

O fato de uma conversa ter agente atribuído não comprova que recebeu resposta. A atribuição descreve a responsabilidade, enquanto as mensagens registram o que foi enviado. Você acompanha os dois elementos para distinguir uma conversa distribuída de uma conversa atendida. No painel, o nome do agente indica a atribuição. O histórico mostra se já existe uma resposta pública daquele atendente ao cliente.

Grupos de suporte e comercial

O recurso Teams do Chatwoot reúne agentes num grupo nomeado, como suporte técnico ou comercial. O mesmo agente pode participar de vários grupos. Você usa essa organização para encaminhar conversas por assunto e acompanhar o atendimento de cada área. A associação ao grupo oferece uma forma de distribuição, enquanto a atribuição individual identifica o agente que continua a conversa.

A caixa de entrada e o grupo não precisam corresponder um ao outro. Uma única caixa do WhatsApp pode receber solicitações comerciais e dúvidas técnicas. A classificação da conversa permite encaminhar cada assunto ao grupo adequado. Criar outra caixa só para representar um departamento acrescentaria uma conexão de canal, algo diferente da organização interna dos atendentes.

Quando o assunto muda durante o atendimento, a transferência para outro grupo preserva a conversa original. Você pode acrescentar uma nota sobre a análise feita e indicar o ponto ainda pendente. O próximo agente lê essa nota e retoma a análise sem transformar a troca de departamento numa repetição completa da triagem para o cliente.

Notas privadas ficam dentro da central

A resposta pública segue para o cliente pelo canal da conversa. A nota privada aparece para os agentes autorizados no painel. Essa separação permite discutir um diagnóstico, registrar informação interna ou mencionar outro agente sem enviar esse conteúdo ao cliente. Antes de escrever, você confere qual modo está ativo no editor, porque a aparência compartilhada do histórico não torna os destinatários iguais.

Uma nota útil descreve a informação que o próximo agente precisa para agir. No exemplo de uma falha de integração, o código retornado pela API e a etapa já conferida ajudam a continuar a investigação. Escrever apenas que o cliente tem um problema não acrescenta informação ao histórico. O Chatwoot guarda a nota, mas o conteúdo dela depende do atendimento realizado.

Etiquetas e atributos complementam essa leitura. Uma etiqueta classifica a conversa com um nome reutilizável. Um atributo armazena uma informação estruturada, conforme o cadastro configurado. Você consegue usar esses campos para organizar a fila e alimentar automações. O texto livre da nota continua servindo à explicação que não cabe num campo estruturado.

Permissões de acesso às conversas

As permissões determinam o que cada acesso pode consultar e alterar. A atribuição indica o agente da conversa. Transferir uma conversa não deve ser interpretado como alteração automática de todas as permissões do painel. Os papéis personalizados anunciados pelo Chatwoot também dependem da edição contratada, por isso a configuração disponível precisa ser conferida na instalação utilizada.

Você pode automatizar a atribuição quando o assunto já está identificado por uma caixa ou por um campo da conversa. A automação compara essa informação com as condições configuradas e encaminha o atendimento ao grupo indicado. A diferença entre uma ação disparada por evento e uma macro executada pelo atendente está em automações.

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.