> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/canal-whatsapp-zapo.md).
# Canal whatsapp ZAPO
WhatsApp ZAPO: Como conectar
{% 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 ZAPO é uma solução de integração não oficial baseada em uma biblioteca TypeScript leve e de alto desempenho, que também emula o protocolo do WhatsApp Web. Assim como o Baileys, ela permite conectar um número de telefone comum ao sistema Z-PRO sem exigir aprovação prévia da Meta ou conta empresarial verificada.
A diferença está na engenharia por trás da conexão: a ZAPO foi projetada desde a base para escalar em múltiplas sessões simultâneas, com baixo consumo de memória e caminhos críticos (*hot paths*) em *zero-copy* — o que se traduz em menos uso de recursos e mais estabilidade em operações com grande volume de conexões ativas. Ela também dá controle total sobre autenticação, transporte, protocolo Signal (camada de criptografia), estado da aplicação e mídia, o que permite otimizar e manter essa camada de integração com mais precisão.
## Passo a passo para conexão
### **1. Adicionar um canal ZAPO**
**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 "Baileys", localize o card do canal e clique no botão **Novo QR Code**. Um modal será aberto exibindo o código.
### **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**.
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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://ajuda.zdg.com.br/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/canal-whatsapp-zapo.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
