Passo 1/7

Guia de Instalacao — ZapAutoma

Siga os 7 passos abaixo e seu bot estara funcionando.

Tempo total: ~10 minutos
1
Instalar Node.js
~2 min

Node.js e o motor que roda o ZapAutoma. Voce precisa da versao 22 ou superior.

Baixar Node.js

Apos instalar, abra o terminal e verifique:

$ node --version
v22.x.x
Dica: No Windows, basta baixar o instalador e clicar "Next" ate o fim. No Mac, use o instalador .pkg. No Linux: curl -fsSL https://fnm.vercel.app/install | bash
2
Instalar ZapAutoma
~2 min

Descompacte o ZIP do ZapAutoma, abra o terminal na pasta e rode o instalador:

$ cd zapautoma
$ bash install.sh

Ou manualmente:

$ npm install
Dica: No Windows, use o PowerShell ou Git Bash. Se nao tiver o bash, o npm install funciona igual.
3
Pegar sua Chave de IA
~2 min

A IA do ZapAutoma usa o Google Gemini. Voce precisa de uma chave gratuita.

Criar Chave (Google AI Studio)
  1. Acesse o link acima e faca login com sua conta Google
  2. Clique em "Create API Key"
  3. Copie a chave gerada (comeca com AIza...)
Dica: A chave e gratuita. O Google oferece um limite generoso de uso gratis. Na pratica, um bot de atendimento gasta ~R$0.02/dia.
4
Configurar Variaveis
~1 min

Copie o arquivo .env.example para .env e preencha:

$ cp .env.example .env

Edite o arquivo .env com seus dados:

# Chave da IA (obrigatorio)
GOOGLE_API_KEY=sua-chave-aqui

# Token de seguranca da extensao (obrigatorio)
EXTENSION_TOKEN=qualquer-senha-forte

# Porta do servidor (opcional, padrao 3001)
PORT=3001
Dica: O EXTENSION_TOKEN pode ser qualquer texto. Exemplo: minha-loja-2026. Voce vai usar esse mesmo token na extensao do Chrome.
5
Instalar Extensao Chrome
~1 min

A extensao e o que conecta o ZapAutoma ao seu WhatsApp Web.

  1. Abra chrome://extensions no Chrome (cole na barra de endereco)
  2. Ative o "Modo do desenvolvedor" (toggle no canto superior direito)
  3. Clique em "Carregar sem compactacao"
  4. Selecione a pasta extension/ dentro do ZapAutoma

Voce vera o icone do ZapAutoma na barra de extensoes do Chrome.

Dica: Funciona no Chrome, Brave e Edge (todos baseados em Chromium). No Firefox nao funciona.
6
Ativar o Bot
~1 min

Agora vamos ligar tudo:

  1. Inicie o servidor no terminal:
    $ npm run dev
    ou use o launcher: bash open.sh
  2. Abra web.whatsapp.com no Chrome
  3. Clique no icone do ZapAutoma na barra de extensoes
  4. Configure o URL do servidor: http://localhost:3001
  5. Cole o Token (o mesmo EXTENSION_TOKEN do .env)
  6. Ative o bot (toggle ON)

Voce vera o badge verde "Bot Ativo" no canto do WhatsApp Web.

Dica: Se o badge nao aparecer, recarregue a pagina do WhatsApp Web (F5).
7
Testar!
~1 min

Peca pra alguem (ou use outro numero) enviar uma mensagem no seu WhatsApp:

Cliente
Oi, quero fazer um pedido
Bot (automatico)
Ola! Bem-vindo! Como posso ajudar voce hoje? Temos um cardapio completo disponivel!

Confira se tudo esta funcionando:

  • ✓ Bot respondeu automaticamente
  • ✓ Dashboard mostra a conversa (localhost:3001/dashboard)
  • ✓ Tempo de resposta menor que 3 segundos
  • ✓ Badge "Bot Ativo" visivel no WhatsApp Web
🎉

Parabens! Seu ZapAutoma esta funcionando!

Agora e so deixar o computador ligado e o bot responde sozinho 24h.

Algo deu errado? Verifique: (1) o servidor esta rodando? (2) o token da extensao bate com o .env? (3) a extensao esta ativada? Se nada funcionar, me chama no WhatsApp.
?