> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/canal-evolution-api-nao-oficial/instalacao-evolution-api.md). # 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: ). 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="" %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/canal-evolution-api-nao-oficial/instalacao-evolution-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.