Instalar o Quest.
O Quest lê as conversas do WhatsApp de atendimento da loja e mostra o que os clientes mais perguntam e reclamam, em temas, perguntas frequentes, produtos e tags. Este guia instala tudo na sua própria conta Cloudflare, com a conexão do WhatsApp num servidor seu. Leva cerca de 40 minutos na primeira vez.
Antes de começar
Separe estas cinco coisas. Os custos são mensais e aproximados.
- Conta na Cloudflare com o plano pago dos Workers (US$ 5 por mês). Ele dá o tempo de processamento que a leitura do histórico precisa. Criar conta · Assinar o plano
- O seu domínio dentro da Cloudflare. O painel vai ficar num subdomínio, como
quest.suaempresa.com.br, que ainda não pode ter registro de DNS. Adicionar o domínio - Chave da API da Anthropic, com crédito na conta. É a IA que lê os atendimentos; cada atendimento custa uma fração de centavo. Criar a chave
- Um servidor Linux (Ubuntu ou Debian, 2 GB de memória, a partir de uns US$ 6 por mês) para a Evolution API, que mantém o WhatsApp conectado. Ele precisa de um subdomínio apontando para o IP dele, como
evo.suaempresa.com.br, e das portas 80 e 443 liberadas. - Node.js 20 ou mais novo no Mac. Baixe em nodejs.org (botão LTS) e instale como qualquer programa.
Evolution API no servidor
É ela que lê o QR code e entrega as mensagens do WhatsApp para o Quest.
Aponte o subdomínio para o servidor
No DNS do seu domínio na Cloudflare, crie um registro A com o nome evo e o IP do servidor, com a nuvem cinza (DNS only). Com a nuvem laranja o certificado não é emitido.
Mande a pasta e instale
Depois de baixar e abrir o pacote no Mac, no Terminal (troque o IP e o endereço pelos seus):
scp -r ~/Downloads/quest-instalador/evolution root@IP-DO-SERVIDOR:/opt/evolution
ssh root@IP-DO-SERVIDOR
Já dentro do servidor:
cd /opt/evolution && bash instalar-evolution.sh evo.suaempresa.com.br
O script instala o Docker se faltar, sobe a Evolution com HTTPS e mostra no fim a chave da Evolution. Guarde essa chave: o passo 2 pede.
Quest na Cloudflare, pelo Mac
Abra o Terminal (Aplicativos › Utilitários › Terminal) e rode um comando por vez.
cd ~/Downloads && unzip -o quest-instalador.zip
Se o Safari já abriu o .zip sozinho e a pasta quest-instalador existe, pule o comando acima.
cd ~/Downloads/quest-instalador && bash instalar.sh
O navegador abre para você entrar na Cloudflare. Depois o instalador pergunta:
| Pergunta | Exemplo |
|---|---|
| Endereço do painel | quest.suaempresa.com.br |
| Nome do sistema na Cloudflare | quest (pode deixar o sugerido) |
| E-mails dos administradores | voce@suaempresa.com.br,socio@suaempresa.com.br |
| E-mail remetente | nao-responda@suaempresa.com.br, do mesmo domínio que está na Cloudflare |
| Endereço da Evolution | https://evo.suaempresa.com.br |
| Chave da Evolution | a que apareceu no fim do passo 1 (não aparece na tela ao colar) |
| Chave da Anthropic | começa com sk-ant- |
Ele cria o banco, habilita o envio de e-mail no seu domínio, publica e grava as chaves. Se algo falhar no meio, corrija e rode bash instalar.sh de novo: o que já foi feito é reaproveitado.
Primeiro acesso
- Abra o endereço do painel e entre com um e-mail de administrador. O código chega por e-mail; na primeira vez pode levar até 15 minutos, enquanto o DNS do e-mail se espalha. Confira o spam.
- Clique em Nova conta e dê o nome da loja.
- Em Conexão, escolha se quer trazer o histórico do celular, gere o QR code e leia com o WhatsApp da loja (Aparelhos conectados › Conectar aparelho).
- Deixe o celular com internet e o WhatsApp aberto por uns 5 minutos, enquanto o histórico chega. A IA lê os atendimentos nos minutos seguintes.
Depois de instalado
Dar acesso para alguém da loja
Na conta, em Configurações › Acessos do cliente. Essa pessoa vê a conta e marca tags, mas não mexe na conexão.
Atualizar para uma versão nova
Abra o pacote novo por cima da pasta antiga (o seu wrangler.jsonc fica) e rode:
cd ~/Downloads/quest-instalador && npm install && npm run db:remote && npm run deploy
Ver o que está acontecendo
cd ~/Downloads/quest-instalador && npm run logs
Se algo não funcionar
| O que aparece | O que fazer |
|---|---|
| "O login ainda não foi configurado" | Rode bash instalar.sh de novo: falta gravar uma chave. |
| O código de acesso não chega | Espere 15 minutos e confira o spam. No painel da Cloudflare, em Email Service › Email Sending, o domínio precisa estar ativo. |
| Erro de domínio ao publicar | O subdomínio do painel já tem registro de DNS. Apague esse registro e rode o instalador de novo. |
| "O servidor da conexão não respondeu" | A Evolution está fora do ar, ou o endereço ou a chave estão errados. No servidor: cd /opt/evolution && docker compose ps |
| Os atendimentos não são lidos | Confira o crédito da conta Anthropic e rode npm run logs para ver o erro. |
| "command not found: node" | Instale o Node.js pelo site nodejs.org e abra uma janela nova do Terminal. |
A conexão por QR code não é a API oficial do WhatsApp: o número pode ser desconectado, e o risco cresce para quem dispara mensagens em massa. O Quest só lê as conversas.