WhatsApp: mudanças entre as edições

De Wiki Celta
Ir para navegação Ir para pesquisar
Sem resumo de edição
Sem resumo de edição
 
(21 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 ==
== Tutorial de Configuração do WhatsApp no 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 Celta. O objetivo é automatizar a instalação e garantir que a API do WhatsApp esteja funcional.
Este tutorial ensina como instalar e configurar a Evolution API no Windows para integrar com o Celta.


=== Requisitos ===
Oferecemos duas opções para isso: 
* '''Sistema Operacional''': Windows 10 ou superior (versões anteriores não são compatíveis com WSL 2).
* Via Docker Desktop, mais simples e gerenciada pelo Celta.
* '''Virtualização''': Habilitada na BIOS/UEFI (veja como verificar abaixo).
* Via WSL (Ubuntu), para quem prefere um ambiente Linux.
* '''Privilégios''': Script deve ser executado como administrador.


=== Passo a Passo ===
O objetivo é automatizar a instalação. 
Queremos garantir que a API do WhatsApp funcione perfeitamente.


==== 1. Verificar Requisitos do Sistema ====
=== Requisitos Comuns ===
# '''Confirme a versão do Windows''':
* '''Sistema Operacional''': Windows 10 ou superior (versões anteriores não são compatíveis com WSL 2 ou Docker Desktop).
## Abra o menu Iniciar, digite <code>winver</code> e pressione Enter.
* '''Virtualização''': Habilitada na BIOS/UEFI (veja como verificar abaixo).
## Verifique se a versão é 10 ou superior (ex.: "Versão 22H2"). Caso contrário, atualize o sistema.
* '''Privilégios''': O Celta e os scripts devem ser executados como administrador.
# '''Execute como administrador''':
## Clique com o botão direito no PowerShell, selecione "Executar como administrador" e abra o script fornecido.


==== 2. Verificar Virtualização na BIOS ====
=== Verificar Requisitos do Sistema ===
# '''Checar se está habilitada''':
# '''Confirme a versão do Windows''': 
## Abra o Gerenciador de Tarefas (Ctrl + Shift + Esc).
## Abra o menu Iniciar, digite <code>winver</code> e pressione Enter.
## Vá para a aba "Desempenho" e procure por "Virtualização" na seção da CPU.
## Verifique se a versão é 10 ou superior (ex.: "Versão 22H2"). 
## Se estiver "Habilitado", prossiga. Se "Desabilitado", siga os passos abaixo.
## Caso contrário, atualize o sistema.
# '''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).
=== Verificar Virtualização na BIOS ===
## Procure por opções como "Intel VT-x", "AMD-V" ou "Virtualization Technology" (geralmente em "Advanced" ou "CPU Configuration").
# '''Checar se está habilitada''':
## Habilite a opção e salve as alterações (F10 para salvar e sair na maioria dos casos).
## 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.
## Reinicie o sistema e confirme no Gerenciador de Tarefas que a virtualização está ativa.


==== 3. Gerar Arquivos no Sistema Celta ====
== Configuração via Docker Desktop == 
# Abra o ERP Celta no computador que será o servidor.
Esta seção descreve a instalação simplificada da Evolution API usando o Docker Desktop. 
# Navegue até:
Tudo é gerenciado diretamente pelo Celta.
## '''Principal > WhatsApp > Configurações > Gerar Arquivos'''.
 
# Clique em "Gerar Arquivos" para criar:
=== Passo a Passo === 
## <code>docker-compose.yaml</code>
 
## <code>.env</code>
==== 1. Iniciar configuração ==== 
# 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).
# Abra o Celta com permissões de administrador. 
# Navegue até: 
## '''Principal > WhatsApp > Configurações 
# Informe o host (ip ou nome do computador)   
# Confirme o IP com <code>ipconfig</code> no Prompt de Comando.
 
==== 2. Executar a Configuração no Celta ==== 
# Na mesma tela, selecione o modo "Usar Docker Desktop" e clique em "Iniciar Instalação". 
# O Celta faz tudo automaticamente e mostra o progresso no log: 
## Cria o diretório <code>C:\Celta Sistemas\WhatsApp</code>. 
## Gera os arquivos necessários para o 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 exibe: 
## "Ambiente Docker configurado com sucesso".
 
==== 3. Habilitar Docker Desktop para iniciar automaticamente ==== 
# Acesse o Docker Desktop e navegue até: 
## '''Settings > General > Habilite: Start Docker Desktop when you sign in to your computer.
 
==== 4. Verificação Final ==== 
# Clique em "Atualizar" no Celta ou acesse <code>http://ENDEREÇO_HOST: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.
 
=== Resultado Esperado === 
A Evolution API estará ativa na porta 8010. 
Será gerenciada pelo Docker Desktop e integrada ao Celta.
 
== 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
# Selecione o modo "Usar WSL Ubuntu" e clique em "Iniciar Instalação".   
## <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 ====
==== 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:
# Confirme a presença dos arquivos:
## <code>setup_docker_api.sh</code> (script Bash)
## <code>Install.ps1</code> (script PowerShell) [https://www.dropbox.com/scl/fi/sgh1knqy1ive6b7mxd2gh/Install.ps1?rlkey=f0mowjuhhv4h03bnmd11mvw0t&st=6zyfh7ob&dl=0 Download] 
## <code>.env</code> (gerado pelo ERP)
## <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>docker-compose.yaml</code> (gerado pelo ERP)
## <code>.env</code> (gerado pelo Celta)
# Se algum arquivo estiver ausente, repita o passo 3 ou contate a equipe técnica.
## <code>docker-compose.yaml</code> (gerado pelo Celta)
# Se algum arquivo estiver ausente, repita o passo 1 ou contate a equipe técnica.


==== 5. Executar o Script PowerShell ====
==== 3. Executar o Script PowerShell ====
# Abra o PowerShell como administrador.
# Clique com o botão direito no PowerShell, selecione '''Executar como administrador'''.
# Navegue até o diretório do script (ex.: <code>cd C:\Celta Sistemas\WhatsApp</code>).
# Habilite a execução de scripts no PowerShell com o comando: 
# Execute o script com:
## <code>Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted</code> 
## <code>.\nome_do_script.ps1</code>
# Navegue até o diretório do script (<code>cd C:\Celta Sistemas\WhatsApp</code>).
# O script irá:
# Execute o script com:
## Habilitar Hyper-V e Plataforma da Máquina Virtual (pode exigir reinicialização).
## <code>.\Install.ps1</code>
## Instalar o WSL e o Ubuntu-24.04.
# O script irá:
## Configurar o usuário "celta" no Ubuntu.
## Habilitar Hyper-V e Plataforma da Máquina Virtual (pode exigir reinicialização).
## Instalar e configurar o Docker e a Evolution API.
## 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.
## Criar regras de firewall e tarefas agendadas.


==== 6. Executar o Script Bash no WSL ====
==== 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.
# Após o script PowerShell instalar o WSL e Ubuntu, o script Bash (<code>setup_docker_api.sh</code>) será executado automaticamente.
# Ele irá:
# Ele irá:
## Atualizar pacotes no Ubuntu.
## Atualizar pacotes no Ubuntu.
## Instalar o Docker e Docker Compose.
## Instalar o Docker e Docker Compose.
## Configurar o serviço da Evolution API para iniciar automaticamente.
## Configurar o serviço da Evolution API para iniciar automaticamente.


==== 7. Verificação Final ====
==== 5. Verificação Final ====
# Verifique se a API está rodando:
# Verifique se a API está rodando:
## 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''':
** '''"Arquivos .env ou docker-compose.yaml não encontrados"''': Certifique-se de gerar os arquivos no ERP Celta (passo 3).
** '''"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.
** '''"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>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''':
* '''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).
## 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:
## Adicione as linhas:
## <pre>debugConsole=true</pre>
## <code>debugConsole=true</code>
## Salve o arquivo e reinicie o WSL com <code>wsl --shutdown</code> no PowerShell ou Prompt de Comando.
## 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>).
## 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 ERP 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.

Edição atual tal como às 20h57min de 11 de abril de 2025

Tutorial de Configuração do WhatsApp no Celta

Este tutorial ensina como instalar e configurar a Evolution API no Windows para integrar com o Celta.

Oferecemos duas opções para isso:

  • Via Docker Desktop, mais simples e gerenciada pelo Celta.
  • Via WSL (Ubuntu), para quem prefere um ambiente Linux.

O objetivo é automatizar a instalação. Queremos garantir que a API do WhatsApp funcione perfeitamente.

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

  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").
    3. Caso contrário, atualize o sistema.

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

Configuração via Docker Desktop

Esta seção descreve a instalação simplificada da Evolution API usando o Docker Desktop. Tudo é gerenciado diretamente pelo Celta.

Passo a Passo

1. Iniciar configuração

  1. Abra o Celta com permissões de administrador.
  2. Navegue até:
    1. Principal > WhatsApp > Configurações
  3. Informe o host (ip ou nome do computador)
  4. Confirme o IP com ipconfig no Prompt de Comando.

2. Executar a Configuração no Celta

  1. Na mesma tela, selecione o modo "Usar Docker Desktop" e clique em "Iniciar Instalação".
  2. O Celta faz tudo automaticamente e mostra o progresso no log:
    1. Cria o diretório C:\Celta Sistemas\WhatsApp.
    2. Gera os arquivos necessários para o Docker com o IP informado.
    3. Verifica o Hyper-V e orienta a ativação, se necessário.
    4. Libera a porta 8010 no firewall.
    5. Instala o Docker Desktop (inicia o download se ausente).
    6. Inicia o Docker e sobe os containers da Evolution API.
  3. Se concluído, o log exibe:
    1. "Ambiente Docker configurado com sucesso".

3. Habilitar Docker Desktop para iniciar automaticamente

  1. Acesse o Docker Desktop e navegue até:
    1. Settings > General > Habilite: Start Docker Desktop when you sign in to your computer.

4. Verificação Final

  1. Clique em "Atualizar" no Celta ou acesse http://ENDEREÇO_HOST:8010 no navegador.
  2. 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.

Resultado Esperado

A Evolution API estará ativa na porta 8010. Será gerenciada pelo Docker Desktop e integrada ao Celta.

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

  1. Abra o Celta no computador que será o servidor.
  2. Navegue até:
    1. Principal > WhatsApp > Configurações
  3. Selecione o modo "Usar WSL Ubuntu" e clique em "Iniciar Instalação".
    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.
  5. 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

  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 1 ou contate a equipe técnica.

3. 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:
    1. 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.

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

5. 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 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:
    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.
    6. 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=681”