Whaticket: Guia Completo de Instalação Local (2025)

---

Bora pra ação, galera! Se você quer colocar o seu pezinho no universo dos sistemas de multi-atendimento para WhatsApp, nada melhor do que começar com o famigerado Whaticket. Ele é o sistema open-source mais conhecido do mercado, permitindo que você use uma única conta de WhatsApp com múltiplos usuários.

Criado e disponibilizado de forma gratuita pelo grande desenvolvedor Cássio, o K9, o Whaticket é a porta de entrada perfeita para quem quer entender como essa tecnologia funciona. Neste tutorial, faremos uma instalação rápida, localmente no seu computador, sem gastar nada!

Passo 1: Preparando o Ambiente (Pré-requisitos)

Antes de começarmos, você precisa ter três ferramentas instaladas no seu PC. Se ainda não as tiver, utilize os links de download para instalá-las.

• Docker Desktop: Usado para subir nosso banco de dados de forma simples.
• Git: Essencial para clonar o repositório oficial do Whaticket.
• Node.js: O motor que vai rodar toda a aplicação.

Após instalar tudo, abra seu terminal (PowerShell no Windows) e verifique se as instalações foram bem-sucedidas com os seguintes comandos:

node -v

git --version

Se ambos os comandos retornarem um número de versão, você está pronto para continuar!

Passo 2: Clonando o Repositório do Whaticket

Com o ambiente pronto, vamos baixar o código-fonte do projeto.

1. Abra o terminal na sua Área de Trabalho (ou em qualquer pasta de sua preferência).
2. Execute o comando abaixo para clonar o repositório do GitHub:

   git clone https://github.com/canove/whaticket whaticket-community

   Este comando criará uma pasta chamada whaticket-community com todos os arquivos do sistema.

Passo 3: Configurando o Backend (O Motor)

O backend é a parte do sistema que cuida de toda a lógica, regras de negócio e comunicação com o banco de dados.

1. Navegue até a pasta do projeto:

   cd whaticket-community

2. Suba o Banco de Dados com Docker:

   docker-compose up -d mysql

   Isso criará um contêiner no seu Docker Desktop com o banco de dados MySQL já configurado.

3. Configure o arquivo de ambiente:
   • Navegue até a subpasta backend.
   • Renomeie o arquivo env.example para apenas .env.
   • Abra o arquivo .env com um editor de texto (como o Bloco de Notas).
   • Altere as credenciais do banco para as seguintes:

     DB_USER=root
     DB_PASS=
     DB_NAME=whaticket

4. Instale as dependências do backend:
   • Abra um novo terminal dentro da pasta backend.
   • Execute o comando:

     npm install

5. Prepare o Banco de Dados:
   • Após a instalação, rode o comando para criar as tabelas:

     npx sequelize db:migrate

   • Agora, popule as tabelas com os dados iniciais:

     npx sequelize db:seed:all

6. Inicie o servidor do backend:

   npm run dev

   Se tudo deu certo, você verá uma mensagem dizendo que o servidor está rodando na porta 8080.

Passo 4: Configurando o Frontend (A Interface)

O frontend é a parte visual do sistema, o site que você e seus usuários irão acessar para interagir com o Whaticket.

1. Configure o arquivo de ambiente:
   • Navegue até a subpasta frontend.
   • Renomeie o arquivo env.example para .env. Não é necessário alterar nada dentro dele, pois ele já aponta para o backend na porta 8080.
2. Instale as dependências do frontend:
   • Abra um novo terminal dentro da pasta frontend.
   • Execute o comando:

     npm install --force

3. Inicie a aplicação do frontend:

   npm start

Seu navegador abrirá automaticamente no endereço http://localhost:3000 com a tela de login do Whaticket!

Credenciais de Acesso Padrão:

• Usuário: [email protected]
• Senha: admin

Próximos Passos

Parabéns! Você tem uma instância funcional do Whaticket rodando localmente. Este é o primeiro passo ideal para entender a estrutura, customizar e até mesmo começar a desenvolver suas próprias funcionalidades. Se você quer ir além, considere:

• Comunidade ZDG: Em nossa comunidade, temos uma versão do Whaticket customizada com mais de 30 novas funções, como integração com Typebot, disparo em massa e muito mais.
• Z-PRO: Se você já tem uma base e busca um sistema avançado, Omni-Channel e com suporte dedicado para revenda, conheça o Z-PRO.

O espaço no mercado é grande. Comece pelo básico, entenda a ferramenta e cresça a partir daí. Forte abraço e qualquer dúvida é só chamar!