Ajuda Abrir chamado Fale conosco Entrar

Evolution API + Chatwoot na VPS: como conectar o WhatsApp no Chatwoot

Aplicativos na VPSAtualizado em

Neste kit, o Chatwoot (plataforma de atendimento) e a Evolution API (que conecta o WhatsApp) já vêm instalados e ligados entre si. As conversas do WhatsApp chegam numa caixa de entrada do Chatwoot, e você e sua equipe respondem por lá.

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.

O que vem no e-mail

  • Chatwoot: o endereço https://chat.SEU-IP.yhostbr.online, o e-mail de login (o do seu cadastro na yHost) e a senha.
  • Evolution API: o painel https://evo.SEU-IP.yhostbr.online/manager, a URL da API e a API key (chave de acesso).
  • Instância WhatsApp: o nome da conexão do WhatsApp que já foi criada para você. Ele começa com whatsapp-.

Nos endereços, SEU-IP é o IP da VPS com traços no lugar dos pontos.

Primeiro acesso ao Chatwoot

  1. Abra https://chat.SEU-IP.yhostbr.online.
  2. Entre com o e-mail do seu cadastro na yHost e a senha que veio no e-mail.
  3. A tela já vem em português. A conta se chama yHost e o seu usuário se chama Admin, e você pode mudar os dois (veja em Primeiros passos).

Conectar o WhatsApp

A conexão do WhatsApp é feita por dentro do Chatwoot, numa conversa com um contato-robô da integração, chamado EvolutionAPI.

  1. No menu da esquerda, clique em Conversas e, em Canais, clique em WhatsApp.
  2. No alto da lista de conversas, clique na aba Todos e abra a conversa com o contato EvolutionAPI.
  3. Leia a nota que está na conversa: ela resume estes passos.
  4. Na caixa de texto embaixo da conversa, deixe marcada a opção Responder (e não Mensagem Privada). Digite /iniciar e clique em Enviar. Se aparecer uma lista de respostas prontas quando você digitar a barra, ignore a lista.
  5. Em alguns segundos, o QR code aparece na própria conversa, com a mensagem "QRCode gerado com sucesso!".
  6. No celular com o número que vai atender, abra o WhatsApp. No Android, toque no ícone ⋮ (três pontinhos) e depois em Dispositivos conectados e Conectar dispositivo. No iPhone, toque em Configurações (ou na sua foto do perfil) e depois em Dispositivos conectados e Conectar dispositivo.
  7. Aponte a câmera do celular para o QR code na tela do computador.
  8. Cada QR code vale cerca de 40 segundos. Se ele vencer antes de você ler, um novo aparece sozinho na conversa: leia sempre o último.
  9. Quando der certo, o robô avisa "Conectado com sucesso!".

Pronto: as conversas do WhatsApp passam a chegar na caixa de entrada WhatsApp do Chatwoot, e o que você responde por lá sai pelo seu WhatsApp. Cada resposta chega ao cliente com o seu nome em negrito na primeira linha.

Outros comandos que você pode mandar na conversa do robô:

  • /status: mostra o estado da conexão. open quer dizer conectado, connecting quer dizer que ele está esperando a leitura do QR code e close quer dizer desconectado.
  • /desconectar: desliga o WhatsApp desta caixa de entrada.
A conversa com o contato EvolutionAPI é só com o robô da integração: nada do que você escreve nela vai para clientes. Deixe essa conversa aberta, sem clicar em Resolver. Com ela resolvida, o QR code e as respostas do robô não aparecem.

Trocar a senha do Chatwoot

  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: clique no seu avatar, no canto inferior esquerdo, e depois em Configurações do Perfil. Troque Seu nome completo e o Nome para exibição e clique em Atualizar o Perfil. Capriche no nome para exibição: as respostas chegam no WhatsApp do cliente com esse nome, em negrito, na primeira linha.
  • Nome da conta: no menu da esquerda, vá em Configurações > Conta, troque o Nome da Conta e clique em Atualizar configurações.

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, e o Chatwoot não vem com envio de e-mail configurado. Por isso, configure o envio de e-mail antes de adicionar agentes: o passo a passo está no artigo Chatwoot na VPS, na parte "E-mails do Chatwoot". Neste kit, a pasta do Chatwoot é a mesma: /opt/yhost/chatwoot.

Colocar a equipe na caixa WhatsApp

Quem tem a função Agente só vê as conversas das caixas de entrada em que foi incluído. Administradores veem todas. Para incluir:

  1. Vá em Configurações > Caixas de Entrada.
  2. Na linha WhatsApp, clique no ícone de engrenagem (Configurações).
  3. Abra a aba Agentes, escolha as pessoas no campo Agentes e clique em Atualizar.

Cuidados com o WhatsApp

  • A Evolution API conecta o WhatsApp do mesmo jeito que o WhatsApp Web, como um dispositivo conectado ao seu celular. Não é a API oficial do WhatsApp para empresas.
  • Evite mensagens em massa e mensagens para quem não pediu. O WhatsApp pode bloquear números que fazem isso.
  • Abra o WhatsApp no celular principal pelo menos uma vez a cada 14 dias. É uma regra do WhatsApp: se o celular principal ficar mais tempo sem usar o app, os dispositivos conectados são desconectados.

Onde roda na VPS

Chatwoot pasta /opt/yhost/chatwoot, containers rails (o site), sidekiq (tarefas em segundo plano), postgres (banco de dados) e redis
Evolution API pasta /opt/yhost/evolution, containers api, postgres e redis
Reiniciar entre na pasta do app (cd /opt/yhost/chatwoot ou cd /opt/yhost/evolution) e use docker compose restart

Problemas comuns

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

Este kit leva alguns minutos para instalar depois que a VPS liga. 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.

Mandei /iniciar e o QR code não apareceu

  • Confira se a mensagem foi enviada com a opção Responder marcada. O que vai como Mensagem Privada não chega ao robô.
  • Confira se a conversa com o robô está aberta. Se ela foi resolvida, o robô não consegue escrever nela. Para reabrir: na lista de conversas, clique no botão de setas (Ordenar conversas), em Status escolha Resolvidas, abra a conversa com EvolutionAPI e clique em Reabrir, no alto da conversa. Depois mande /iniciar de novo.

O robô avisou "Limite de geração de QRCode atingido"

Quando nenhum QR code é lido, o robô para de gerar códigos depois de um tempo. Mande /iniciar de novo na mesma conversa para recomeçar. A mensagem do robô fala em init: os dois comandos funcionam.

O WhatsApp desconectou

Mande /status na conversa do robô para conferir. Se a resposta for close, mande /iniciar e leia o QR code de novo. Confira também se o celular principal está com internet e se o WhatsApp foi aberto nele nos últimos 14 dias.

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.

Ainda com dúvida? A nossa equipe ajuda pelo chamado.

Abrir chamado