Instalação: Evoluiton API
Aviso Importante: Responsabilidade sobre a Instalação e Suporte
A Evoluiton API é uma solução de software de código aberto.
Isso significa que todo o processo de instalação, configuração, manutenção contínua e garantia de que a API permaneça online é de inteira responsabilidade do assinante.
A equipe de suporte do Z-PRO não presta assistência para problemas relacionados à instalação, configuração ou falhas de funcionamento desta API externa. Por ser um software de terceiros e de código aberto, o Z-PRO não oferece nenhuma garantia sobre a sua estabilidade, segurança ou continuidade de funcionamento.
1. Prepare o Ambiente
Antes de tudo, precisamos de duas ferramentas essenciais no seu computador. Se você já não as tiver, baixe e instale:
Git: Essencial para executar nosso script. Faça o download aqui.
Docker Desktop: A plataforma que vai rodar nossa aplicação. Faça o download aqui.
Após instalar o Docker, lembre-se de abrir o programa e deixá-lo rodando. Ele precisa estar ativo para que a mágica aconteça.
2. Baixe o Script de Instalação
Para facilitar sua vida, preparamos um pacote com tudo que você precisa.
Descompacte o arquivo em uma pasta de fácil acesso no seu computador (por exemplo:
C:\Evolution
).
3. Execute os Comandos no Terminal
Agora vem a parte mais fácil. Vamos rodar os comandos que farão todo o trabalho pesado.
Navegue até a pasta onde você descompactou os arquivos.
Clique com o botão direito do mouse dentro da pasta e selecione a opção "Abrir no Terminal" ou "Open in Terminal".
O terminal do Windows (PowerShell) será aberto. Primeiro, vamos ativar o interpretador Bash do Git com o seguinte comando. Copie, cole e pressione Enter:
& "C:\Program Files\Git\bin\bash.exe"
Com o Bash ativo, execute o script de instalação. Digite o comando abaixo e pressione Enter:
./evolution.sh
Pronto! O script fará o download e a configuração de todos os componentes da Evolution API. Na primeira vez, pode demorar alguns minutos.
4. Acessando e Conectando sua API
Com tudo instalado, é hora de acessar o painel de controle.
Abra seu navegador e acesse: http://localhost:8081
Clique em "Manager". O sistema pedirá uma Chave Global (Global API Key).
Para encontrá-la, abra o arquivo
evolution.sh
com um editor de texto (Bloco de Notas). No final do arquivo, você encontrará a chave. Copie e cole no painel.Dentro do painel, crie uma nova instância, dê um nome e clique nela para gerar o QR Code.
Leia o QR Code com o WhatsApp do seu celular e aguarde a conexão ser estabelecida.
5. Integração com Z-PRO
O último passo é conectar sua nova instância da Evolution API ao painel do Z-PRO.
No painel Admin, navegue até Configurações > Integrações > Wuzapi.
Preencha a URL da API com o endereço do seu servidor (ex: http://SEU_IP_DE_SERVIDOR:5555).
Preencha a Chave Global com o APP_ADMIN_TOKEN definido no seu arquivo .env.
Acesse o painel Admin do tenant, vá em Canais > Adicionar Canal e selecione a opção "Evoluiton".
Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.
Tutorial:
Atualizado