WhatsApp

Tutorial de Configuração da Evolution API para WhatsApp no Celta via Docker Desktop

Este tutorial orienta a instalação e configuração do ambiente Docker Desktop 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.

Requisitos

Sistema Operacional: Windows 10 ou superior (versões anteriores não são compatíveis com Docker Desktop).

Virtualização: Habilitada na BIOS/UEFI (veja como verificar abaixo).

Privilégios: O Celta deve ser executado como administrador.

Passo a Passo

1. Verificar Requisitos do Sistema

Confirme a versão do Windows: Abra o menu Iniciar, digite winver 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

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

Abra o Celta no computador que será o servidor com permissões de administrador. Navegue até: Principal > WhatsApp > Configurações > Gerar Arquivos. Clique em "Gerar Arquivos" para criar: docker-compose.yaml .env Esses arquivos serão salvos em C:\Celta Sistemas\WhatsApp com o IP fixo da máquina atual. Confirme que o IP no arquivo .env corresponde ao IP fixo do computador servidor (use ipconfig no Prompt de Comando para verificar).

4. Verificar Arquivos Obrigatórios

Navegue até C:\Celta Sistemas\WhatsApp no Explorador de Arquivos. Confirme a presença dos arquivos gerados: .env (configuração de ambiente com IP e portas). docker-compose.yaml (definição dos containers da Evolution API). Os arquivos são gerados automaticamente pelo Celta. Se estiverem ausentes, repita o passo 3.

5. Executar a Configuração no Celta

No Celta, em Principal > WhatsApp > Configurações, clique em "Inicializar API". O Celta executará automaticamente os seguintes passos (acompanhe o log na interface): Criar diretório: Garante que C:\Celta Sistemas\WhatsApp existe para armazenar os arquivos. Gerar arquivos Docker: Cria ou atualiza .env e docker-compose.yaml com o IP informado. Verificar Hyper-V: Confirma se o Hyper-V está habilitado (necessário para o Docker Desktop). Se não estiver, exibe instruções para ativar em "Recursos do Windows". Liberar porta 8010: Abre a porta 8010 no firewall do Windows para a Evolution API. Verificar Docker Desktop: Checa se o Docker Desktop está instalado. Se não estiver, inicia o download do instalador oficial e solicita instalação manual. Iniciar Docker: Inicia o serviço do Docker Desktop, garantindo que ele esteja ativo. Subir containers: Executa docker-compose up no diretório C:\Celta Sistemas\WhatsApp para iniciar a Evolution API. O log mostrará o progresso. Se bem-sucedido, verá a mensagem: "Ambiente Docker configurado com sucesso. Após a conclusão, clique em 'Testar API' para verificar o funcionamento."

6. Verificação Final

Verifique se a API está rodando: No Celta, clique em "Testar API" ou abra um navegador e acesse http://localhost:8010. 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:

• • "Falha ao criar diretório": Verifique permissões de administrador no Celta ou espaço em disco.
  • "Habilite o Hyper-V": Ative manualmente em "Painel de Controle > Recursos do Windows" e reinicie.
  • "Docker não instalado": Instale o Docker Desktop após o download iniciado pelo Celta.
  • "Falha ao liberar porta 8010": Feche outros aplicativos usando a porta ou ajuste manualmente no firewall.
  • "Erro ao subir containers": Confirme que os arquivos .env e docker-compose.yaml estão corretos.

Onde Encontrar Logs:

• • No Celta: Veja o memo de log na tela de Configurações.
  • Docker Desktop: Abra o Docker Desktop e cheque a aba "Containers" para erros nos logs da Evolution API.

Ativar Debug no Docker:

No Docker Desktop, vá em "Settings > Resources > Advanced" e aumente os recursos de log, se necessário. Reinicie o Docker e verifique os logs detalhados nos containers.

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 será gerenciado pelo Docker Desktop e iniciará automaticamente ao ligar o computador, desde que o Docker esteja configurado para iniciar com o Windows.

Tutorial de Configuração da Evolution API para WhatsApp no Celta

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.

Requisitos

• 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

1. Verificar Requisitos do Sistema

