WhatsApp: mudanças entre as edições

De Wiki Celta
Ir para navegação Ir para pesquisar
Sem resumo de edição
Etiqueta: Revertido
Sem resumo de edição
Etiqueta: Revertido
Linha 1: Linha 1:
== Tutorial de Configuração da Evolution API para WhatsApp no Celta via Docker Desktop ==
== Tutorial de Configuração da Evolution API para WhatsApp no Celta ==
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.
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 ===
=== Requisitos Comuns ===
'''Sistema Operacional''': Windows 10 ou superior (versões anteriores não são compatíveis com Docker Desktop).
'''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).
'''Virtualização''': Habilitada na BIOS/UEFI (veja como verificar abaixo).


'''Privilégios''': O Celta deve ser executado como administrador.
'''Privilégios''': O Celta e os scripts devem ser executados como administrador.


=== Passo a Passo ===
=== Verificar Requisitos do Sistema ===
==== 1. Verificar Requisitos do Sistema ====
'''Confirme a versão do Windows''':
'''Confirme a versão do Windows''':
Abra o menu Iniciar, digite <code>winver</code> e pressione Enter.
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.
Verifique se a versão é 10 ou superior (ex.: "Versão 22H2"). Caso contrário, atualize o sistema.
==== 2. Verificar Virtualização na BIOS ====
=== Verificar Virtualização na BIOS ===
'''Checar se está habilitada''':
'''Checar se está habilitada''':
Abra o Gerenciador de Tarefas (Ctrl + Shift + Esc).
Abra o Gerenciador de Tarefas (Ctrl + Shift + Esc).
Linha 23: Linha 22:
Habilite a opção e salve as alterações (F10 para salvar e sair na maioria dos casos).
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.
Reinicie o sistema e confirme no Gerenciador de Tarefas que a virtualização está ativa.
==== 3. Gerar Arquivos no Sistema Celta ====
== Configuração via WSL (Ubuntu) ==
Abra o Celta no computador que será o servidor com permissões de administrador.
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é:
Navegue até:
'''Principal > WhatsApp > Configurações > Gerar Arquivos'''.
'''Principal > WhatsApp > Configurações > Gerar Arquivos'''.
Linha 31: Linha 33:
<code>.env</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).
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 ====
==== 2. Verificar Arquivos Obrigatórios ====
Navegue até <code>C:\Celta Sistemas\WhatsApp</code> no Explorador de Arquivos.
Navegue até <code>C:\Celta Sistemas\WhatsApp</code> no Explorador de Arquivos.
Confirme a presença dos arquivos gerados:
Confirme a presença dos arquivos:
<code>.env</code> (configuração de ambiente com IP e portas).
<code>Install.ps1</code> (script PowerShell) [https://www.dropbox.com/scl/fi/sgh1knqy1ive6b7mxd2gh/Install.ps1?rlkey=f0mowjuhhv4h03bnmd11mvw0t&st=6zyfh7ob&dl=0 Download]
<code>docker-compose.yaml</code> (definição dos containers da Evolution API).
<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]
Os arquivos são gerados automaticamente pelo Celta. Se estiverem ausentes, repita o passo 3.
<code>.env</code> (gerado pelo Celta)
==== 5. Executar a Configuração no Celta ====
<code>docker-compose.yaml</code> (gerado pelo Celta)
No Celta, em '''Principal > WhatsApp > Configurações''', clique em "Inicializar API".
Se algum arquivo estiver ausente, repita o passo 1 ou contate a equipe técnica.
O Celta executará automaticamente os seguintes passos (acompanhe o log na interface):
==== 3. Executar o Script PowerShell ====
'''Criar diretório''': Garante que <code>C:\Celta Sistemas\WhatsApp</code> existe para armazenar os arquivos.
Clique com o botão direito no PowerShell, selecione '''Executar como administrador'''.
'''Gerar arquivos Docker''': Cria ou atualiza <code>.env</code> e <code>docker-compose.yaml</code> com o IP informado.
Habilite a execução de scripts no PowerShell com o comando: <code>Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted</code>
'''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".
Navegue até o diretório do script (<code>cd C:\Celta Sistemas\WhatsApp</code>).
'''Liberar porta 8010''': Abre a porta 8010 no firewall do Windows para a Evolution API.
Execute o script com:
'''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.
<code>.\Install.ps1</code>
'''Iniciar Docker''': Inicia o serviço do Docker Desktop, garantindo que ele esteja ativo.
O script irá:
'''Subir containers''': Executa <code>docker-compose up</code> no diretório <code>C:\Celta Sistemas\WhatsApp</code> para iniciar a Evolution API.
Habilitar Hyper-V e Plataforma da Máquina Virtual (pode exigir reinicialização).
O log mostrará o progresso. Se bem-sucedido, verá a mensagem:
Instalar o WSL e o Ubuntu-24.04.
"Ambiente Docker configurado com sucesso. Após a conclusão, clique em 'Testar API' para verificar o funcionamento."
Configurar o usuário "celta" no Ubuntu.
==== 6. Verificação Final ====
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 (<code>setup_docker_api.sh</code>) 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:
Verifique se a API está rodando:
No Celta, clique em "Testar API" ou abra um navegador e acesse <code>http://localhost:8010</code>.
Abra um navegador e acesse <code>http://localhost:8010</code>.
Se a página da Evolution API carregar, a configuração foi bem-sucedida.
Se a página da Evolution API carregar, a configuração foi bem-sucedida.
Caso contrário, consulte as notas de erros abaixo.
Caso contrário, consulte as notas de erros abaixo.
=== Notas ===
=== Notas ===
'''Erros Comuns''':
'''Erros Comuns''':
** '''"Falha ao criar diretório"''': Verifique permissões de administrador no Celta ou espaço em disco.
** '''"Arquivos .env ou docker-compose.yaml não encontrados"''': Certifique-se de gerar os arquivos no Celta (passo 1).
** '''"Habilite o Hyper-V"''': Ative manualmente em "Painel de Controle > Recursos do Windows" e reinicie.
** '''"Falha ao habilitar Hyper-V ou WSL"''': Confirme que a virtualização está ativa na BIOS e que o Windows está atualizado.
** '''"Docker não instalado"''': Instale o Docker Desktop após o download iniciado pelo Celta.
** '''"Serviço evolution-api.service não ativo"''': Verifique os logs (veja abaixo).
** '''"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''':
'''Onde Encontrar Logs''':
** No Celta: Veja o memo de log na tela de Configurações.
** PowerShell: <code>%TEMP%\wsl_docker_setup_DDMMYYYY_HHMMSS.log</code> (ex.: <code>C:\Users\SeuUsuario\AppData\Local\Temp</code>).
** Docker Desktop: Abra o Docker Desktop e cheque a aba "Containers" para erros nos logs da Evolution API.
** 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 Docker''':
'''Ativar Debug no WSL''':


No Docker Desktop, vá em "Settings > Resources > Advanced" e aumente os recursos de log, se necessário.
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).
Reinicie o Docker e verifique os logs detalhados nos containers.
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 ===
=== 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.
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.
 
== 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 ===
=== Passo a Passo ===
 
==== 1. Gerar Arquivos no Sistema Celta ====
==== 1. Verificar Requisitos do Sistema ====
Abra o Celta com permissões de administrador.
# '''Confirme a versão do Windows''':
Navegue até:
## Abra o menu Iniciar, digite <code>winver</code> e pressione Enter.
'''Principal > WhatsApp > Configurações > Gerar Arquivos'''.
## Verifique se a versão é 10 ou superior (ex.: "Versão 22H2"). Caso contrário, atualize o sistema.
Clique em "Gerar Arquivos" para criar:
 
<code>docker-compose.yaml</code>
==== 2. Verificar Virtualização na BIOS ====
<code>.env</code>
# '''Checar se está habilitada''':
Os arquivos serão salvos em <code>C:\Celta Sistemas\WhatsApp</code> com o IP fixo da máquina (confirme com <code>ipconfig</code>).
## Abra o Gerenciador de Tarefas (Ctrl + Shift + Esc).
==== 2. Executar a Configuração no Celta ====
## Vá para a aba "Desempenho" e procure por "Virtualização" na seção da CPU.
Na mesma tela, clique em "Inicializar API".
## Se estiver "Habilitado", prossiga. Se "Desabilitado", siga os passos abaixo.
O Celta configura tudo automaticamente e exibe o progresso no log:
# '''Habilitar virtualização na BIOS''':
Cria o diretório <code>C:\Celta Sistemas\WhatsApp</code>.
## Reinicie o computador e entre na BIOS/UEFI (teclas comuns: F2, Del, F10 - consulte o manual da placa-mãe).
Gera os arquivos Docker com o IP informado.
## Procure por opções como "Intel VT-x", "AMD-V" ou "Virtualization Technology" (geralmente em "Advanced" ou "CPU Configuration").
Verifica o Hyper-V e orienta a ativação, se necessário.
## Habilite a opção e salve as alterações (F10 para salvar e sair na maioria dos casos).
Libera a porta 8010 no firewall.
## Reinicie o sistema e confirme no Gerenciador de Tarefas que a virtualização está ativa.
Instala o Docker Desktop (inicia o download se ausente).
 
Inicia o Docker e sobe os containers da Evolution API.
==== 3. Gerar Arquivos no Sistema Celta ====
Se concluído, o log mostra: "Ambiente Docker configurado com sucesso".
# Abra o Celta no computador que será o servidor.
==== 3. Verificação Final ====
# Navegue até:
Clique em "Testar API" no Celta ou acesse <code>http://localhost:8010</code> no navegador.
## '''Principal > WhatsApp > Configurações > Gerar Arquivos'''.
Se a página da Evolution API carregar, a configuração está pronta.
# 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:
## <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 ====
# 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 ====
# Após o script PowerShell instalar o WSL e Ubuntu, o script Bash (<code>setup_docker_api.sh</code>) 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.
 
==== 7. Verificação Final ====
# 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 ===
=== Notas ===
* '''Erros Comuns''':
'''Erros Comuns''':
** '''"Arquivos .env ou docker-compose.yaml não encontrados"''': Certifique-se de gerar os arquivos no Celta (passo 3).
** '''"Docker não instalado"''': Instale manualmente após o download iniciado pelo Celta.
** '''"Falha ao habilitar Hyper-V ou WSL"''': Confirme que a virtualização está ativa na BIOS e que o Windows está atualizado.
** '''"Porta 8010 ocupada"''': Feche outros aplicativos ou libere a porta.
** '''"Serviço evolution-api.service não ativo"''': Verifique os logs (veja abaixo).
** '''"Hyper-V desabilitado"''': Ative em "Recursos do Windows".
* '''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 ===
'''Logs''':
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.
** Veja o memo no Celta ou os containers no Docker Desktop.

Edição das 20h23min de 11 de abril de 2025

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”