> For the complete documentation index, see [llms.txt](https://centralhub-ajuda.wlksistemas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://centralhub-ajuda.wlksistemas.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/canal-whatsapp-z-api.md).

# Canal 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 configurar na Central Hub, é preciso contratar o serviço diretamente em <https://www.z-api.io/>. A instância precisa ser criada primeiro no painel da Z-API; a Central Hub apenas se conecta a instâncias já existentes.

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

Acesse **Configurações → Integrações → Z-API**: informe a **URL da API** (<https://api.z-api.io>), a **Chave Global** (Token de Segurança gerado na sua conta Z-API), e clique em **Verificar Status da API**.

### 3. Adicionar um canal

Passo a passo geral aqui: Como conectar um canal (sessão/número). Campos adicionais específicos deste canal: **ID da Instância** e **Token da Instância** (ambos obtidos no painel da Z-API).

### 4. Gerar o QR Code

Após salvar as configurações iniciais do canal como "Z-API", localize o card do canal e clique no botão **Novo QR Code**. Um modal será aberto exibindo o código. Você verá a seguinte tela: SCREENSHOT NECESSÁRIO: modal do QR Code do canal Z-API.

### 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 da Central Hub.

### 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. Você verá a seguinte tela: SCREENSHOT NECESSÁRIO: card do canal com status CONNECTED.

{% 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 %}

## Veja também

* Visão geral de canais
* Como conectar um canal (sessão/número)
* [API Oficial vs API Não Oficial](/diretrizes-e-politicas/api-oficial-vs-api-nao-oficial.md)

## Precisa de ajuda?

Fale com o suporte da Central Hub pelo WhatsApp: [(31) 997122-2063](https://wa.me/5531997122063).


---

# 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://centralhub-ajuda.wlksistemas.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/canal-whatsapp-z-api.md?ask=<question>&goal=<endgoal>
```

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