1. Confirme a versão do Windows:
   1. Abra o menu Iniciar, digite winver e pressione Enter.
   2. Verifique se a versão é 10 ou superior (ex.: "Versão 22H2"). Caso contrário, atualize o sistema.

2. Verificar Virtualização na BIOS

1. Checar se está habilitada:
   1. Abra o Gerenciador de Tarefas (Ctrl + Shift + Esc).
   2. Vá para a aba "Desempenho" e procure por "Virtualização" na seção da CPU.
   3. Se estiver "Habilitado", prossiga. Se "Desabilitado", siga os passos abaixo.
2. Habilitar virtualização na BIOS:
   1. Reinicie o computador e entre na BIOS/UEFI (teclas comuns: F2, Del, F10 - consulte o manual da placa-mãe).
   2. Procure por opções como "Intel VT-x", "AMD-V" ou "Virtualization Technology" (geralmente em "Advanced" ou "CPU Configuration").
   3. Habilite a opção e salve as alterações (F10 para salvar e sair na maioria dos casos).
   4. Reinicie o sistema e confirme no Gerenciador de Tarefas que a virtualização está ativa.

3. Gerar Arquivos no Sistema Celta

1. Abra o Celta no computador que será o servidor.
2. Navegue até:
   1. Principal > WhatsApp > Configurações > Gerar Arquivos.
3. Clique em "Gerar Arquivos" para criar:
   1. docker-compose.yaml
   2. .env
4. Esses arquivos serão salvos em C:\Celta Sistemas\WhatsApp com o IP fixo da máquina atual. Confirme que o IP no arquivo .env corresponde ao IP fixo do computador servidor (use ipconfig no Prompt de Comando para verificar).

4. Verificar Arquivos Obrigatórios

1. Navegue até C:\Celta Sistemas\WhatsApp no Explorador de Arquivos.
2. Confirme a presença dos arquivos:
   1. Install.ps1 (script PowerShell) Download
   2. setup_docker_api.sh (script Bash) Download
   3. .env (gerado pelo Celta)
   4. docker-compose.yaml (gerado pelo Celta)
3. Se algum arquivo estiver ausente, repita o passo 3 ou contate a equipe técnica.

5. Executar o Script PowerShell

1. Clique com o botão direito no PowerShell, selecione Executar como administrador
2. Habilite a execução de scripts no PowerShell com o comando: Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
3. Navegue até o diretório do script (cd C:\Celta Sistemas\WhatsApp).
4. Execute o script com:
   1. .\Install.ps1
5. O script irá:
   1. Habilitar Hyper-V e Plataforma da Máquina Virtual (pode exigir reinicialização).
   2. Instalar o WSL e o Ubuntu-24.04.
   3. Configurar o usuário "celta" no Ubuntu.
   4. Instalar e configurar o Docker e a Evolution API.
   5. Criar regras de firewall e tarefas agendadas.

6. Executar o Script Bash no WSL

1. Após o script PowerShell instalar o WSL e Ubuntu, o script Bash (setup_docker_api.sh) será executado automaticamente.
2. Ele irá:
   1. Atualizar pacotes no Ubuntu.
   2. Instalar o Docker e Docker Compose.
   3. Configurar o serviço da Evolution API para iniciar automaticamente.

7. Verificação Final

1. Verifique se a API está rodando:
   1. Abra um navegador e acesse http://localhost:8010.
   2. Se a página da Evolution API carregar, a configuração foi bem-sucedida.
2. 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 3).
  • "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: %TEMP%\wsl_docker_setup_DDMMYYYY_HHMMSS.log (ex.: C:\Users\SeuUsuario\AppData\Local\Temp).
  • Evolution API: No WSL, execute cat /var/log/evolution-api.log.
  • Status do serviço: No WSL, execute sudo systemctl status evolution-api.service.
• Ativar Debug no WSL:

1. 1. No Windows, crie ou edite o arquivo .wslconfig em C:\Users\SeuUsuario\.wslconfig (substitua "SeuUsuario" pelo nome do seu usuário).
   2. Adicione as linhas:
   3. debugConsole=true
   4. Salve o arquivo e reinicie o WSL com wsl --shutdown no PowerShell ou Prompt de Comando.
   5. 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 /var/log/evolution-api.log (acessível via WSL com cat /var/log/evolution-api.log).

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.