Caixas de entrada e canais do Chatwoot
A caixa de entrada do Chatwoot é a conexão entre um canal de comunicação e a central de atendimento. Ela identifica a origem das mensagens e envia as respostas pela mesma integração, por isso você atende pelo painel enquanto o cliente continua no WhatsApp, no email ou no site.
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 caixa identifica a conexão
O Chatwoot pode ter várias caixas de entrada na mesma instalação. Cada caixa corresponde a uma integração configurada, como o chat de um site ou um endereço de suporte. Essa separação permite reconhecer de onde veio a mensagem e quais agentes podem atendê-la. A visualização conjunta do painel reúne o trabalho, enquanto a configuração de cada caixa conserva os endereços e as credenciais do canal.
Você pode ter dois sites com caixas distintas e o mesmo grupo de atendentes. Também pode separar o email comercial do email de suporte. O número de caixas acompanha as conexões que você precisa administrar. A distribuição por departamento acontece depois, com agentes e grupos, porque a origem da conversa e o responsável pela resposta são informações diferentes.
ChatwootCentral compartilhada de atendimento.Caixa do siteO widget envia mensagens do navegador.Caixa de emailO recebimento entrega mensagens à conversa.Caixa do WhatsAppO provedor entrega eventos e recebe respostas.
O widget no navegador do visitante
O widget é a janela de chat incorporada ao site. O navegador carrega o código da integração e se comunica com o servidor do Chatwoot. O visitante escreve sem sair da página, enquanto você recebe a mensagem no painel. A caixa correspondente identifica aquele site e reúne os atendimentos iniciados por essa entrada.
As opções do widget permitem adaptar a apresentação e coletar informações antes do atendimento. Nome e email ajudam a identificar o contato, mas a identificação precisa corresponder ao comportamento configurado no site. A abertura da janela por um visitante anônimo não confirma sua identidade. Em aplicações autenticadas, a integração pode enviar a identidade do cliente conforme o mecanismo documentado pelo Chatwoot.
O servidor precisa estar acessível ao navegador do visitante. Se o widget aparece, mas não consegue alcançar o endereço da central, a mensagem não completa o caminho até o painel. O domínio e o HTTPS fazem parte dessa comunicação. Você observa duas conexões ao investigar uma falha: carregar o site e carregar o chat são conexões diferentes, mesmo quando ambos aparecem na mesma página.
Recebimento e envio de email
A caixa de email transforma mensagens recebidas em conversas de atendimento. A documentação apresenta recebimento por encaminhamento ou conexão direta, conforme a configuração adotada. O envio usa o serviço de email configurado. Você responde pelo Chatwoot, mas a entrega ao destinatário continua dependendo do servidor de saída e das condições do domínio remetente.
Essa diferença aparece quando a central recebe mensagens normalmente, mas as respostas não chegam ao cliente. O caminho de entrada pode funcionar enquanto o SMTP de saída apresenta erro. No sentido contrário, notificações enviadas pelo sistema não comprovam que o recebimento da caixa está configurado. Os dois trajetos precisam ser observados separadamente para localizar a falha sem alterar uma conexão que já funciona.
O Chatwoot procura a conversa de uma resposta pelo identificador no endereço de destino e pelos cabeçalhos In-Reply-To e References. Na v4.19.1, a busca usa essas estratégias nessa ordem e cria uma conversa quando nenhuma encontra correspondência. O assunto visível não é o identificador dessa busca. Se uma resposta aparece separada do atendimento original, você compara os cabeçalhos recebidos com os da mensagem enviada pela central.
O WhatsApp entrega eventos pela integração
A integração oficial usa a plataforma WhatsApp Business. O provedor entrega eventos ao Chatwoot quando chegam mensagens e recebe as solicitações de envio das respostas. O painel compartilha o atendimento daquele número entre os agentes autorizados. O cliente continua usando o WhatsApp, sem precisar criar um acesso na central para conversar com você.
Na integração oficial do WhatsApp, as respostas livres ficam dentro da janela de 24 horas após a última mensagem recebida do cliente. Fora dela, o envio exige um modelo aprovado. Hospedar o Chatwoot numa VPS mantém essa exigência e os custos aplicáveis ao canal. Você administra a central de atendimento, mas a autorização para enviar a mensagem continua sujeita às condições da plataforma WhatsApp Business.
O portal UAZAPI trata de outra integração do ecossistema. Ao comparar conectores, você precisa identificar qual serviço recebe os eventos e envia as mensagens, sem atribuir a todos o funcionamento da integração oficial. O endereço do webhook, o formato dos eventos e as credenciais pertencem ao conector escolhido. A central pode continuar sendo o Chatwoot enquanto esse trecho da comunicação muda.
Canal de origem e transferência entre agentes
Uma conversa recebida pelo site pode seguir para o suporte, enquanto outra do WhatsApp segue para o comercial. A atribuição muda o atendimento, mas preserva o canal necessário para responder. Você vê a caixa de entrada junto do histórico e consegue conferir se a resposta está sendo enviada pela conexão esperada antes de transferir o atendimento.
Você confere a configuração da caixa quando a mensagem não chega ou a resposta não sai pelo canal esperado. Quando a mensagem já está no painel, a atribuição e o estado da conversa ajudam a localizar o atendimento dentro da fila. Essa parte do trabalho, com as notas privadas usadas numa transferência, fica em conversas, agentes e grupos.