WhatsApp: mudanças entre as edições

De Wiki Celta
Ir para navegação Ir para pesquisar
Sem resumo de edição
 
(27 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 Sistema 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 ERP. 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.
* '''Arquivos Necessários''': Os seguintes arquivos devem estar presentes em <code>C:\Celta Sistemas\WhatsApp</code>:
** <code>setup_wsl_docker.ps1</code> (script Bash)
** <code>setup_docker_api.sh</code> (script Bash)
** <code>.env</code> (arquivo de configuração)
** <code>docker-compose.yaml</code> (arquivo de composição do Docker)


=== 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. Verificar Arquivos Obrigatórios ====
== Configuração via Docker Desktop == 
# Navegue até <code>C:\Celta Sistemas\WhatsApp</code> no Explorador de Arquivos.
Esta seção descreve a instalação simplificada da Evolution API usando o Docker Desktop. 
# Confirme a presença dos arquivos:
Tudo é gerenciado diretamente pelo Celta.
## <code>setup_docker_api.sh</code>
 
## <code>.env</code>
=== Passo a Passo === 
## <code>docker-compose.yaml</code>
 
# Se algum arquivo estiver ausente, solicite ao responsável pelo ERP ou equipe técnica antes de prosseguir.
==== 1. Iniciar configuração ==== 
# 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).
 
==== 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.


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


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


==== 6. 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 que os arquivos estão em <code>C:\Celta Sistemas\WhatsApp</code>.
** '''"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 WSL (Ubuntu-24.04), edite o arquivo <code>.env</code> em <code>/mnt/c/Celta Sistemas/WhatsApp</code> com <code>sudo nano .env</code>.
## 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 ou altere para <code>DEBUG=true</code> e salve (Ctrl + O, Enter, Ctrl + X).
## Adicione as linhas: 
## Reinicie o serviço com <code>sudo systemctl restart evolution-api.service</code>.
## <code>debugConsole=true</code>
## Envie os logs detalhados (<code>/var/log/evolution-api.log</code>) para a equipe técnica.
## Salve o arquivo e reinicie o WSL com <code>wsl --shutdown</code> no PowerShell ou Prompt de Comando.
* '''Suporte Adicional''':
## Os logs de depuração do WSL serão exibidos no console. 
** Contate a equipe técnica da Celta Sistemas em caso de dúvidas ou falhas persistentes.
## 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 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”