Chatwoot 4.19: o que mudou com a IA no centro do atendimento

O Chatwoot 4.19 é a versão em que a IA deixa de ser um item à parte e passa a aparecer em vários pontos do atendimento: automações, etiquetas, relatórios e no próprio painel da conversa. Mas antes de qualquer novidade, existe um aviso sério: o Captain V1 foi descontinuado. Quem atualiza sem se preparar pode ficar com o bot respondendo sem as instruções que configurou.

Eu passei tela por tela no vídeo. Aqui separo o que é do Chatwoot open source, o que é marcado como Enterprise nas notas oficiais da versão e o que você precisa fazer antes de clicar em atualizar.

Antes de atualizar: o Captain V1 acabou

A versão antiga do Captain (o agente de IA do Chatwoot) foi aposentada. As notas oficiais dizem que quem roda o Chatwoot no próprio servidor e ainda usa instruções do V1 precisa migrar para o V2 antes de subir para a 4.19.

O que acontece se você atualizar sem migrar:

• as instruções antigas ficam guardadas e dá para converter depois, mas até lá o bot responde sem elas;
• configurações que só existiam no V1 podem ser ignoradas;
• o modelo de IA usado pelo V2 é outro, então modelos antigos configurados por você também podem deixar de funcionar.

Se você já está no V2, com o layout novo, não muda nada. O risco é para quem ainda usa o modelo antigo.

Como eu faço a migração no Docker Swarm

1. Faça backup do banco antes de tudo.
2. Atualize fora do horário comercial. E não atualize na sexta-feira, senão o seu fim de semana vai junto.
3. No Portainer, entre no container do Chatwoot (o mesmo onde você roda as migrações do banco) e abra o console.
4. Rode primeiro o comando de simulação, que mostra o que vai mudar sem gravar nada.
5. Revise os rascunhos gerados. Se tiver dúvida no resultado, cole a saída no seu assistente de IA e peça um diagnóstico.
6. Rode a migração de verdade, que grava as instruções e as perguntas frequentes no V2.
7. Rode o comando de revisão para ver se ficou algo em rascunho ou com erro.
8. Confirme no Captain que os seus assistentes estão ativos no V2.

O guia oficial com os comandos está linkado nas notas da versão. Se não tem prática com terminal, peça ajuda em vez de testar no escuro. O passo a passo de backup com n8n ajuda a deixar essa rede de segurança pronta.

O que é Enterprise e o que é de todo mundo

As notas oficiais da 4.19 marcam como Enterprise os itens do Captain e as chamadas no celular. O resto vale para o Chatwoot aberto.

Para usar os recursos do Captain você precisa do plano Enterprise ou da versão Cloud do Chatwoot, mais a sua chave de IA configurada. Se você ainda não conhece o Captain, o artigo sobre Captain e IA externa explica a base.

A IA no dia a dia da conversa

Tradução automática. A mensagem chega traduzida, com a opção de ver o original.

Monitores de conversa. Ficam em Relatórios. Você descreve um tema em linguagem simples, por exemplo "o cliente compara com o concorrente ou diz que vai trocar", e o monitor mostra um gráfico e as conversas que se encaixam. Dá para pausar o monitor e criar uma automação a partir dele: quando aparecer comparação com concorrente, encaminhar para o gerente de vendas.

Automações com condição de IA. Ao criar uma automação, aparece uma opção do Captain nas condições e nas ações. Você descreve a situação ("o cliente quer cancelar o plano") e a IA decide se a regra se aplica.

Sugestão de etiqueta e prioridade. Em Ações da conversa aparece "sugerir com o Captain". Ele analisa a conversa e sugere etiquetas ou prioridade, e você aplica. Meu cuidado aqui: não saia criando etiqueta que ninguém vai usar.

Copiloto com histórico. O copiloto agora guarda sessões, como no ChatGPT, e você retoma uma conversa anterior.

Visão geral e alerta de créditos. A tela do Captain mostra tempo de resposta, tempo de resolução e consumo. Quando os créditos estão acabando, aparece aviso no painel e chega um e-mail. Hoje esse aviso vai para o dono da instalação.

Catálogo de ferramentas. O Captain passou a integrar com outras plataformas direto do catálogo. Uma delas é o Cal.com, ferramenta de agendamento open source, que permite ao Captain marcar horários.

Verificação do cliente. Achei a melhor do pacote. Antes, qualquer pessoa podia pedir o status do pedido de outra. Agora o Captain pode mandar um código para o e-mail cadastrado e só seguir depois que o cliente informa esse código. Nem o atendente vê o código antes.

Assumir o atendimento da IA. Enquanto o Captain atende, a caixa de resposta fica travada até alguém abrir a conversa. Isso evita atendente respondendo por cima do bot.

E-mail, campanhas e chamadas

• E-mail: encaminhar agora aparece como encaminhado para o cliente, o assunto entra na busca e tabelas em HTML deixaram de chegar quebradas.
• Campanhas de WhatsApp: a mensagem disparada por campanha ganha uma marcação dentro da conversa, e o relatório da campanha ficou mais completo.
• Chamadas no celular: a chamada da API oficial pode tocar no aplicativo do agente. Isso funciona melhor para quem usa o Chatwoot Cloud ou publicou o próprio aplicativo.

