Chatwoot na VPS: primeiro acesso, troca de senha e primeiros passos

O Chatwoot é uma plataforma de atendimento ao cliente. Ele junta numa tela só as conversas que chegam por vários canais, como o chat do seu site, e-mail e redes sociais, e permite que uma equipe inteira atenda junto. Na sua VPS ele já vem instalado, em português, com banco de dados próprio e HTTPS.

O que vale para todos os aplicativos (SSH, log, reiniciar) está no artigo Sua VPS com aplicativo: dados de acesso, onde fica cada coisa, ver o log, reiniciar o app.

Primeiro acesso

1. Abra o endereço que veio no e-mail: https://chat.SEU-IP.yhostbr.online (o IP da VPS com traços no lugar dos pontos).
2. Entre com o e-mail do seu cadastro na yHost e a senha que veio no e-mail.
3. O administrador já foi criado na instalação. A conta se chama yHost e o seu usuário se chama Admin, e você pode mudar os dois (veja em Primeiros passos).

O cadastro aberto de novas contas fica desligado: ninguém de fora consegue criar conta no seu Chatwoot.

Trocar a senha

1. No canto inferior esquerdo da tela, clique no seu avatar e no seu nome e depois em Configurações do Perfil.
2. Na parte Senha, preencha Senha atual, Nova senha e Confirme a nova senha.
3. Clique em Mudar Senha. Aparece "A sua senha foi alterada com sucesso".

A senha nova precisa ter pelo menos 6 caracteres, com pelo menos uma letra maiúscula, uma letra minúscula, um número e um caractere especial (por exemplo, # ou !).

Primeiros passos

Colocar o seu nome e o nome da empresa

• Seu nome: em Configurações do Perfil, troque Seu nome completo e, se quiser, o Nome para exibição, que é o nome que os clientes veem. Clique em Atualizar o Perfil.
• Nome da conta: no menu da esquerda, vá em Configurações > Conta, troque o Nome da Conta e clique em Atualizar configurações.

Criar uma caixa de entrada

Cada canal de atendimento (o chat do site, um e-mail, uma rede social) é uma caixa de entrada.

1. Vá em Configurações > Caixas de Entrada e clique em Adicionar Caixa de Entrada.
2. Escolha o canal. Para colocar um chat no seu site, escolha Site e preencha o nome e o Domínio do website.
3. Clique em Criar caixa de entrada e siga as etapas: na etapa de agentes, escolha quem vai atender essa caixa.
4. No fim, no canal Site, o Chatwoot mostra o código do chat para você colar no seu site.

Adicionar a sua equipe

Vá em Configurações > Agentes e clique em Adicionar Agente. Preencha Nome do Agente, Função (Administrador ou Agente) e Endereço de e-mail, e clique em Adicionar agente.

O agente novo recebe um e-mail com um link para criar a senha. Até clicar nesse link, ele aparece na lista como Verificação Pendente e não consegue entrar. Por isso, configure o envio de e-mail antes de adicionar agentes (veja abaixo).

E-mails do Chatwoot

O Chatwoot vem sem servidor de e-mail configurado. Por isso, até você configurar, ele não envia e-mails: nem o convite dos agentes, nem a recuperação de senha, nem os avisos de conversa nova. O atendimento em si funciona normalmente.

Para ligar os e-mails, você precisa dos dados SMTP de uma conta de e-mail sua: o servidor, a porta, o usuário e a senha. Quem informa esses dados é o seu provedor de e-mail. Com eles em mãos:

1. Entre na VPS pelo SSH e abra o arquivo de configuração do Chatwoot com um editor, por exemplo: nano /opt/yhost/chatwoot/docker-compose.yml.
2. No começo do arquivo fica o bloco x-cw-env. Logo abaixo da linha TZ: America/Sao_Paulo, que é a última desse bloco, acrescente as linhas abaixo, com os mesmos dois espaços no começo de cada linha:

     MAILER_SENDER_EMAIL: Atendimento <SEU-EMAIL>
     SMTP_ADDRESS: SEU-SERVIDOR-SMTP
     SMTP_PORT: "587"
     SMTP_USERNAME: SEU-EMAIL
     SMTP_PASSWORD: "SUA-SENHA-DO-EMAIL"
     SMTP_AUTHENTICATION: login

3. Troque SEU-EMAIL, SEU-SERVIDOR-SMTP e SUA-SENHA-DO-EMAIL pelos seus dados. Mantenha as aspas na senha e, se a senha tiver o símbolo $, escreva $$ no lugar dele.
4. Salve o arquivo (no nano: Ctrl+O, Enter e Ctrl+X) e aplique com cd /opt/yhost/chatwoot e depois docker compose up -d.

Se a sua conta de e-mail usa outra porta, troque o 587. Se tiver dúvida, abra um chamado antes de mexer no arquivo.

Onde roda na VPS

Problemas comuns

A página não abre logo depois da criação

A instalação leva alguns minutos depois que a VPS liga, e na primeira vez o Chatwoot ainda prepara o banco de dados. Espere uns 10 minutos e tente de novo numa janela anônima. Para acompanhar, veja o log da instalação pelo SSH: tail -n 30 /var/log/yhost-app.log.

O navegador avisa que a conexão não é segura

O certificado HTTPS ainda não saiu. Ele costuma sair poucos minutos depois da instalação e, se o endereço da VPS demorou a ficar pronto, o sistema tenta de novo sozinho a cada 10 minutos. Espere e recarregue a página. Enquanto o aviso aparecer, não digite sua senha. Se o aviso continuar depois de 1 hora, abra um chamado.

Esqueci a senha

Se você ainda não trocou a senha, a original está na VPS, no arquivo /root/yhost-app.txt (use cat /root/yhost-app.txt). A recuperação de senha por e-mail não funciona enquanto o envio de e-mail não for configurado. Se você já trocou a senha e esqueceu, abra um chamado.

O Chatwoot ficou lento

O Chatwoot precisa de pelo menos 4 GB de memória. Veja se todos os containers estão rodando com cd /opt/yhost/chatwoot e docker compose ps, e reinicie com docker compose restart. Se acontecer com frequência, fale com o suporte sobre um plano com mais memória.

Precisa de ajuda?

Abra um chamado em https://yhost.com.br/painel/suporte. Informe o IP da VPS e o que aconteceu. Se tiver uma mensagem de erro, mande um print.