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: @@
-== Tutorial de Configuração da Evolution API para WhatsApp no Celta ==
+{{Cabecalho
-Este tutorial orienta a instalação e configuração do ambiente WSL, Docker e Evolution API no Windows para integração com o Celta. O objetivo é automatizar a instalação e garantir que a API do WhatsApp esteja funcional.
+ | [[Documentação]]
+ | Configuração do WhatsApp (Evolution API)
+}}
-=== Requisitos ===
+Este guia orienta a instalação e configuração da '''Evolution API''' utilizando a integração nativa com o '''Docker Desktop'''.
-* '''Sistema Operacional''': Windows 10 ou superior (versões anteriores não são compatíveis com WSL 2).
-* '''Virtualização''': Habilitada na BIOS/UEFI (veja como verificar abaixo).
-* '''Privilégios''': Script deve ser executado como administrador.
-=== Passo a Passo ===
+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. Verificar Requisitos do Sistema ====
+== 1. Pré-requisitos do Ambiente ==
-# '''Confirme a versão do Windows''':
-## Abra o menu Iniciar, digite <code>winver</code> e pressione Enter.
-## Verifique se a versão é 10 ou superior (ex.: "Versão 22H2"). Caso contrário, atualize o sistema.
-==== 2. Verificar Virtualização na BIOS ====
+Antes de iniciar, garanta que o servidor atenda aos requisitos mínimos para virtualização.
-# '''Checar se está habilitada''':
-## Abra o Gerenciador de Tarefas (Ctrl + Shift + Esc).
-## Vá para a aba "Desempenho" e procure por "Virtualização" na seção da CPU.
-## Se estiver "Habilitado", prossiga. Se "Desabilitado", siga os passos abaixo.
-# '''Habilitar virtualização na BIOS''':
-## Reinicie o computador e entre na BIOS/UEFI (teclas comuns: F2, Del, F10 - consulte o manual da placa-mãe).
-## Procure por opções como "Intel VT-x", "AMD-V" ou "Virtualization Technology" (geralmente em "Advanced" ou "CPU Configuration").
-## Habilite a opção e salve as alterações (F10 para salvar e sair na maioria dos casos).
-## Reinicie o sistema e confirme no Gerenciador de Tarefas que a virtualização está ativa.
-==== 3. Gerar Arquivos no Sistema Celta ====
+{{Nota|warning|REQUISITO DE BIOS / UEFI|Para o funcionamento do Docker, a '''Virtualização''' deve estar habilitada na BIOS do computador.
-# Abra o Celta no computador que será o servidor.
+* '''Verificação:''' Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) > Aba Desempenho > CPU.
-# Navegue até:
+* Procure por "Virtualização: '''Habilitado'''".
-## '''Principal > WhatsApp > Configurações > Gerar Arquivos'''.
+* Se estiver "Desabilitado", é necessário reiniciar o PC e ativar na BIOS (Intel VT-x ou AMD-V).}}
-# Clique em "Gerar Arquivos" para criar:
-## <code>docker-compose.yaml</code>
-## <code>.env</code>
-# Esses arquivos serão salvos em <code>C:\Celta Sistemas\WhatsApp</code> com o IP fixo da máquina atual. Confirme que o IP no arquivo <code>.env</code> corresponde ao IP fixo do computador servidor (use <code>ipconfig</code> no Prompt de Comando para verificar).
-==== 4. Verificar Arquivos Obrigatórios ====
+=== Requisitos de Hardware/Software ===
-# Navegue até <code>C:\Celta Sistemas\WhatsApp</code> no Explorador de Arquivos.
+* '''Sistema Operacional:''' Windows 10 (21H2+) ou Windows 11.
-# Confirme a presença dos arquivos:
+* '''Memória RAM:''' Mínimo 8GB (Recomendado 16GB).
-## <code>Install.ps1</code> (script PowerShell) [https://www.dropbox.com/scl/fi/sgh1knqy1ive6b7mxd2gh/Install.ps1?rlkey=f0mowjuhhv4h03bnmd11mvw0t&st=6zyfh7ob&dl=0 Download]
+* '''WSL 2:''' O Docker Desktop utiliza o subsistema Linux do Windows. O instalador do Docker geralmente ativa isso automaticamente.
-## <code>setup_docker_api.sh</code> (script Bash) [https://www.dropbox.com/scl/fi/klwmqxa6z1tlnf2xe44nj/setup_docker_api.sh?rlkey=2q27ocm7p0cgcrtz506xkq0kj&st=x0brk8vq&dl=0 Download]
-## <code>.env</code> (gerado pelo ERP)
-## <code>docker-compose.yaml</code> (gerado pelo ERP)
-# Se algum arquivo estiver ausente, repita o passo 3 ou contate a equipe técnica.
-==== 5. Executar o Script PowerShell ====
+== 2. Instalação Automática ==
-## Clique com o botão direito no PowerShell, selecione '''Executar como administrador'' e abra o script fornecido.
-# Navegue até o diretório do script (ex.: <code>cd C:\Celta Sistemas\WhatsApp</code>).
-# Execute o script com:
-## <code>.\nome_do_script.ps1</code>
-# O script irá:
-## Habilitar Hyper-V e Plataforma da Máquina Virtual (pode exigir reinicialização).
-## Instalar o WSL e o Ubuntu-24.04.
-## Configurar o usuário "celta" no Ubuntu.
-## Instalar e configurar o Docker e a Evolution API.
-## Criar regras de firewall e tarefas agendadas.
-==== 6. Executar o Script Bash no WSL ====
+O Celta possui um "Wizard" que configura o ambiente sem necessidade de comandos manuais.
-# Após o script PowerShell instalar o WSL e Ubuntu, o script Bash (<code>setup_docker_api.sh</code>) será executado automaticamente.
-# Ele irá:
-## Atualizar pacotes no Ubuntu.
-## Instalar o Docker e Docker Compose.
-## Configurar o serviço da Evolution API para iniciar automaticamente.
-==== 7. Verificação Final ====
+# Execute o Celta como '''Administrador'''.
-# Verifique se a API está rodando:
+# Acesse '''Principal > WhatsApp > Configurações'''.
-## Abra um navegador e acesse <code>http://localhost:8010</code>.
+# Na aba '''Configuração''':
-## Se a página da Evolution API carregar, a configuração foi bem-sucedida.
+#* '''Host:''' Informe o IP fixo ou Nome do Computador Servidor (Ex: `192.168.1.200`).
-# Caso contrário, consulte as notas de erros abaixo.
+#* '''Modo:''' Selecione a opção '''Usar Docker Desktop'''.
+# Clique em '''Iniciar Instalação'''.
-=== Notas ===
+{{Nota|info|BASTIDORES (O que o Celta faz?)|
-* '''Erros Comuns''':
+Ao clicar em instalar, o sistema executa em segundo plano:
-** '''"Arquivos .env ou docker-compose.yaml não encontrados"''': Certifique-se de gerar os arquivos no Celta (passo 3).
+# Cria a pasta `C:\Celta Sistemas\WhatsApp`.
-** '''"Falha ao habilitar Hyper-V ou WSL"''': Confirme que a virtualização está ativa na BIOS e que o Windows está atualizado.
+# Gera o arquivo `docker-compose.yaml` configurado com o Host informado.
-** '''"Serviço evolution-api.service não ativo"''': Verifique os logs (veja abaixo).
+# Verifica se o Docker Desktop está instalado (inicia o download se não estiver).
-* '''Onde Encontrar Logs''':
+# Sobe o container da Evolution API na porta '''8010'''.
-** PowerShell: <code>%TEMP%\wsl_docker_setup_DDMMYYYY_HHMMSS.log</code> (ex.: <code>C:\Users\SeuUsuario\AppData\Local\Temp</code>).
+}}
-** Evolution API: No WSL, execute <code>cat /var/log/evolution-api.log</code>.
-** Status do serviço: No WSL, execute <code>sudo systemctl status evolution-api.service</code>.
-* '''Ativar Debug no WSL''':
-## No Windows, crie ou edite o arquivo <code>.wslconfig</code> em <code>C:\Users\SeuUsuario\.wslconfig</code> (substitua "SeuUsuario" pelo nome do seu usuário).
-## Adicione as linhas:
-## <pre>debugConsole=true</pre>
-## Salve o arquivo e reinicie o WSL com <code>wsl --shutdown</code> no PowerShell ou Prompt de Comando.
-## Os logs de depuração do WSL serão exibidos no console. Capture-os e envie para a equipe técnica, junto com os logs da Evolution API em <code>/var/log/evolution-api.log</code> (acessível via WSL com <code>cat /var/log/evolution-api.log</code>).
-=== Resultado Esperado ===
+=== Validação ===
-Após seguir os passos, a Evolution API estará rodando na porta 8010 e integrada ao Celta para uso do WhatsApp. O serviço iniciará automaticamente ao ligar o computador.
+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: <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).
+  }}
+}}
+== 5. Diagnóstico e Solução de Problemas ==
+Se houver erros no Log ou o QR Code não aparecer, consulte a tabela abaixo.
+{{TabelaCampos|
+  {{Linha
+   | 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.
+  }}
+  {{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.
+  }}
+  {{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.
+  }}
+}}
+{{ContatoSuporte}}