WhatsApp: mudanças entre as edições

Edição das 04h33min de 30 de novembro de 2025

Este tutorial orienta a instalação e configuração da Evolution API no Windows para integração com o Celta. Utilizamos o Docker Desktop para garantir estabilidade e gerenciamento simplificado do serviço.

REQUISITO CRÍTICO - 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".
Se estiver "Desabilitado", reinicie o PC, acesse a BIOS e ative (procure por Intel VT-x ou AMD-V).

1. Requisitos do Sistema

Certifique-se de que o computador servidor atende aos requisitos mínimos:

Sistema Operacional: Windows 10 (versão 21H2 ou superior) ou Windows 11.
Privilégios: O Sistema Celta deve ser executado como Administrador.
Memória: Recomendado mínimo de 8GB de RAM (o Docker consome recursos consideráveis).

2. Instalação Automática (Via Celta)

O Sistema Celta possui um assistente que automatiza o download, instalação e configuração do ambiente.

Abra o Celta como Administrador.
Acesse o menu: Principal > WhatsApp > Configurações.
No campo Host, informe o IP fixo ou nome do computador servidor.
Selecione a opção: Usar Docker Desktop.
Clique em Iniciar Instalação.

O QUE O SISTEMA ESTÁ FAZENDO?

O Celta executará automaticamente os seguintes passos em segundo plano:

Cria o diretório C:\Celta Sistemas\WhatsApp.
Gera os arquivos de configuração (docker-compose.yaml e .env) com o IP informado.
Verifica e solicita ativação do Hyper-V (se necessário).
Libera a porta 8010 no Firewall do Windows.
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".

3. Pós-Instalação (Início Automático)

Para garantir que o WhatsApp não pare de funcionar ao reiniciar o servidor, configure o Docker para iniciar junto com o Windows.

Abra o Docker Desktop.
Vá em Settings (ícone da engrenagem) > General.
Marque a opção: Start Docker Desktop when you sign in to your computer.

4. Diagnóstico e Solução de Problemas

