Self-hosted resolve uma parte importante da conversa: o ambiente, os dados e as regras ficam sob o seu controle. A outra parte costuma aparecer depois — quando o servidor precisa de manutenção, o disco enche ou uma atualização é adiada por meses.

Essa é a diferença entre instalar e operar. Antes de abrir o Chatwoot para a equipe, vale revisar sete pontos. Não são passos teóricos: são os que costumam gerar chamado na primeira semana de uso.

1. Domínio, HTTPS e acesso

Um endereço estável, com HTTPS válido, evita uma série de problemas silenciosos: notificações que não chegam, anexos bloqueados, integrações que recusam a origem. Defina o domínio antes de configurar qualquer integração e mantenha o redirecionamento de HTTP para HTTPS.

Também vale separar quem administra o quê. Nem todo mundo precisa de acesso ao servidor para trabalhar no atendimento.

2. Banco, Redis e arquivos

O Chatwoot não vive de uma pasta só. Banco de dados, Redis e os arquivos enviados nas conversas precisam de espaço, limite e monitoramento. Um volume sem acompanhamento pode crescer por meses sem que ninguém perceba.

Verifique:

  • espaço em disco e política de retenção de anexos;
  • conexões do banco e memória disponível para o Redis;
  • persistência dos volumes entre reinícios e atualizações;
  • limites de upload compatíveis com o que a equipe envia no dia a dia.

3. E-mail transacional

Convites de agente, redefinição de senha e notificações dependem de SMTP. Configure um remetente válido, teste a entrega em provedores diferentes e acompanhe rejeições. E-mail que cai em spam transforma um problema técnico em um problema de confiança.

4. Segredos fora do repositório

Variáveis de ambiente não devem ser versionadas. Gere chaves próprias para produção, troque os valores padrão e guarde o arquivo de ambiente em local restrito.

# .env — exemplo ilustrativo, nunca versione este arquivo
FRONTEND_URL=https://atendimento.suaempresa.com
POSTGRES_HOST=postgres
POSTGRES_DATABASE=chatwoot
REDIS_URL=redis://redis:6379
SMTP_ADDRESS=smtp.suaempresa.com

O exemplo acima é só um recorte de configuração. O importante é que cada valor venha do seu ambiente, com credenciais próprias — não de um tutorial copiado sem revisão.

5. Backup precisa ser restaurável

Ter um arquivo .sql no servidor não é ter backup. O teste é outro: em um ambiente separado, consiga restaurar banco e anexos e abrir uma conversa antiga. Se esse caminho não foi ensaiado, ele ainda não existe.

Instalação é o começo do trabalho, não o fim.

Defina frequência, retenção e onde a cópia fica armazenada. Uma cópia no mesmo disco do banco resolve pouco.

6. Atualização tem janela e plano B

Atualizar sem janela combina mal com operação. Escolha um horário de menor movimento, leia as notas da versão, faça backup antes e tenha um caminho de retorno. Atualizações pequenas e frequentes costumam ser mais seguras do que uma grande atualização depois de seis meses de atraso.

7. Observabilidade mínima

Não é preciso montar um centro de operações. É preciso saber responder a três perguntas:

  1. O Chatwoot está no ar?
  2. O banco responde?
  3. Os webhooks e integrações estão entregando?

Monitoramento de disponibilidade, logs com retenção e alerta de disco já cobrem boa parte dos incidentes comuns.

Antes de abrir para a equipe

  • HTTPS válido e domínio definitivo;
  • SMTP testado com um usuário real;
  • backup criado e restaurado em ambiente separado;
  • credenciais padrão trocadas;
  • rotina de atualização combinada com quem opera;
  • um responsável claro por incidentes.

O Chatwoot é uma boa base para atendimento. Mas a qualidade da operação depende do que está em volta dele. Quando esses cuidados entram no processo, o self-hosted deixa de ser uma aposta e passa a ser infraestrutura.