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.

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.