# Whatsapp Z-API

A Z-API é uma solução não oficial **paga e gerenciada** por uma empresa externa. <https://www.z-api.io/>

## Passo a passo para conexão

### **1. Contratar a Z-API**

Antes de qualquer configuração no painel Z-PRO, é preciso contratar API por aqui: <https://www.z-api.io/>

**Pré-requisito na Plataforma Z-API**

* Diferente das outras APIs, a **instância precisa ser criada primeiro** no painel de controle da Z-API. O Z-PRO não pode criar instâncias na Z-API, apenas conectar-se a existentes.

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

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

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

1. **URL da API:** A URL padrão do serviço (<https://api.z-api.io>).
2. **Chave Global:** O seu "Token de Segurança" gerado nas configurações da sua conta na Z-API.
3. 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.

### **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)\
Configuração adicional para a Z-API:&#x20;

* **ID da Instância**
* **Token da Instância**

<figure><img src="/files/k7jcFwDOoC8VDnK0diHN" alt="" width="371"><figcaption></figcaption></figure>

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