|
|
| (15 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) |
| Linha 1: |
Linha 1: |
| == Tutorial de Configuração da Evolution API para WhatsApp no Celta via Docker Desktop ==
| | {{Cabecalho |
| 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.
| | | [[Documentação]] |
| === Requisitos ===
| | | Configuração do WhatsApp (Evolution API) |
| '''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). | | Este guia orienta a instalação e configuração da '''Evolution API''' utilizando a integração nativa com o '''Docker Desktop'''. |
|
| |
|
| '''Privilégios''': O Celta deve ser executado como administrador.
| | O Sistema Celta automatiza 90% do processo, baixando a imagem oficial, criando os arquivos de configuração (`docker-compose.yaml`) e gerenciando o serviço. |
|
| |
|
| === Passo a Passo ===
| | == 1. Pré-requisitos do Ambiente == |
| ==== 1. Verificar Requisitos do Sistema ====
| |
| '''Confirme a versão do Windows''':
| |
| Abra o menu Iniciar, digite <code>winver</code> 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:
| |
| <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).
| |
| ==== 4. Verificar Arquivos Obrigatórios ====
| |
| Navegue até <code>C:\Celta Sistemas\WhatsApp</code> no Explorador de Arquivos.
| |
| Confirme a presença dos arquivos gerados:
| |
| <code>.env</code> (configuração de ambiente com IP e portas).
| |
| <code>docker-compose.yaml</code> (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 <code>C:\Celta Sistemas\WhatsApp</code> existe para armazenar os arquivos.
| |
| '''Gerar arquivos Docker''': Cria ou atualiza <code>.env</code> e <code>docker-compose.yaml</code> 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 <code>docker-compose up</code> no diretório <code>C:\Celta Sistemas\WhatsApp</code> 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 <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''':
| |
| ** '''"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 <code>.env</code> e <code>docker-compose.yaml</code> estão corretos.
| |
|
| |
|
| '''Onde Encontrar Logs''':
| | Antes de iniciar, garanta que o servidor atenda aos requisitos mínimos para virtualização. |
| ** 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''': | | {{Nota|warning|REQUISITO DE BIOS / UEFI|Para o funcionamento do Docker, a '''Virtualização''' deve estar habilitada na BIOS do computador. |
| | * '''Verificação:''' Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) > Aba Desempenho > CPU. |
| | * Procure por "Virtualização: '''Habilitado'''". |
| | * Se estiver "Desabilitado", é necessário reiniciar o PC e ativar na BIOS (Intel VT-x ou AMD-V).}} |
|
| |
|
| No Docker Desktop, vá em "Settings > Resources > Advanced" e aumente os recursos de log, se necessário.
| | === Requisitos de Hardware/Software === |
| Reinicie o Docker e verifique os logs detalhados nos containers.
| | * '''Sistema Operacional:''' Windows 10 (21H2+) ou Windows 11. |
| === Resultado Esperado === | | * '''Memória RAM:''' Mínimo 8GB (Recomendado 16GB). |
| 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.
| | * '''WSL 2:''' O Docker Desktop utiliza o subsistema Linux do Windows. O instalador do Docker geralmente ativa isso automaticamente. |
|
| |
|
| | == 2. Instalação Automática == |
|
| |
|
| | O Celta possui um "Wizard" que configura o ambiente sem necessidade de comandos manuais. |
|
| |
|
| == Tutorial de Configuração da Evolution API para WhatsApp no Celta ==
| | # Execute o Celta como '''Administrador'''. |
| 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.
| | # Acesse '''Principal > WhatsApp > Configurações'''. |
| | # Na aba '''Configuração''': |
| | #* '''Host:''' Informe o IP fixo ou Nome do Computador Servidor (Ex: `192.168.1.200`). |
| | #* '''Modo:''' Selecione a opção '''Usar Docker Desktop'''. |
| | # Clique em '''Iniciar Instalação'''. |
|
| |
|
| === Requisitos ===
| | {{Nota|info|BASTIDORES (O que o Celta faz?)| |
| * '''Sistema Operacional''': Windows 10 ou superior (versões anteriores não são compatíveis com WSL 2).
| | Ao clicar em instalar, o sistema executa em segundo plano: |
| * '''Virtualização''': Habilitada na BIOS/UEFI (veja como verificar abaixo).
| | # Cria a pasta `C:\Celta Sistemas\WhatsApp`. |
| * '''Privilégios''': Script deve ser executado como administrador.
| | # Gera o arquivo `docker-compose.yaml` configurado com o Host informado. |
| | # Verifica se o Docker Desktop está instalado (inicia o download se não estiver). |
| | # Sobe o container da Evolution API na porta '''8010'''. |
| | }} |
|
| |
|
| === Passo a Passo === | | === Validação === |
| | Aguarde o log na tela exibir: *"Ambiente Docker configurado com sucesso"*. |
| | Após isso, o status mudará para '''Aguardando escaneamento''' (QR Code). |
|
| |
|
| ==== 1. Verificar Requisitos do Sistema ==== | | == 3. Configuração de Inicialização == |
| # '''Confirme a versão do Windows''':
| |
| ## Abra o menu Iniciar, digite <code>winver</code> 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 ====
| | Para garantir que a API suba automaticamente após uma queda de energia ou reinicialização do servidor: |
| # '''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 '''Docker Desktop'''. |
| # Abra o Celta no computador que será o servidor. | | # Clique no ícone de engrenagem ('''Settings''') > '''General'''. |
| # Navegue até: | | # Marque a opção: <i class="bi bi-check-square-fill" style="color:#0d6efd;"></i> '''Start Docker Desktop when you sign in'''. |
| ## '''Principal > WhatsApp > Configurações > Gerar Arquivos'''.
| |
| # Clique em "Gerar Arquivos" para criar: | |
| ## <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).
| |
|
| |
|
| ==== 4. Verificar Arquivos Obrigatórios ====
| | == 4. Gerenciamento de Sessões == |
| # 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 3 ou contate a equipe técnica.
| |
|
| |
|
| ==== 5. Executar o Script PowerShell ====
| | O Celta permite gerenciar múltiplas conexões (multitenancy) na aba '''Gerenciar'''. |
| # 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.
| |
|
| |
|
| ==== 6. Executar o Script Bash no WSL ==== | | {{TabelaCampos| |
| # Após o script PowerShell instalar o WSL e Ubuntu, o script Bash (<code>setup_docker_api.sh</code>) será executado automaticamente.
| | {{Linha |
| # Ele irá:
| | | 1= Listar Instâncias |
| ## Atualizar pacotes no Ubuntu.
| | | 2= Clique em "Listar" para ver todas as sessões ativas no Docker. |
| ## Instalar o Docker e Docker Compose.
| | * Mostra: Nome, Número, Status e Data de Criação. |
| ## Configurar o serviço da Evolution API para iniciar automaticamente.
| | }} |
| | {{Linha |
| | | 1= Desconectar / Excluir |
| | | 2= Clique com o botão direito sobre uma instância na lista para: |
| | * '''Desconectar:''' Encerra a sessão do WhatsApp Web. |
| | * '''Deletar:''' Remove completamente a instância da API (útil para limpar cache ou erros de conexão). |
| | }} |
| | }} |
|
| |
|
| ==== 7. Verificação Final ==== | | == 5. Diagnóstico e Solução de Problemas == |
| # 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 ===
| | Se houver erros no Log ou o QR Code não aparecer, consulte a tabela abaixo. |
| * '''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: <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 === | | {{TabelaCampos| |
| 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.
| | {{Linha |
| | | 1= Erro: "Docker não instalado" |
| | | 2= O download automático falhou ou foi bloqueado. |
| | * '''Solução:''' Baixe e instale o [https://www.docker.com/products/docker-desktop/ Docker Desktop] manualmente e depois clique em "Iniciar Instalação" no Celta novamente. |
| | }} |
| | {{Linha |
| | | 1= Erro: "Porta 8010 ocupada" |
| | | 2= Outro serviço está usando a porta da API. |
| | * '''Solução:''' Verifique conflitos ou altere a porta no arquivo `.env` dentro da pasta do WhatsApp e reinicie o container. |
| | }} |
| | {{Linha |
| | | 1= Erro: "WSL error / Hyper-V" |
| | | 2= O Windows não conseguiu iniciar o motor de virtualização. |
| | * '''Solução:''' Confirme se a Virtualização está ativa na BIOS e se o recurso "Plataforma de Máquina Virtual" está marcado nos Recursos do Windows. |
| | }} |
| | }} |
| | |
| | {{ContatoSuporte}} |
