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 ensina como instalar e configurar a Evolution API no Windows para integrar com o Celta.
+ | [[Documentação]]
+ | Configuração do WhatsApp (Evolution API)
+}}
-Oferecemos duas opções para isso:
+Este guia orienta a instalação e configuração da '''Evolution API''' utilizando a integração nativa com o '''Docker Desktop'''.
-* Via Docker Desktop, mais simples e gerenciada pelo Celta.
-* Via WSL (Ubuntu), para quem prefere um ambiente Linux.
-O objetivo é automatizar a instalaçã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.
-Queremos garantir que a API do WhatsApp funcione perfeitamente.
-=== Requisitos Comuns ===
+== 1. Pré-requisitos do Ambiente ==
-* '''Sistema Operacional''': Windows 10 ou superior (versões anteriores não são compatíveis com WSL 2 ou Docker Desktop).
-* '''Virtualização''': Habilitada na BIOS/UEFI (veja como verificar abaixo).
-* '''Privilégios''': O Celta e os scripts devem ser executados como administrador.
-=== Verificar Requisitos do Sistema ===
+Antes de iniciar, garanta que o servidor atenda aos requisitos mínimos para virtualização.
-# '''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.
-=== Verificar Virtualização na BIOS ===
+{{Nota|warning|REQUISITO DE BIOS / UEFI|Para o funcionamento do Docker, a '''Virtualização''' deve estar habilitada na BIOS do computador.
-# '''Checar se está habilitada''':
+* '''Verificação:''' Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) > Aba Desempenho > CPU.
-## Abra o Gerenciador de Tarefas (Ctrl + Shift + Esc).
+* Procure por "Virtualização: '''Habilitado'''".
-## Vá para a aba "Desempenho" e procure por "Virtualização" na seção da CPU.
+* Se estiver "Desabilitado", é necessário reiniciar o PC e ativar na BIOS (Intel VT-x ou AMD-V).}}
-## 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.
-== Configuração via Docker Desktop ==
+=== Requisitos de Hardware/Software ===
-Esta seção descreve a instalação simplificada da Evolution API usando o Docker Desktop.
+* '''Sistema Operacional:''' Windows 10 (21H2+) ou Windows 11.
-Tudo é gerenciado diretamente pelo Celta.
+* '''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.
-=== Passo a Passo ===
+== 2. Instalação Automática ==
-==== 1. Iniciar configuração ====
+O Celta possui um "Wizard" que configura o ambiente sem necessidade de comandos manuais.
-# Abra o Celta com permissões de administrador.
-# Navegue até:
-## '''Principal > WhatsApp > Configurações
-# Informe o host (ip ou nome do computador)
-# Confirme o IP com <code>ipconfig</code> no Prompt de Comando.
-==== 2. Executar a Configuração no Celta ====
+# Execute o Celta como '''Administrador'''.
-# Na mesma tela, selecione o modo "Usar Docker Desktop" e clique em "Iniciar Instalação".
+# Acesse '''Principal > WhatsApp > Configurações'''.
-# O Celta faz tudo automaticamente e mostra o progresso no log:
+# Na aba '''Configuração''':
-## Cria o diretório <code>C:\Celta Sistemas\WhatsApp</code>.
+#* '''Host:''' Informe o IP fixo ou Nome do Computador Servidor (Ex: `192.168.1.200`).
-## Gera os arquivos necessários para o Docker com o IP informado.
+#* '''Modo:''' Selecione a opção '''Usar Docker Desktop'''.
-## Verifica o Hyper-V e orienta a ativação, se necessário.
+# Clique em '''Iniciar Instalação'''.
-## Libera a porta 8010 no firewall.
-## Instala o Docker Desktop (inicia o download se ausente).
-## Inicia o Docker e sobe os containers da Evolution API.
-# Se concluído, o log exibe:
-## "Ambiente Docker configurado com sucesso".
-==== 3. Verificação Final ====
+{{Nota|info|BASTIDORES (O que o Celta faz?)|
-# Clique em "Atualizar" no Celta ou acesse <code>http://ENDEREÇO_HOST:8010</code> no navegador.
+Ao clicar em instalar, o sistema executa em segundo plano:
-# Se a página da Evolution API carregar, a configuração está pronta.
+# 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'''.
+}}
-=== 4. Habilite Docker Desktop para iniciar automaticamente com o Windows ===
+=== Validação ===
-# Acesse o Docker Desktop e navegue até:
+Aguarde o log na tela exibir: *"Ambiente Docker configurado com sucesso"*.
-## '''Settings > General > Habilite: Start Docker Desktop when you sign in to your computer.
+Após isso, o status mudará para '''Aguardando escaneamento''' (QR Code).
-=== Notas ===
+== 3. Configuração de Inicialização ==
-* '''Erros Comuns''':
-** '''"Docker não instalado"''': Instale manualmente após o download iniciado pelo Celta.
-** '''"Porta 8010 ocupada"''': Feche outros aplicativos ou libere a porta.
-** '''"Hyper-V desabilitado"''': Ative em "Recursos do Windows".
-* '''Logs''':
-** Veja o memo no Celta ou os containers no Docker Desktop.
-=== Resultado Esperado ===
+Para garantir que a API suba automaticamente após uma queda de energia ou reinicialização do servidor:
-A Evolution API estará ativa na porta 8010.
-Será gerenciada pelo Docker Desktop e integrada ao Celta.
-== Configuração via WSL (Ubuntu) ==
+# Abra o '''Docker Desktop'''.
-Esta seção descreve a instalação da Evolution API usando WSL e Ubuntu.
+# 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'''.
-=== Passo a Passo ===
+== 4. Gerenciamento de Sessões ==
-==== 1. Gerar Arquivos no Sistema Celta ====
+O Celta permite gerenciar múltiplas conexões (multitenancy) na aba '''Gerenciar'''.
-# Abra o Celta no computador que será o servidor.
-# Navegue até:
-## '''Principal > WhatsApp > Configurações
-# Selecione o modo "Usar WSL Ubuntu" e clique em "Iniciar Instalação".
-## <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).
-==== 2. Verificar Arquivos Obrigatórios ====
+{{TabelaCampos|
-# Navegue até <code>C:\Celta Sistemas\WhatsApp</code> no Explorador de Arquivos.
+  {{Linha
-# Confirme a presença dos arquivos:
+   | 1= Listar Instâncias
-## <code>Install.ps1</code> (script PowerShell) [https://www.dropbox.com/scl/fi/sgh1knqy1ive6b7mxd2gh/Install.ps1?rlkey=f0mowjuhhv4h03bnmd11mvw0t&st=6zyfh7ob&dl=0 Download]
+   | 2= Clique em "Listar" para ver todas as sessões ativas no Docker.
-## <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]
+* Mostra: Nome, Número, Status e Data de Criação.
-## <code>.env</code> (gerado pelo Celta)
+  }}
-## <code>docker-compose.yaml</code> (gerado pelo Celta)
+  {{Linha
-# Se algum arquivo estiver ausente, repita o passo 1 ou contate a equipe técnica.
+   | 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).
+  }}
+}}
-==== 3. Executar o Script PowerShell ====
+== 5. Diagnóstico e Solução de Problemas ==
-# Clique com o botão direito no PowerShell, selecione '''Executar como administrador'''.
-# Habilite a execução de scripts no PowerShell com o comando:
-## <code>Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted</code>
-# Navegue até o diretório do script (<code>cd C:\Celta Sistemas\WhatsApp</code>).
-# Execute o script com:
-## <code>.\Install.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.
-==== 4. Executar o Script Bash no WSL ====
+Se houver erros no Log ou o QR Code não aparecer, consulte a tabela abaixo.
-# 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.
-==== 5. Verificação Final ====
+{{TabelaCampos|
-# Verifique se a API está rodando:
+  {{Linha
-## Abra um navegador e acesse <code>http://localhost:8010</code>.
+   | 1= Erro: "Docker não instalado"
-## Se a página da Evolution API carregar, a configuração foi bem-sucedida.
+   | 2= O download automático falhou ou foi bloqueado.
-# Caso contrário, consulte as notas de erros abaixo.
+* '''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.
+  }}
+}}
-=== Notas ===
+{{ContatoSuporte}}
-* '''Erros Comuns''':
-** '''"Arquivos .env ou docker-compose.yaml não encontrados"''': Certifique-se de gerar os arquivos no Celta (passo 1).
-** '''"Falha ao habilitar Hyper-V ou WSL"''': Confirme que a virtualização está ativa na BIOS e que o Windows está atualizado.
-** '''"Serviço evolution-api.service não ativo"''': Verifique os logs (veja abaixo).
-* '''Onde Encontrar Logs''':
-** 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:
-## <code>debugConsole=true</code>
-## 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 ===
-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.