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: Reversão manual
Linha 1: Linha 1:
== Tutorial de Configuração da Evolution API para WhatsApp no Celta ==
== 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.
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 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).
=== 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.


'''Privilégios''': O Celta e os scripts devem ser executados como administrador.
=== Passo a Passo ===
 
==== 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.
# 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:
## <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.


=== 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.
=== 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:
<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).
==== 2. 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 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: <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.
==== 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:
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 1).
** '''"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.
** '''"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).
** '''"Serviço evolution-api.service não ativo"''': Verifique os logs (veja abaixo).
 
* '''Onde Encontrar Logs''':
'''Onde Encontrar Logs''':
** PowerShell: <code>%TEMP%\wsl_docker_setup_DDMMYYYY_HHMMSS.log</code> (ex.: <code>C:\Users\SeuUsuario\AppData\Local\Temp</code>).
** 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>.
** 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>.
** 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>).


'''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 ===
=== 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.
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:
<code>docker-compose.yaml</code>
<code>.env</code>
Os arquivos serão salvos em <code>C:\Celta Sistemas\WhatsApp</code> com o IP fixo da máquina (confirme com <code>ipconfig</code>).
==== 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 <code>C:\Celta Sistemas\WhatsApp</code>.
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 <code>http://localhost:8010</code> 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.

Edição das 20h24min 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 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=676”