WhatsApp: mudanças entre as edições

Edição das 21h26min de 9 de dezembro de 2025

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.

@@ Linha 4: / Linha 4: @@
 }}
-Este guia orienta a instalação e configuração da **Evolution API** utilizando a integração nativa com o **Docker Desktop**.
+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.
@@ Linha 19: / Linha 19: @@
 Antes de iniciar, garanta que o servidor atenda aos requisitos mínimos para virtualização.
-{{Nota|warning|REQUISITO DE BIOS / UEFI|Para o funcionamento do Docker, a **Virtualização** deve estar habilitada na BIOS do computador.
+{{Nota|warning|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.
+* '''Verificação:''' Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) > Aba Desempenho > CPU.
-* Procure por "Virtualização: **Habilitado**".
+* 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.
+* '''Sistema Operacional:''' Windows 10 (21H2+) ou Windows 11.
-* **Memória RAM:** Mínimo 8GB (Recomendado 16GB).
+* '''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.
+* '''WSL 2:''' O Docker Desktop utiliza o subsistema Linux do Windows. O instalador do Docker geralmente ativa isso automaticamente.
 == 2. Instalação Automática ==
@@ Linha 35: / Linha 35: @@
-# Execute o Celta como **Administrador**.
+# Execute o Celta como '''Administrador'''.
-# Acesse **Principal > WhatsApp > Configurações**.
+# Acesse '''Principal > WhatsApp > Configurações'''.
-# Na aba **Configuração**:
+# Na aba '''Configuração''':
-#* **Host:** Informe o IP fixo ou Nome do Computador Servidor (Ex: `192.168.1.200`).
+#* '''Host:''' Informe o IP fixo ou Nome do Computador Servidor (Ex: `192.168.1.200`).
-#* **Modo:** Selecione a opção **Usar Docker Desktop**.
+#* '''Modo:''' Selecione a opção '''Usar Docker Desktop'''.
-# Clique em **Iniciar Instalação**.
+# Clique em '''Iniciar Instalação'''.
 {{Nota|info|BASTIDORES (O que o Celta faz?)|
@@ Linha 47: / Linha 47: @@
 # 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**.
+# 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).
+Após isso, o status mudará para '''Aguardando escaneamento''' (QR Code).
 == 3. Configuração de Inicialização ==
@@ Linha 58: / Linha 58: @@
 Para garantir que a API suba automaticamente após uma queda de energia ou reinicialização do servidor:
-# Abra o **Docker Desktop**.
+# Abra o '''Docker Desktop'''.
-# Clique no ícone de engrenagem (**Settings**) > **General**.
+# Clique no ícone de engrenagem ('''Settings''') > '''General'''.
-# Marque a opção: <i class="bi bi-check-square-fill" style="color:#0d6efd;"></i> **Start Docker Desktop when you sign in**.
+# Marque a opção: <i class="bi bi-check-square-fill" style="color:#0d6efd;"></i> '''Start Docker Desktop when you sign in'''.
 == 4. Gerenciamento de Sessões ==
-O Celta permite gerenciar múltiplas conexões (multitenancy) na aba **Gerenciar**.
+O Celta permite gerenciar múltiplas conexões (multitenancy) na aba '''Gerenciar'''.
 {{TabelaCampos|
@@ Linha 75: / Linha 75: @@
     | 1= Desconectar / Excluir
     | 2= Clique com o botão direito sobre uma instância na lista para:
-* **Desconectar:** Encerra a sessão do WhatsApp Web.
+* '''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).
+* '''Deletar:''' Remove completamente a instância da API (útil para limpar cache ou erros de conexão).
    }}
 }}
@@ Linha 88: / Linha 88: @@
     | 1= Erro: "Docker não instalado"
     | 2= O download automático falhou ou foi bloqueado.
-* **Solução:** Baixe e instale o [https://www.docker.com/products/docker-desktop/ Docker Desktop] manualmente e depois clique em "Iniciar Instalação" no Celta novamente.
+* '''Solução:''' Baixe e instale o [https://www.docker.com/products/docker-desktop/ Docker Desktop] manualmente e depois clique em "Iniciar Instalação" no Celta novamente.
    }}
    {{Linha
     | 1= Erro: "Porta 8010 ocupada"
     | 2= 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.
+* '''Solução:''' Verifique conflitos ou altere a porta no arquivo `.env` dentro da pasta do WhatsApp e reinicie o container.
    }}
    {{Linha
     | 1= Erro: "WSL error / Hyper-V"
     | 2= 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.
+* '''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.
    }}
 }}
 {{ContatoSuporte}}