# WhatsApp Evolution API (Não Oficial)

{% hint style="danger" %}
**Atenção: Risco de Banimento**\
O uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da **API Oficial (WABA)**.
{% endhint %}

A **Evolution API** é uma solução de integração não oficial de alto desempenho, que atua como um gateway entre o WhatsApp e o sistema Z-PRO. Diferente das bibliotecas simples, ela oferece uma camada extra de gerenciamento e robustez para as instâncias de WhatsApp conectadas via QR Code, permitindo uma operação mais estável em cenários de grande volume de mensagens

A Evolution API permite que o sistema gerencie as sessões de forma desacoplada. Isso significa que, mesmo que a interface do Z-PRO sofra uma atualização, as instâncias no servidor da API permanecem conectadas, reduzindo a necessidade de novos pareamentos frequentes.

## Passo a passo para conexão

### **1. Instalar Evoluiton API**

Antes de qualquer configuração no painel Z-PRO, a Evolution API deve estar devidamente instalada e rodando em seu servidor.

* Siga as instruções técnicas contidas na página: [Instalação: Evolution API](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/whatsapp-evolution-api-nao-oficial/instalacao-evolution-api.md)

### **2. Configuração no Painel Administrativo**

1. Acesse o menu **Configurações > Integrações > Evolution API**.

<figure><img src="/files/ajWjtDr7uu1In4VEY2hW" alt=""><figcaption></figcaption></figure>

2. Insira a **URL da API** (Ex: <https://api.seuservidor.com>).
3. Cole a sua **Global Key**.
4. Clique no botão **Verificar Status da API**. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente.

{% hint style="warning" %}
**Atenção:** Não inclua a barra (/) no final da URL da API. Uma URL incorreta (ex: .../ em vez de ...) causará falha na conexão.
{% endhint %}

**Observações Importantes:**

* **Conectando uma Instância Existente:** Se você já possui uma instância criada na Evolution, basta criar um novo canal no Z-PRO com o **mesmo nome exato** da instância. O sistema irá sincronizar e configurar o webhook.
* **Nomenclatura:** Não utilize caracteres especiais (como \_) no nome da instância, pois isso pode causar falhas na sincronização.
* **Nome da Instância:** Uma vez criado, o nome da instância não pode ser alterado.

### **3. Adicionar um canal**&#x20;

**Passo passo geral aqui:** [Como conectar um canal (sessão/número)](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/como-conectar-um-canal-sessao-numero.md)

### **4. Gerar o QR Code**

Após salvar as configurações iniciais do canal, localize o card do canal e clique no botão **Novo QR Code**. Um modal será aberto exibindo o código.<br>

<figure><img src="/files/iFbqY5u75MdtDi3Ad8GD" alt="" width="331"><figcaption></figcaption></figure>

<figure><img src="/files/L7K4tZBveMCtCgUrDrHm" alt="" width="331"><figcaption></figcaption></figure>

### **5. Escanear no Aparelho**

1. Abra o WhatsApp no seu celular.
2. Vá em **Configurações** (ou Ajustes) > **Dispositivos Conectados**.
3. Clique em **Conectar um dispositivo**.
4. Aponte a câmera do celular para o QR Code exibido na tela do Z-PRO.

### **6. Confirmar a Conexão**

Aguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para **CONNECTED**.

<figure><img src="/files/hPEOgJFoab7HfC5uwN99" alt=""><figcaption></figcaption></figure>

O QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em **Novo QR Code** dentro do modal para gerar uma nova imagem.

{% hint style="warning" %}
**Estabilidade:** Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel.
{% endhint %}


---

# 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.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.