> For the complete documentation index, see [llms.txt](https://ajuda.norux.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.norux.chat/admin/configuracao-e-administracao/canal-whatsapp-z-api.md).

# Canal whatsapp Z-API

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

#### **3. Adicionar um canal**

**Passo passo geral aqui:** Como conectar um canal (sessão/número)\
Configuração adicional para a Z-API:

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

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

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

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

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
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.norux.chat/admin/configuracao-e-administracao/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.