Resumo
O Chatwoot 4.20.0 é uma publicação de segurança e de produto. O release reúne mais de 30 correções de segurança e endurecimento que alcançam autenticação, webhooks, APIs, acesso a registro e dependências. O próprio anúncio recomenda a atualização por esse motivo. O Rails sobe para 8.0.5.2 e o Node.js para 24.22.1.
A parte de produto abre a barra de comandos com busca, ações de página e comandos em lote. Entram também a análise de relatório e as ações do Copilot com aprovação de agente, em beta na edição Enterprise. O Captain recebe conexões MCP, o roteamento de chamadas por Twilio ganha horário de atendimento e tratamento de chamada perdida, e o Shopify aceita aplicativo próprio. A importação de registros fica disponível em todos os planos. O Help Center ganha prévia autenticada, filtro por autor, controle de SEO e logos em modo escuro.
Novidades
- Chatwoot 4.20.0 — Barra de comandos: a barra reúne busca, ações de página e comandos em lote num único ponto de entrada.
- Chatwoot 4.20.0 — Copilot em relatórios: a análise de relatório e as ações do Copilot contam com aprovação de agente. A entrada é beta na edição Enterprise.
- Chatwoot 4.20.0 — Conexões MCP do Captain: o Captain recebe conexões MCP e uma gestão de ferramentas revisada.
- Chatwoot 4.20.0 — Chamadas por Twilio: o roteamento de chamadas ganha saudação, horário de atendimento e tratamento de chamada perdida. A entrada é da edição Enterprise.
- Chatwoot 4.20.0 — Chamada com retenção: a chamada aceita espera, teclado durante a ligação e disponibilidade de voz separada da disponibilidade do atendente.
- Chatwoot 4.20.0 — Alertas no Slack: monitores de conversa enviam alerta ao Slack.
- Chatwoot 4.20.0 — Instagram com Unified Login: a caixa do Instagram usa agora o login unificado da Meta.
- Chatwoot 4.20.0 — Shopify com aplicativo próprio: a conexão do Shopify aceita um aplicativo personalizado da loja.
- Chatwoot 4.20.0 — Help Center: a prévia autenticada, o filtro por autor, os controles de SEO e os logos em modo escuro entram no Help Center.
- Chatwoot 4.20.0 — Captain: o produto recebe modelos atualizados, avatares personalizados e controle de tradução por conversa na edição Enterprise.
- Chatwoot 4.20.0 — SAML: a configuração aceita URL de metadados e renovação automática de certificado na edição Enterprise.
Melhorias
- Chatwoot 4.20.0 — Importação de registros: a importação fica disponível em todos os planos, inclusive nas edições de entrada.
- Chatwoot 4.20.0 — Rails e Node.js: a aplicação sobe para Rails 8.0.5.2 e Node.js 24.22.1, o que acompanha as correções de segurança do release.
- Chatwoot 4.20.0 — Localização e desempenho: a tradução para chinês simplificado é revisada, junto de correções pontuais e de desempenho.
Correções
- Chatwoot 4.20.0 — Segurança em autenticação e APIs: a publicação corrige falhas de autenticação e de webhook, endurece as APIs e o acesso a registro e atualiza dependências. O anúncio descreve mais de 30 correções de segurança e endurecimento.
Breaking changes
- Chatwoot 4.20.0 — Segredo do aplicativo no Messenger: uma instalação auto-hospedada com caixa do Messenger precisa definir o segredo do aplicativo da Meta (em Super Admin > Settings > Messenger ou pela variável
FB_APP_SECRET). Com o valor vazio, os eventos de webhook do Messenger são agora recusados. - Chatwoot 4.20.0 — Segredo da Meta na caixa do WhatsApp Cloud: uma caixa manual do WhatsApp Cloud exige agora o segredo do aplicativo da Meta. As caixas existentes continuam funcionando e mostram um aviso nas configurações, e a checagem de assinatura começa depois que o segredo é salvo.
- Chatwoot 4.20.0 — libvips 8.13: a instalação auto-hospedada exige libvips 8.13 ou mais nova em todas as máquinas web e de trabalho.
- Chatwoot 4.20.0 — Autenticação legada da Bandwidth: a Bandwidth encerra a autenticação de usuário de API legada em 2 de dezembro de 2026. Cada caixa da Bandwidth precisa migrar para credenciais OAuth de cliente na aba de configuração antes dessa data.
- Chatwoot 4.20.0 — Credencial de retorno da Bandwidth SMS: as caixas de SMS da Bandwidth ganham credencial de retorno. As existentes continuam funcionando, e a credencial entra no aplicativo da Bandwidth com a opção “Require callback credentials” ligada na configuração da caixa.
Ponto de Atenção
A publicação combina correção de segurança com exigência nova de configuração. Uma instalação auto-hospedada com Messenger ou WhatsApp Cloud para de receber evento de webhook se o segredo do aplicativo da Meta estiver vazio, e a Bandwidth tem data limite para trocar a autenticação. Antes de atualizar, confira o segredo em cada caixa, a versão do libvips nas máquinas web e de trabalho e o calendário da Bandwidth.
Teste sugerido: numa instalação de homologação com a versão anterior, defina FB_APP_SECRET, envie um evento de webhook do Messenger e confirme o recebimento, depois repita com a variável vazia para verificar a recusa. Faça o mesmo na caixa manual do WhatsApp Cloud. Rode vips --version em cada máquina e confirme 8.13 ou mais nova. Numa caixa da Bandwidth, troque a autenticação para OAuth de cliente e faça uma ligação de teste.
Notas da versão
O release oficial do Chatwoot 4.20.0 foi publicado em 18/11/2026 às 9h07 UTC como versão estável. As notas vêm do anúncio do release, com blocos de novidades, avisos de configuração e créditos de contribuição.