Como ativar o modo escuro no widget de chat ao vivo

A

Antonio Milesi

Última atualização em Jul 10, 2026

Como configurar o tema do widget com darkMode: light mantém o modo claro, dark fixa o modo escuro e auto acompanha a preferência do dispositivo.

Sites modernos permitem que os visitantes alternem entre os modos claro e escuro. Por isso, é importante que o chat ao vivo funcione bem com os dois temas. Este guia mostra como configurar o modo escuro no widget de chat ao vivo do Chatwoot no seu site.

No modo escuro, o widget de chat ao vivo troca o fundo claro por um fundo escuro e ajusta as cores do texto e dos botões para manter o contraste e a legibilidade — acompanhando o tema do site do visitante.

Como ativar o modo escuro

Para ativar o modo escuro no widget, use o parâmetro darkMode junto com as configurações em chatwootSettings.

O parâmetro darkMode aceita três valores:

  • light — Mantém apenas o modo claro. Esse é o valor padrão.

  • auto — Ativa o modo escuro de acordo com a preferência do sistema operacional do visitante.

  • dark — Mantém o widget sempre no modo escuro.

window.chatwootSettings = {
  //... demais configurações
  darkMode: "auto",
};

Com o valor auto, o widget acompanha automaticamente o tema do dispositivo: se o visitante estiver usando o modo escuro no sistema, o widget aparece escuro; caso contrário, aparece claro. Use dark quando o site precisar manter o widget escuro independentemente da preferência do dispositivo.