Empresas, Stripe e Shopify

O item Empresas existia há tempo e agora amadureceu. Você agrupa contatos da mesma empresa e vê notas e conversas abertas de todos eles num lugar só. Para quem atende B2B e fala com várias pessoas do mesmo cliente, isso organiza muito.

Com a integração do Stripe, a conversa mostra dados de cobrança do cliente, mais para consulta. Com o Shopify, aparecem os pedidos do cliente, pagos ou não.

Produtividade: macros em massa e modo leitura

Passando o mouse sobre a lista de conversas dá para selecionar várias de uma vez, e já dava para mudar time, agente, status e etiquetas em massa. Agora dá para executar uma macro em várias conversas ao mesmo tempo. No vídeo eu selecionei 17 conversas e rodei uma macro de "aprovar troca" em todas.

O modo leitura deixa você rolar para cima e ver as conversas anteriores do mesmo cliente dentro da conversa atual, mesmo quando cada atendimento é um ticket separado. E a caixa de resposta agora tem uma barra para recolher, bom para tela pequena.

Na Central de Ajuda, o endereço (slug) do artigo ficou editável.

Segurança e configuração do servidor

Token Bearer. A API aceita autenticação Bearer para os tokens existentes. O formato antigo continua funcionando, mas o Chatwoot costuma lançar o novo, manter o velho por um tempo e depois virar a chave, como aconteceu com o Captain. Se você tem automações no n8n chamando a API do Chatwoot, já vá ajustando.

Busca e resolução automática. Por padrão a busca olha os últimos 90 dias. Agora dá para mudar isso por variável na stack, assim como um tempo mínimo global de resolução automática e a frequência da rotina que resolve conversas paradas. Lembre: janela de busca maior consome mais da sua VPS.

2FA e verificação de dispositivo. O administrador pode exigir autenticação de dois fatores para a conta inteira. E existe uma verificação por código no e-mail quando alguém entra de um navegador ou dispositivo novo.

O novo Super Admin

Um Super Admin novo era o pedido antigo de quem usa Chatwoot. Ele foi redesenhado:

• painel inicial com atalhos para novos usuários, novas contas, saúde do sistema e diagnóstico;
• na edição de empresa, botão para selecionar todos os recursos de uma vez (antes era um por um) e link para a documentação de cada recurso;
• escolha de modelo de IA separada para cada parte do Captain, como copiloto e assistente;
• configurações organizadas por grupo: integrações, autenticação, canais, produtos;
• tela de saúde mostrando se Postgres e Redis estão online e se todas as migrações do banco foram aplicadas.

Olhe essa tela sempre depois de atualizar: às vezes uma tabela não migrou e o erro só aparece semanas depois.

Checklist para subir para a 4.19

1. Backup do banco e dos anexos.
2. Captain migrado para o V2 antes da atualização.
3. Atualização fora do horário comercial, nunca na sexta.
4. Migrações conferidas na tela de saúde do Super Admin.
5. Integrações revisadas para o formato Bearer.
6. Janela de busca ajustada só se o servidor aguentar.

Para comparar com a versão anterior, veja o que mudou no Chatwoot 4.18.

Perguntas frequentes

O que mudou no Chatwoot 4.19?

A IA passou a aparecer em automações, etiquetas, relatórios e no painel da conversa, com tradução automática, monitores e sugestão de etiqueta e prioridade. A versão também trouxe macros em massa, modo leitura, token Bearer na API e um Super Admin redesenhado.

Preciso migrar o Captain V1 antes de atualizar para o Chatwoot 4.19?

Sim. O Captain V1 foi descontinuado, e quem roda o Chatwoot no próprio servidor com instruções do V1 precisa migrar para o V2 antes de subir para a 4.19. Sem isso, o bot responde sem essas instruções até que elas sejam convertidas.

Os recursos de IA do Chatwoot 4.19 funcionam na versão open source?

Não. As notas oficiais marcam os itens do Captain como Enterprise, e para usá-los é preciso o plano Enterprise ou a versão Cloud do Chatwoot, além da sua chave de IA configurada.

Como atualizar o Chatwoot com segurança?

Faça backup do banco e dos anexos, atualize fora do horário comercial e evite a sexta-feira. Depois, confira na tela de saúde do Super Admin se todas as migrações do banco foram aplicadas.

A API do Chatwoot aceita token Bearer?

Sim. Desde a 4.19, a API aceita autenticação Bearer para os tokens existentes, e o formato antigo continua funcionando por enquanto. Quem tem automações no n8n chamando a API já pode ir ajustando.

Quer essa atualização feita por quem faz isso toda semana?

O AstraChat é o Chatwoot Pro que eu mantenho na Astra Online, com Kanban, flows, agentes de IA, disparador, ligações pelo WhatsApp e chat interno, no seu servidor e com a sua marca.

Ele vem na Comunidade Astra Online, com código-fonte, atualizações, grupo VIP e a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Se está com medo de quebrar o Captain na migração, me chama no WhatsApp e a gente olha a sua instalação antes.