Se a página da API (http://localhost:8010) não carregar ou houver erros no log, verifique a tabela abaixo:

Campo / Parâmetro	Função e Instruções
Erro: "Docker não instalado"	Ocasionalmente o instalador automático pode ser bloqueado. Solução: Baixe e instale o Docker Desktop manualmente pelo site oficial e clique em "Iniciar Instalação" no Celta novamente.
Erro: "Porta 8010 ocupada"	Algum outro software está usando a porta padrão da API. Solução: Verifique se há outra instância da API rodando ou altere a porta no arquivo `.env` e reinicie o container.
Erro: "Hyper-V / WSL error"	O Windows não conseguiu ativar o subsistema Linux. 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.

@@ Linha 1: / Linha 1: @@
-== Tutorial de Configuração do WhatsApp no Celta ==
+__NOTOC__
-Este tutorial ensina como instalar e configurar a Evolution API no Windows para integrar com o Celta.
+<div class="celta-full-width">
-Oferecemos duas opções para isso:
+{{Cabecalho
-* Via Docker Desktop, mais simples e gerenciada pelo Celta.
+  | [[Módulos e Apps]]
-* Via WSL (Ubuntu), para quem prefere um ambiente Linux.
+  | Configuração do WhatsApp (Evolution API)
+}}
-O objetivo é automatizar a instalação.
+Este tutorial orienta a instalação e configuração da '''Evolution API''' no Windows para integração com o Celta.
-Queremos garantir que a API do WhatsApp funcione perfeitamente.
+Utilizamos o '''Docker Desktop''' para garantir estabilidade e gerenciamento simplificado do serviço.
-=== Requisitos Comuns ===
+{{Nota|warning|REQUISITO CRÍTICO - VIRTUALIZAÇÃO|
-* '''Sistema Operacional''': Windows 10 ou superior (versões anteriores não são compatíveis com WSL 2 ou Docker Desktop).
+Para que o Docker funcione, a '''Virtualização''' deve estar habilitada na BIOS/UEFI do computador.
-* '''Virtualização''': Habilitada na BIOS/UEFI (veja como verificar abaixo).
+* '''Como verificar:''' Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) > Aba Desempenho > CPU. Procure por "Virtualização: Habilitado".
-* '''Privilégios''': O Celta e os scripts devem ser executados como administrador.
+* Se estiver "Desabilitado", reinicie o PC, acesse a BIOS e ative (procure por ''Intel VT-x'' ou ''AMD-V'').
+}}
-=== Verificar Requisitos do Sistema ===
+== 1. Requisitos do Sistema ==
-# '''Confirme a versão do Windows''':
+Certifique-se de que o computador servidor atende aos requisitos mínimos:
-## Abra o menu Iniciar, digite <code>winver</code> e pressione Enter.
+* '''Sistema Operacional:''' Windows 10 (versão 21H2 ou superior) ou Windows 11.
-## Verifique se a versão é 10 ou superior (ex.: "Versão 22H2").
+* '''Privilégios:''' O Sistema Celta deve ser executado como '''Administrador'''.
-## Caso contrário, atualize o sistema.
+* '''Memória:''' Recomendado mínimo de 8GB de RAM (o Docker consome recursos consideráveis).
-=== Verificar Virtualização na BIOS ===
+== 2. Instalação Automática (Via Celta) ==
-# '''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.
-== Configuração via Docker Desktop ==
+O Sistema Celta possui um assistente que automatiza o download, instalação e configuração do ambiente.
-Esta seção descreve a instalação simplificada da Evolution API usando o Docker Desktop.
-Tudo é gerenciado diretamente pelo Celta.
-=== Passo a Passo ===
+# Abra o Celta como '''Administrador'''.
+# Acesse o menu: '''Principal > WhatsApp > Configurações'''.
+# No campo '''Host''', informe o IP fixo ou nome do computador servidor.
+# Selecione a opção: '''Usar Docker Desktop'''.
+# Clique em '''Iniciar Instalação'''.
-==== 1. Iniciar configuração ====
+{{Nota|info|O QUE O SISTEMA ESTÁ FAZENDO?|
-# Abra o Celta com permissões de administrador.
+O Celta executará automaticamente os seguintes passos em segundo plano:
-# Navegue até:
+# Cria o diretório <code>C:\Celta Sistemas\WhatsApp</code>.
-## '''Principal > WhatsApp > Configurações
+# Gera os arquivos de configuração (<code>docker-compose.yaml</code> e <code>.env</code>) com o IP informado.
-# Informe o host (ip ou nome do computador)
+# Verifica e solicita ativação do Hyper-V (se necessário).
-# Confirme o IP com <code>ipconfig</code> no Prompt de Comando.
+# Libera a porta '''8010''' no Firewall do Windows.
+# Inicia o download e instalação do Docker Desktop (caso não exista).
+# Sobe os containers da API.
+}}
-==== 2. Executar a Configuração no Celta ====
+=== Validação ===
-# Na mesma tela, selecione o modo "Usar Docker Desktop" e clique em "Iniciar Instalação".
+Ao final do processo, o log na tela deve exibir: ''"Ambiente Docker configurado com sucesso"''.
-# O Celta faz tudo automaticamente e mostra o progresso no log:
-## Cria o diretório <code>C:\Celta Sistemas\WhatsApp</code>.
-## Gera os arquivos necessários para o Docker com o IP informado.
-## Verifica o Hyper-V e orienta a ativação, se necessário.
-## 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. Habilitar Docker Desktop para iniciar automaticamente ====
+== 3. Pós-Instalação (Início Automático) ==
-# Acesse o Docker Desktop e navegue até:
-## '''Settings > General > Habilite: Start Docker Desktop when you sign in to your computer.
-==== 4. Verificação Final ====
+Para garantir que o WhatsApp não pare de funcionar ao reiniciar o servidor, configure o Docker para iniciar junto com o Windows.
-# Clique em "Atualizar" no Celta ou acesse <code>http://ENDEREÇO_HOST:8010</code> no navegador.
-# Se a página da Evolution API carregar, a configuração está pronta.
+# Abra o '''Docker Desktop'''.
+# Vá em '''Settings''' (ícone da engrenagem) > '''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'''.
-=== Notas ===
+== 4. Diagnóstico e Solução de Problemas ==
-* '''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 ===
+Se a página da API (<code>http://localhost:8010</code>) não carregar ou houver erros no log, verifique a tabela abaixo:
-A Evolution API estará ativa na porta 8010.
-Será gerenciada pelo Docker Desktop e integrada ao Celta.
-== Configuração via WSL (Ubuntu) ==
+{{TabelaCampos|
-Esta seção descreve a instalação da Evolution API usando WSL e Ubuntu.
+  {{Linha
+   | tipo=check
+   | 1= Erro: "Docker não instalado"
+   | 2= Ocasionalmente o instalador automático pode ser bloqueado.
+* '''Solução:''' Baixe e instale o Docker Desktop manualmente pelo site oficial e 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.
+* '''Solução:''' Verifique se há outra instância da API rodando ou altere a porta no arquivo <code>.env</code> e reinicie o container.
+  }}
+  {{Linha
+   | tipo=danger
+   | 1= Erro: "Hyper-V / WSL error"
+   | 2= O Windows não conseguiu ativar o subsistema Linux.
+* '''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.
+  }}
+}}
-=== Passo a Passo ===
+</div>
-==== 1. Gerar Arquivos no Sistema Celta ====
-# 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 ====
-# Navegue até <code>C:\Celta Sistemas\WhatsApp</code> no Explorador de Arquivos.
-# Confirme a presença dos arquivos:
-## <code>Install.ps1</code> (script PowerShell) [https://www.dropbox.com/scl/fi/sgh1knqy1ive6b7mxd2gh/Install.ps1?rlkey=f0mowjuhhv4h03bnmd11mvw0t&st=6zyfh7ob&dl=0 Download]
-## <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 Celta)
-## <code>docker-compose.yaml</code> (gerado pelo Celta)
-# Se algum arquivo estiver ausente, repita o passo 1 ou contate a equipe técnica.
-==== 3. Executar o Script PowerShell ====
-# 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 ====
-# 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 ====
-# Verifique se a API está rodando:
-## Abra um navegador e acesse <code>http://localhost:8010</code>.
-## Se a página da Evolution API carregar, a configuração foi bem-sucedida.
-# Caso contrário, consulte as notas de erros abaixo.
-=== Notas ===
-* '''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.