Use este guia quando você precisar configurar, entender ou validar **Como ativar modo escuro no widget do site** na IAra.

## Antes de começar na IAra

- Confirme que seu usuário tem permissão para acessar a área citada no artigo.
- Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
- Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

## Guia detalhado

> **Observação técnica:** por compatibilidade com o SDK herdado, alguns objetos de código podem continuar usando nomes como `window.chatwootSettings` e `window.chatwootSDK`. Use esses nomes exatamente como aparecem no snippet.

Os sites modernos permitem que os usuários alternem entre os modos claro e escuro. Por isso, é importante um chat ao vivo que funcione com os dois temas. Este guia ajuda você a configurar o modo escuro para o widget de chat ao vivo IAra em seu site.

Aqui está uma rápida visão de como o modo escuro funciona no widget de chat ao vivo:

Para ativar o modo escuro no widget IAra, use o parâmetro `darkMode` junto com chatwootSettings.

O parâmetro `darkMode` aceita dois valores.

1. `light` - Ative apenas o modo light. Este é o valor padrão.

2. `auto` - Ative o modo escuro com base na preferência do sistema operacional.

```
window.chatwootSettings = {
  //... outras configurações
  darkMode: "automático",
};
```

Observação: `dark` não é compatível agora. Adicionaremos o suporte em versões futuras.

---

## Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

## Problemas comuns

- Usuário sem permissão para acessar a configuração.
- Nome de tela diferente entre versões ou contas.
- Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
- Falta de teste em conversa realista antes de liberar para a equipe.

## Checklist final

- [ ] Configuração revisada por um administrador.
- [ ] Teste realizado com dado ou conversa controlada.
- [ ] Impacto para agentes e gestores entendido.
- [ ] Artigos relacionados revisados para evitar links quebrados.