# WhatsApp WebJs (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 conexão via **WebJS** é uma solução de integração não oficial baseada na biblioteca whatsapp-web.js. Diferente de outras integrações, ela funciona através da automação e simulação de uma instância real do **WhatsApp Web** em um navegador interno no servidor. Isso permite que o sistema utilize todas as funcionalidades da interface web original sem a necessidade da API Oficial (WABA).

A biblioteca WebJS opera simulando a navegação de um usuário real no WhatsApp Web. Por rodar um navegador em segundo plano (headless browser), essa conexão pode exigir um pouco mais de processamento do servidor em comparação à Baileys, mas oferece uma fidelidade maior aos recursos disponíveis na versão oficial para navegador do WhatsApp.

## Passo a passo para conexão

### **1. Adicionar um canal**

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

### **2. Gerar o QR Code**

Após salvar as configurações iniciais do canal como "WebJS", 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>

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

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