WhatsApp

Este guia orienta a instalação e configuração da **Evolution API** utilizando a integração nativa com o **Docker Desktop**.

O Sistema Celta automatiza 90% do processo, baixando a imagem oficial, criando os arquivos de configuração (`docker-compose.yaml`) e gerenciando o serviço.

[Image of Docker Desktop logo]

1. Pré-requisitos do Ambiente

Antes de iniciar, garanta que o servidor atenda aos requisitos mínimos para virtualização.

REQUISITO DE BIOS / UEFI

Para o funcionamento do Docker, a **Virtualização** deve estar habilitada na BIOS do computador.

**Verificação:** Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) > Aba Desempenho > CPU.
Procure por "Virtualização: **Habilitado**".
Se estiver "Desabilitado", é necessário reiniciar o PC e ativar na BIOS (Intel VT-x ou AMD-V).

Requisitos de Hardware/Software

**Sistema Operacional:** Windows 10 (21H2+) ou Windows 11.
**Memória RAM:** Mínimo 8GB (Recomendado 16GB).
**WSL 2:** O Docker Desktop utiliza o subsistema Linux do Windows. O instalador do Docker geralmente ativa isso automaticamente.

2. Instalação Automática

O Celta possui um "Wizard" que configura o ambiente sem necessidade de comandos manuais.

Execute o Celta como **Administrador**.
Acesse **Principal > WhatsApp > Configurações**.
Na aba **Configuração**:
- **Host:** Informe o IP fixo ou Nome do Computador Servidor (Ex: `192.168.1.200`).
- **Modo:** Selecione a opção **Usar Docker Desktop**.
Clique em **Iniciar Instalação**.

BASTIDORES (O que o Celta faz?)

Ao clicar em instalar, o sistema executa em segundo plano:

Cria a pasta `C:\Celta Sistemas\WhatsApp`.
Gera o arquivo `docker-compose.yaml` configurado com o Host informado.
Verifica se o Docker Desktop está instalado (inicia o download se não estiver).
Sobe o container da Evolution API na porta **8010**.

Validação

Aguarde o log na tela exibir: *"Ambiente Docker configurado com sucesso"*. Após isso, o status mudará para **Aguardando escaneamento** (QR Code).

3. Configuração de Inicialização

Para garantir que a API suba automaticamente após uma queda de energia ou reinicialização do servidor:

Abra o **Docker Desktop**.
Clique no ícone de engrenagem (**Settings**) > **General**.
Marque a opção: **Start Docker Desktop when you sign in**.

4. Gerenciamento de Sessões

O Celta permite gerenciar múltiplas conexões (multitenancy) na aba **Gerenciar**.

Campo / Parâmetro	Função e Instruções
Listar Instâncias	Clique em "Listar" para ver todas as sessões ativas no Docker. Mostra: Nome, Número, Status e Data de Criação.
Desconectar / Excluir	Clique com o botão direito sobre uma instância na lista para: Desconectar: Encerra a sessão do WhatsApp Web. Deletar: Remove completamente a instância da API (útil para limpar cache ou erros de conexão).

5. Diagnóstico e Solução de Problemas

Se houver erros no Log ou o QR Code não aparecer, consulte a tabela abaixo.

Campo / Parâmetro	Função e Instruções
Erro: "Docker não instalado"	O download automático falhou ou foi bloqueado. Solução: Baixe e instale o Docker Desktop manualmente e depois clique em "Iniciar Instalação" no Celta novamente.
Erro: "Porta 8010 ocupada"	Outro serviço está usando a porta da API. Solução: Verifique conflitos ou altere a porta no arquivo `.env` dentro da pasta do WhatsApp e reinicie o container.
Erro: "WSL error / Hyper-V"	O Windows não conseguiu iniciar o motor de virtualização. Solução: Confirme se a Virtualização está ativa na BIOS e se o recurso "Plataforma de Máquina Virtual" está marcado nos Recursos do Windows.