WhatsApp: mudanças entre as edições

Edição atual tal como às 21h27min 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.

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 1: / Linha 1: @@
-__NOTOC__
-<div class="celta-full-width">
 {{Cabecalho
-  | [[Módulos e Apps]]
+  | [[Documentação]]
   | Configuração do WhatsApp (Evolution API)
 }}
-Este tutorial orienta a instalação e configuração da '''Evolution API''' no Windows para integração com o Celta.
+Este guia orienta a instalação e configuração da '''Evolution API''' utilizando a integração nativa com o '''Docker Desktop'''.
-Utilizamos o '''Docker Desktop''' para garantir estabilidade e gerenciamento simplificado do serviço.
+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 ==
-{{Nota|warning|REQUISITO CRÍTICO - VIRTUALIZAÇÃO|
+Antes de iniciar, garanta que o servidor atenda aos requisitos mínimos para virtualização.
-Para que o Docker funcione, a '''Virtualização''' deve estar habilitada na BIOS/UEFI do computador.
-* '''Como verificar:''' Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) > Aba Desempenho > CPU. Procure por "Virtualização: Habilitado".
+{{Nota|warning|REQUISITO DE BIOS / UEFI|Para o funcionamento do Docker, a '''Virtualização''' deve estar habilitada na BIOS do computador.
-* Se estiver "Desabilitado", reinicie o PC, acesse a BIOS e ative (procure por ''Intel VT-x'' ou ''AMD-V'').
+* '''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).}}
-== 1. Requisitos do Sistema ==
+=== Requisitos de Hardware/Software ===
-Certifique-se de que o computador servidor atende aos requisitos mínimos:
+* '''Sistema Operacional:''' Windows 10 (21H2+) ou Windows 11.
-* '''Sistema Operacional:''' Windows 10 (versão 21H2 ou superior) ou Windows 11.
+* '''Memória RAM:''' Mínimo 8GB (Recomendado 16GB).
-* '''Privilégios:''' O Sistema Celta deve ser executado como '''Administrador'''.
+* '''WSL 2:''' O Docker Desktop utiliza o subsistema Linux do Windows. O instalador do Docker geralmente ativa isso automaticamente.
-* '''Memória:''' Recomendado mínimo de 8GB de RAM (o Docker consome recursos consideráveis).
-== 2. Instalação Automática (Via Celta) ==
+== 2. Instalação Automática ==
-O Sistema Celta possui um assistente que automatiza o download, instalação e configuração do ambiente.
+O Celta possui um "Wizard" que configura o ambiente sem necessidade de comandos manuais.
-# Abra o Celta como '''Administrador'''.
+# Execute o Celta como '''Administrador'''.
-# Acesse o menu: '''Principal > WhatsApp > Configurações'''.
+# Acesse '''Principal > WhatsApp > Configurações'''.
-# No campo '''Host''', informe o IP fixo ou nome do computador servidor.
+# Na aba '''Configuração''':
-# Selecione a opção: '''Usar Docker Desktop'''.
+#* '''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'''.
-{{Nota|info|O QUE O SISTEMA ESTÁ FAZENDO?|
+{{Nota|info|BASTIDORES (O que o Celta faz?)|
-O Celta executará automaticamente os seguintes passos em segundo plano:
+Ao clicar em instalar, o sistema executa em segundo plano:
-# Cria o diretório <code>C:\Celta Sistemas\WhatsApp</code>.
+# Cria a pasta `C:\Celta Sistemas\WhatsApp`.
-# Gera os arquivos de configuração (<code>docker-compose.yaml</code> e <code>.env</code>) com o IP informado.
+# Gera o arquivo `docker-compose.yaml` configurado com o Host informado.
-# Verifica e solicita ativação do Hyper-V (se necessário).
+# Verifica se o Docker Desktop está instalado (inicia o download se não estiver).
-# Libera a porta '''8010''' no Firewall do Windows.
+# Sobe o container da Evolution API na porta '''8010'''.
-# Inicia o download e instalação do Docker Desktop (caso não exista).
-# Sobe os containers da API.
 }}
 === Validação ===
-Ao final do processo, o log na tela deve exibir: ''"Ambiente Docker configurado com sucesso"''.
+Aguarde o log na tela exibir: *"Ambiente Docker configurado com sucesso"*.
+Após isso, o status mudará para '''Aguardando escaneamento''' (QR Code).
-== 3. Pós-Instalação (Início Automático) ==
+== 3. Configuração de Inicialização ==
-Para garantir que o WhatsApp não pare de funcionar ao reiniciar o servidor, configure o Docker para iniciar junto com o Windows.
+Para garantir que a API suba automaticamente após uma queda de energia ou reinicialização do servidor:
 # Abra o '''Docker Desktop'''.
-# Vá em '''Settings''' (ícone da engrenagem) > '''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 to your computer'''.
+# 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'''.
+{{TabelaCampos|
+  {{Linha
+   | 1= Listar Instâncias
+   | 2= Clique em "Listar" para ver todas as sessões ativas no Docker.
+* Mostra: Nome, Número, Status e Data de Criação.
+  }}
+  {{Linha
+   | 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.
+* '''Deletar:''' Remove completamente a instância da API (útil para limpar cache ou erros de conexão).
+  }}
+}}
-== 4. Diagnóstico e Solução de Problemas ==
+== 5. Diagnóstico e Solução de Problemas ==
-Se a página da API (<code>http://localhost:8010</code>) não carregar ou houver erros no log, verifique a tabela abaixo:
+Se houver erros no Log ou o QR Code não aparecer, consulte a tabela abaixo.
 {{TabelaCampos|
    {{Linha
-   | tipo=check
     | 1= Erro: "Docker não instalado"
-    | 2= Ocasionalmente o instalador automático pode ser bloqueado.
+    | 2= O download automático falhou ou foi bloqueado.
-* '''Solução:''' Baixe e instale o Docker Desktop manualmente pelo site oficial e 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
-   | tipo=warning
     | 1= Erro: "Porta 8010 ocupada"
-    | 2= Algum outro software está usando a porta padrão da API.
+    | 2= Outro serviço está usando a porta da API.
-* '''Solução:''' Verifique se há outra instância da API rodando ou altere a porta no arquivo <code>.env</code> 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
-   | tipo=danger
+    | 1= Erro: "WSL error / Hyper-V"
-    | 1= Erro: "Hyper-V / WSL error"
+    | 2= O Windows não conseguiu iniciar o motor de virtualização.
-    | 2= O Windows não conseguiu ativar o subsistema Linux.
+* '''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. Em alguns Windows antigos, é necessário instalar o pacote de atualização do kernel WSL2 manualmente.
    }}
 }}
-</div>
+{{ContatoSuporte}}