WhatsApp

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

Este tutorial orienta o suporte técnico e representantes na instalação e configuração do ambiente WSL, Docker e Evolution API no Windows para integração com o ERP. 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.
• Arquivos Necessários: Os seguintes arquivos devem estar presentes em C:\Celta Sistemas\WhatsApp:
  • setup_wsl_docker.ps1 (script Bash)
  • setup_docker_api.sh (script Bash)
  • .env (arquivo de configuração)
  • docker-compose.yaml (arquivo de composição do Docker)

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. Execute como administrador:
   1. Clique com o botão direito no PowerShell, selecione "Executar como administrador" e abra o script fornecido.

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. Verificar Arquivos Obrigatórios

1. Navegue até C:\Celta Sistemas\WhatsApp no Explorador de Arquivos.
2. Confirme a presença dos arquivos:
   1. setup_docker_api.sh
   2. .env
   3. docker-compose.yaml
3. Se algum arquivo estiver ausente, solicite ao responsável pelo ERP ou equipe técnica antes de prosseguir.

4. Executar o Script PowerShell

1. Abra o PowerShell como administrador.
2. Navegue até o diretório do script (ex.: cd C:\Celta Sistemas\WhatsApp).
3. Execute o script com:
   1. .\nome_do_script.ps1
4. 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.

5. 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.

6. 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 que os arquivos estão em 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.
  • "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 systemctl status evolution-api.service.
• Ativar Debug no WSL:

1. 1. No WSL (Ubuntu-24.04), edite o arquivo .env em /mnt/c/Celta Sistemas/WhatsApp com sudo nano .env.
   2. Adicione ou altere para DEBUG=true e salve (Ctrl + O, Enter, Ctrl + X).
   3. Reinicie o serviço com sudo systemctl restart evolution-api.service.
   4. Envie os logs detalhados (/var/log/evolution-api.log) para a equipe técnica.

• Suporte Adicional:
  • Contate a equipe técnica da Celta Sistemas em caso de dúvidas ou falhas persistentes.

Resultado Esperado

Após seguir os passos, a Evolution API estará rodando na porta 8010 e integrada ao ERP para uso do WhatsApp. O serviço iniciará automaticamente ao ligar o computador.