Ativa a pesquisa
Ativa o menu
134
292
9
2,7 mil
Celta Sistemas Wiki
Alternar menu de preferências
Alternar menu pessoal
Não autenticado(a)
Your IP address will be publicly visible if you make any edits.

WhatsApp

De Celta Sistemas Wiki
Mais ações
Revisão de 20h19min de 11 de abril de 2025 por Raul (discussão | contribs)

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

Disponível em “https://wiki.celtasistemas.com.br/index.php?title=WhatsApp&oldid=674”
Última modificação
Esta página foi modificada pela última vez em 11 de abril de 2025, às 20h19min.