# Instalação: Evolution API

{% hint style="warning" %}
**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.
{% endhint %}

#### 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](https://git-scm.com/downloads).
* **Docker Desktop:** A plataforma que vai rodar nossa aplicação. [Faça o download aqui](https://www.docker.com/products/docker-desktop/).

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.

* [Baixe aqui o arquivo **evolution.rar**](https://comunidade.zdg.dev.br/apis-whatsapp/evolution-api-para-whatsapp-gratis-e-ilimitada-atualizada-2025/#).
* 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.

1. Navegue até a pasta onde você descompactou os arquivos.
2. Clique com o botão direito do mouse dentro da pasta e selecione a opção **"Abrir no Terminal"** ou **"Open in Terminal"**.
3. 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"
   ```
4. 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.

1. Abra seu navegador e acesse: [http://localhost:8081](http://localhost:8081/)
2. Clique em **"Manager"**. O sistema pedirá uma Chave Global (Global API Key).
3. 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.
4. Dentro do painel, crie uma nova instância, dê um nome e clique nela para gerar o **QR Code**.
5. 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.

1. No painel **Admin**, navegue até **Configurações > Integrações > Evolution**.
2. Preencha a **URL da API** com o endereço do seu servidor (ex: <http://SEU\\_IP\\_DE\\_SERVIDOR:5555>).
3. Preencha a **Chave Global** com o APP\_ADMIN\_TOKEN definido no seu arquivo .env.
4. Acesse o painel **Admin** do tenant, vá em **Canais > Adicionar Canal** e selecione a opção **"Evoluiton"**.
5. Crie a conexão, gere o QR Code e escaneie com o WhatsApp para ativá-la.

### Tutorial:

{% embed url="<https://www.youtube.com/watch?v=cQewqCSez5I>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.