> 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-uazapi.md).

# Canal whatsapp Uazapi

## Canal whatsapp Uazapi

A Uazapi também é uma solução não oficial **paga e gerenciada**. <https://uazapi.dev/>

### Passo a passo para conexão

#### **1. Contratar a Uazapi**

Antes de qualquer configuração no painel Norux, é preciso contratar API por aqui: <https://uazapi.dev/>

**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 do servidor da sua conta Uazapi.
3. **Chave Global:** O "Admin Token" fornecido no painel da sua conta Uazapi.
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)<br>

A integração com a Uazapi oferece duas possibilidades:

* **A) Criar uma Nova Instância:**
  1. No painel **Admin**, vá em **Canais > Adicionar Canal** e selecione **"Uazapi"**.
  2. Dê um nome para a nova instância (ex: "Cliente A").
  3. Deixe os campos **ID da Instância** e **Token** em branco.
  4. Salve. O Norux irá criar a nova instância na sua conta Uazapi e preencherá as credenciais automaticamente.
* **B) Conectar a uma Instância Existente:**
  1. Siga os mesmos passos acima, mas desta vez preencha os campos **ID da Instância** e **Token** com as informações da instância já existente na sua conta Uazapi.

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