Instalar ChatWoot em VPS é mais simples do que parece, e o resultado compensa cada minuto investido. Se você precisa gerenciar múltiplos números de WhatsApp em um único painel, sem depender de ferramentas caras ou limitadas, este tutorial vai te mostrar exatamente como fazer isso. Mais abaixo você encontra o vídeo completo onde demonstro a instalação na prática.
O ChatWoot é uma aplicação open source que centraliza conversas de atendimento, ideal para pequenas e médias empresas que querem profissionalizar o suporte via WhatsApp. E a melhor parte: rodando no seu próprio servidor, você tem controle total sobre os dados e zero mensalidades de plataformas terceirizadas.
O que é o ChatWoot e Por que Instalá-lo em VPS
O ChatWoot é uma aplicação de código aberto projetada para gerenciar conversas de atendimento ao cliente, especialmente via WhatsApp. Ele permite que empresas organizem múltiplos números e conversas em um único painel, facilitando a comunicação com clientes de forma centralizada.
Conheço muita gente que transformou o ChatWoot no principal ganha-pão. Agências cobram implementação e manutenção, profissionais de TI oferecem como serviço, e empresários economizam milhares de reais por ano comparado a soluções SaaS.
A grande vantagem de hospedar no seu VPS é a liberdade. Você não fica preso a limites de conversas, não paga por número adicional, e pode integrar com outras ferramentas como Evolution API e N8N para criar automações poderosas.
Se você está em busca de opções confiáveis de VPS, confira este guia sobre servidores VPS da Contabo para encontrar a melhor solução para o seu projeto. Para escolher o serviço de nuvem ideal, veja também estas dicas sobre as melhores opções de cloud.
💡 Dica do Gabriel
Já instalei o ChatWoot em diversos servidores. O que mais vejo é gente subestimando os recursos necessários. Comece com 2GB de RAM, mas já considere a necessidade futura de upgrade. Se você já tem outras aplicações rodando no mesmo VPS, vá direto para 4GB ou mais. O ideal para produção é 4GB de RAM. A maioria dos clouds não permite downgrade para planos menores que os contratados inicialmente, então começar menor e subir conforme a demanda faz mais sentido. Em períodos de baixa, você pode fazer downgrade do servidor para economizar, algo que não seria possível se tivesse contratado um plano maior desde o início.
Requisitos de Servidor para Instalar o ChatWoot
Antes de iniciar o processo de instalar o ChatWoot em VPS, é essencial verificar se o seu servidor atende aos requisitos mínimos. O ChatWoot é uma aplicação que pode ser considerada pesada, especialmente quando há muitas conversas ativas, pois isso aumenta as requisições ao banco de dados.
De acordo com minha experiência, um servidor com pelo menos 4GB de RAM é suficiente para uma configuração inicial. No entanto, se você planeja gerenciar um volume maior de interações ou já possui outras aplicações rodando no mesmo VPS, o ideal é considerar um upgrade para 6GB ou mais.
Além disso, é importante avaliar a sobrecarga do servidor. Se outras ferramentas ou serviços já estão consumindo recursos, a performance do ChatWoot pode ser comprometida. Nesse caso, priorizar um ambiente dedicado ou aumentar os recursos do VPS será fundamental.
📊 Dados Reais
Consumo de recursos: Em um servidor com 10 conversas ativas simultâneas, o ChatWoot consome aproximadamente 1.5GB de RAM. Com 50+ conversas, esse número pode dobrar facilmente.
Testado em: VPS Contabo 4GB RAM, Ubuntu 22.04
Se você ainda não tem um servidor, recomendo a Contabo (Veja os planos aqui) pelo excelente custo-benefício. Um VPS de 4GB custa menos de R$30/mês e dá conta do recado para começar.
Primeiros Passos: Configurando o Ambiente no VPS
O processo de instalar o ChatWoot em um servidor VPS começa com a configuração do ambiente. Primeiro, é necessário acessar o terminal do seu servidor via SSH e garantir que todas as ferramentas básicas estejam instaladas.
Se precisar de ajuda para acessar seu servidor, veja este guia sobre acesso SSH em servidores Contabo. Esse passo é fundamental para executar os comandos de instalação.
Vou usar o SetupOrion, um script que automatiza todo o processo. Ao executar o instalador, ele apresenta uma lista de aplicações disponíveis. No caso do ChatWoot, você pode encontrar diferentes versões ou opções temporárias, especialmente se uma atualização recente tiver deixado a versão principal offline.
Para aprender mais sobre ferramentas essenciais como o Docker, confira este tutorial de instalação do Docker com SetupOrion. Além disso, o Traefik e Portainer são pré-requisitos para o ChatWoot funcionar corretamente.
Escolhendo a Versão Correta do ChatWoot
Ao instalar o ChatWoot em VPS, você pode se deparar com diferentes versões disponíveis no instalador. Atualizações recentes da ferramenta podem deixar algumas opções temporariamente offline, como mencionado em grupos de suporte ou avisos de desenvolvedores.
Nesse caso, optar por uma versão alternativa não altera o processo de instalação, mas é importante estar atento às notas de atualização para garantir que a versão escolhida atenda às suas necessidades.
Essa flexibilidade é uma das grandes vantagens do ChatWoot: mesmo em momentos de transição, você pode continuar com a instalação sem grandes interrupções. Para iniciantes, isso significa que não há necessidade de esperar por uma versão específica; basta escolher a opção disponível e prosseguir.
Configuração de DNS para o ChatWoot no VPS
Um passo indispensável ao instalar o ChatWoot em VPS é a configuração do registro DNS. Isso permite que o painel do ChatWoot seja acessado por meio de um subdomínio personalizado, como chatwoot.seudominio.com.
Para isso, você deve acessar o gerenciador de DNS do seu provedor de domínio e criar um novo registro do tipo CNAME. Esse registro deve apontar para o endereço do seu VPS, garantindo que o tráfego seja direcionado corretamente.
Durante a configuração, é importante desabilitar temporariamente qualquer proxy de nuvem, como o Cloudflare, para evitar conflitos com a emissão do certificado SSL. Essa etapa pode parecer técnica, mas é essencial para que o acesso ao painel funcione sem interrupções.
Se precisar de ajuda com o Cloudflare, confira este guia sobre configuração de DNS no Cloudflare para garantir que tudo esteja ajustado corretamente.
⚠️ Atenção
Mantenha o proxy do Cloudflare (nuvem laranja) desativado durante a instalação. Depois de tudo funcionando e o certificado SSL emitido, você pode reativar se quiser a proteção adicional.
Configurando o SMTP para Envio de E-mails
Outro aspecto importante ao instalar o ChatWoot em um servidor VPS é a configuração do serviço de SMTP, que permite o envio de notificações por e-mail diretamente da plataforma.
Durante o processo de instalação, o sistema solicita informações como o e-mail de origem, usuário, senha, host e porta do serviço de SMTP. Um exemplo comum é o uso do SendGrid, com o host configurado como smtp.sendgrid.net e a porta padrão 587.
Esses dados devem ser inseridos com atenção, pois erros nessa etapa podem impedir o envio de mensagens importantes, como alertas ou confirmações para os usuários. Uma das vantagens de configurar o SMTP corretamente é a possibilidade de manter os clientes informados em tempo real, aumentando a confiabilidade do atendimento.
Para mais detalhes sobre o SendGrid, leia este artigo sobre envio de e-mails com SMTP SendGrid.
💡 Dica do Gabriel
Use sempre copia e cola para inserir credenciais no terminal. Um único caractere errado na chave de API do SMTP vai fazer seus emails falharem, e você vai perder tempo debugando algo que era só digitação. No SendGrid, o usuário é literalmente apikey, não seu email.
Confira a demonstração prática no vídeo:
Este vídeo faz parte de uma playlist completa sobre instalação de ferramentas em VPS. Acesse a playlist completa aqui.
Finalizando a Instalação do ChatWoot
Após configurar o DNS e o SMTP, o processo de instalar o ChatWoot em um servidor VPS entra na fase final. Nessa etapa, o instalador conclui o download e a configuração dos arquivos necessários, o que pode levar alguns minutos dependendo da velocidade do servidor.
Durante esse tempo, é importante não interromper o processo para evitar erros. Uma vez finalizada a instalação, você será direcionado para criar o primeiro usuário administrativo. Essa é a porta de entrada para o painel do ChatWoot.
Criando o Primeiro Usuário Administrativo
Ao terminar de instalar o ChatWoot em VPS, o sistema solicita a criação de um usuário administrativo para o primeiro acesso. Essa etapa envolve definir um nome de usuário, e-mail válido e uma senha segura.
É altamente recomendável usar uma senha forte, combinando letras, números e caracteres especiais, para proteger o acesso ao painel. Além disso, você pode inserir o nome da sua empresa e optar por receber atualizações sobre o ChatWoot, o que é útil para se manter informado sobre novas funcionalidades.
Com o usuário criado, você estará pronto para fazer login e começar a explorar o painel de controle, uma interface intuitiva que é o coração da ferramenta.
Explorando o Painel do ChatWoot
Depois de instalar o ChatWoot em um servidor VPS e criar o usuário administrativo, o primeiro login revela um painel rico em funcionalidades. A interface do ChatWoot é projetada para ser amigável, mesmo para iniciantes, permitindo que você gerencie conversas, configure integrações e monitore o desempenho do atendimento.
Uma das grandes vantagens é a possibilidade de centralizar múltiplos números de WhatsApp, facilitando a organização. À esquerda ficam as conversas, no centro o chat ativo, e nas configurações você gerencia usuários, canais e integrações.
👉 Quer dominar isso na prática? Na Academy do Gerenciando Web você tem acesso a mais de 40 cursos sobre WordPress, servidores, Mautic e automação, com suporte para tirar suas dúvidas.
Integrações e Recursos Adicionais
Um dos pontos fortes do ChatWoot é a capacidade de integração com outras ferramentas, algo que você pode explorar após instalar o ChatWoot em VPS.
A Evolution API permite conectar números de WhatsApp diretamente ao ChatWoot, e a integração já vem nativa. Se você ainda não instalou, veja o tutorial de Evolution API em VPS.
Para automações mais complexas, o N8N é o caminho. Você pode criar fluxos que respondem automaticamente, qualificam leads, ou integram com seu CRM. Saiba mais sobre como instalar o N8N em VPS para criar automações poderosas.
📊 Resultado Real
Caso de uso: Um cliente com 3 números de WhatsApp e média de 200 conversas/dia reduziu o tempo de resposta de 15 minutos para menos de 3 minutos após implementar ChatWoot + N8N com respostas automáticas de qualificação.
Implementação: Janeiro/2025
A combinação ChatWoot + Evolution API + N8N é poderosa para quem quer escalar atendimento sem aumentar equipe. Essas ferramentas trabalham muito bem juntas e reduzem o tempo gasto em tarefas repetitivas.
Erros Comuns e Como Evitar
Depois de ajudar centenas de pessoas com essa instalação, os erros mais frequentes são sempre os mesmos.
Servidor subdimensionado: ChatWoot com 4GB funciona, mas se você já tem Portainer, Traefik e outras aplicações, vai faltar memória. Monitore o consumo pelo Portainer e faça upgrade se necessário.
DNS não propagado: Se o painel não abre após a instalação, espere alguns minutos. DNS pode levar até 24 horas para propagar, embora geralmente seja muito mais rápido.
SMTP mal configurado: Se emails não chegam, verifique as credenciais. No SendGrid, o usuário é literalmente apikey, não seu email.
Proxy do Cloudflare ativo: Durante a instalação, mantenha o proxy desativado. Depois de tudo funcionando, você pode reativar se quiser.
Perguntas Frequentes
Quais são os requisitos mínimos para instalar o ChatWoot em um VPS?
Os requisitos mínimos incluem um servidor com pelo menos 4GB de RAM, embora 6GB ou mais sejam recomendados para melhor performance, especialmente com muitas conversas ativas ou outras aplicações no mesmo VPS.
Posso instalar o ChatWoot em um servidor já sobrecarregado?
Não é aconselhável. Se o servidor já estiver rodando outras aplicações pesadas, considere fazer um upgrade de recursos ou usar um VPS dedicado para garantir o desempenho do ChatWoot.
O que fazer se a versão principal do ChatWoot estiver offline durante a instalação?
Nesse caso, você pode optar por uma versão alternativa disponível no instalador. O processo de instalação não muda, e você pode atualizar para a versão principal quando ela estiver disponível novamente.
Por que configurar o SMTP é importante no ChatWoot?
O SMTP permite o envio de notificações por e-mail, como alertas e confirmações, diretamente da plataforma. Sem essa configuração, você perde uma funcionalidade essencial para manter os clientes informados.
É possível integrar o ChatWoot com outras ferramentas?
Sim, o ChatWoot suporta integrações nativas com ferramentas como a Evolution API e pode ser conectado a plataformas de automação como o N8N para criar fluxos personalizados de atendimento.
Quantos números de WhatsApp posso conectar?
Não há limite no ChatWoot. O limite está nos recursos do seu servidor. Cada número conectado consome memória adicional, então monitore o uso conforme adiciona mais canais.
👉 Quer começar sem compromisso? Crie sua conta gratuita na Academy e acesse alguns cursos liberados.
