Pular para o conteúdo principal

🌐 Configurando Chatwoot - Marketplace

⚠️ Todas as configurações demonstradas neste manual são exemplos simples e hipotéticos. Pode ser necessário realizar adaptações conforme a topologia e estrutura do seu ambiente.

Este guia mostra como realizar a instalação e acesso inicial ao Chatwoot instalado pelo Marketplace da SaveinCloud.

📌 O que é o Chatwoot?​

O Chatwoot é uma plataforma open-source de atendimento ao cliente que permite centralizar conversas de múltiplos canais em um único painel.
Com ele, sua equipe pode interagir com clientes via WhatsApp, Facebook, Instagram, Telegram, E-mail, Webchat e outros meios, de forma integrada e colaborativa.

Além disso, o Chatwoot oferece recursos como:

  • Gestão de múltiplos agentes e times de suporte;
  • Criação de caixas de entrada compartilhadas;
  • Automação de mensagens e fluxos de atendimento;
  • Integrações com APIs externas para ampliar funcionalidades.

Na SaveinCloud, o Chatwoot pode ser facilmente instalado via Marketplace.

Parte 1 - Instalação do Chatwoot via Marketplace​

  1. No painel da SaveinCloud, abra a aba Marketplace.
  2. Busque por "Chatwoot" e confirme a instalação.
  3. Aguarde a finalização e siga as instruções exibidas na tela.

imagem

⚠️ Este manual se aplica à instalação via Marketplace. Não cobre casos de instalação manual em VPS/VMs.

✅ Instalação Concluída

Parabéns! O Chatwoot foi instalado com sucesso pela SaveinCloud. Agora você conta com uma poderosa plataforma de atendimento ao cliente configurada com:

  • 🔗 Gerenciamento de Domínio via Nginx Proxy Manager
  • 🔒 Certificado SSL automático para conexões seguras
  • ↔️ Redirecionamento de HTTP para HTTPS

🚀 Próximos Passos​

  1. Acessar o Chatwoot: Entre pelo domínio configurado no Nginx Proxy Manager.
  2. Configurar o sistema: No painel do Chatwoot, personalize canais, usuários e fluxos de automação.
  3. Verificar conexão segura: Confirme que o certificado SSL está ativo no navegador.

🔧 Gerenciamento de Domínio com Nginx Proxy Manager​

Para ajustes de domínio e SSL, acesse o Nginx Proxy Manager:

  • URL: [http://Sua URL:81](http://Sua URL:81)
  • Credenciais temporárias:

Altere os dados de acesso

🔑 Importante: Altere os dados temporários após o primeiro login.

Configuração de Domínio Próprio​

  1. Crie um registro A apontando para o IP público ou um CNAME para o host.
  2. No Nginx Proxy Manager, vá em Proxy Hosts → Add Proxy Host.
  3. Em Domain Names, insira o domínio desejado.
  4. Em Forward Hostname/IP, use rails e em Port insira 3000.
  5. Ative Cache Assets e Websockets Support.
  6. Na aba SSL, selecione Request a New SSL Certificate, habilite Force SSL e HTTP/2 Support.

Configure SSL para seu domínio

💡 Dica: Mantenha o Docker e dependências atualizadas para segurança e estabilidade.

⚙️ Personalizações Avançadas​

Acesse o diretório /home/chatwoot para ajustes adicionais:

  • docker-compose.yaml → Alterar containers
  • .env → Configurar SMTP, domínio e variáveis

Acesse seu Chatwoot

Parte 2 - Acesso inicial e configuração do Chatwoot​

  1. Acesse a URL fornecida (exemplo: env-95696.sp1.br.saveincloud.net.br).
  2. Preencha os dados iniciais: Nome, Empresa, E-mail etc.
  3. Finalize e comece a utilizar o Chatwoot.

imagem

📖 Documentação adicional: Chatwoot Self-hosted

🛠️ Troubleshooting​

❌ Chatwoot não responde na porta 3000​

  • Causas: instalação incompleta ou aplicação parada.
  • Solução:
    1. Verifique no painel se o container está em execução.
    2. Caso não esteja, inicie manualmente.
    3. Se persistir, acesse os logs no painel.

⚠️ Variáveis de ambiente não aplicam​

  • Causas: serviço não reiniciado ou cache ativo, e necessidade de reiniciar o compose para atualização do .env.

  • Solução: Abra o WebSSH ou acesse o SSH externamente e rode os seguintes comandos:

    cd /home/chatwoot
    docker compose down && docker compose up -d

    Aguarde o reinício dos containers com docker ps

📄 Links Úteis​