WhatsApp

De Wiki Celta
Revisão de 20h23min de 11 de abril de 2025 por Raul (discussão | contribs)
Ir para navegação Ir para pesquisar

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

Este tutorial orienta a instalação e configuração da Evolution API no Windows para integração com o Celta, oferecendo duas opções: via WSL (Ubuntu) ou Docker Desktop. O objetivo é automatizar a instalação e garantir que a API do WhatsApp esteja funcional.

Requisitos Comuns

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

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.

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.

Configuração via WSL (Ubuntu)

Esta seção descreve a instalação da Evolution API usando WSL e Ubuntu.

Passo a Passo

1. Gerar Arquivos no Sistema Celta

Abra o Celta no computador que será o servidor. 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).

2. Verificar Arquivos Obrigatórios

Navegue até C:\Celta Sistemas\WhatsApp no Explorador de Arquivos. Confirme a presença dos arquivos: Install.ps1 (script PowerShell) Download setup_docker_api.sh (script Bash) Download .env (gerado pelo Celta) docker-compose.yaml (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: Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted Navegue até o diretório do script (cd C:\Celta Sistemas\WhatsApp). Execute o script com: .\Install.ps1 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 (setup_docker_api.sh) 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 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:

    • "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: %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:

No Windows, crie ou edite o arquivo .wslconfig em C:\Users\SeuUsuario.wslconfig (substitua "SeuUsuario" pelo nome do seu usuário). Adicione as linhas: debugConsole=true Salve o arquivo e reinicie o WSL com wsl --shutdown 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 /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.

Configuração via Docker Desktop

Esta seção descreve a instalação simplificada da Evolution API usando o Docker Desktop, totalmente gerenciada pelo Celta.

Passo a Passo

1. Gerar Arquivos no Sistema Celta

Abra o Celta com permissões de administrador. Navegue até: Principal > WhatsApp > Configurações > Gerar Arquivos. Clique em "Gerar Arquivos" para criar: docker-compose.yaml .env Os arquivos serão salvos em C:\Celta Sistemas\WhatsApp com o IP fixo da máquina (confirme com ipconfig).

2. Executar a Configuração no Celta

Na mesma tela, clique em "Inicializar API". O Celta configura tudo automaticamente e exibe o progresso no log: Cria o diretório C:\Celta Sistemas\WhatsApp. Gera os arquivos 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 mostra: "Ambiente Docker configurado com sucesso".

3. Verificação Final

Clique em "Testar API" no Celta ou acesse http://localhost:8010 no navegador. Se a página da Evolution API carregar, a configuração está pronta.

Notas

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.
Disponível em “https://wiki.celtasistemas.com.br/index.php?title=WhatsApp&oldid=675”