WhatsApp

Início / Módulos e Apps

Configuração do WhatsApp (Evolution API)

Atualizado em: 30/11/2025

Este tutorial orienta a instalação e configuração da Evolution API no Windows para integração com o Celta. Utilizamos o Docker Desktop para garantir estabilidade e gerenciamento simplificado do serviço.

REQUISITO CRÍTICO - VIRTUALIZAÇÃO

Para que o Docker funcione, a Virtualização deve estar habilitada na BIOS/UEFI do computador.

• Como verificar: Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) > Aba Desempenho > CPU. Procure por "Virtualização: Habilitado".
• Se estiver "Desabilitado", reinicie o PC, acesse a BIOS e ative (procure por Intel VT-x ou AMD-V).

1. Requisitos do Sistema

Certifique-se de que o computador servidor atende aos requisitos mínimos:

• Sistema Operacional: Windows 10 (versão 21H2 ou superior) ou Windows 11.
• Privilégios: O Sistema Celta deve ser executado como Administrador.
• Memória: Recomendado mínimo de 8GB de RAM (o Docker consome recursos consideráveis).

2. Instalação Automática (Via Celta)

O Sistema Celta possui um assistente que automatiza o download, instalação e configuração do ambiente.

1. Abra o Celta como Administrador.
2. Acesse o menu: Principal > WhatsApp > Configurações.
3. No campo Host, informe o IP fixo ou nome do computador servidor.
4. Selecione a opção: Usar Docker Desktop.
5. Clique em Iniciar Instalação.

O QUE O SISTEMA ESTÁ FAZENDO?

O Celta executará automaticamente os seguintes passos em segundo plano:

1. Cria o diretório C:\Celta Sistemas\WhatsApp.
2. Gera os arquivos de configuração (docker-compose.yaml e .env) com o IP informado.
3. Verifica e solicita ativação do Hyper-V (se necessário).
4. Libera a porta 8010 no Firewall do Windows.
5. Inicia o download e instalação do Docker Desktop (caso não exista).
6. Sobe os containers da API.

Validação

Ao final do processo, o log na tela deve exibir: "Ambiente Docker configurado com sucesso".

3. Pós-Instalação (Início Automático)

Para garantir que o WhatsApp não pare de funcionar ao reiniciar o servidor, configure o Docker para iniciar junto com o Windows.

1. Abra o Docker Desktop.
2. Vá em Settings (ícone da engrenagem) > General.
3. Marque a opção: Start Docker Desktop when you sign in to your computer.

4. Diagnóstico e Solução de Problemas

Se a página da API (http://localhost:8010) não carregar ou houver erros no log, verifique a tabela abaixo:

Campo / Parâmetro	Função e Instruções
Erro: "Docker não instalado"	Ocasionalmente o instalador automático pode ser bloqueado. Solução: Baixe e instale o Docker Desktop manualmente pelo site oficial e clique em "Iniciar Instalação" no Celta novamente.
Erro: "Porta 8010 ocupada"	Algum outro software está usando a porta padrão da API. Solução: Verifique se há outra instância da API rodando ou altere a porta no arquivo .env e reinicie o container.
Erro: "Hyper-V / WSL error"	O Windows não conseguiu ativar o subsistema Linux. Solução: Confirme se a Virtualização e o Hyper-V estão ativos