> 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/central-do-assinante/atualizacoes-e-status-do-z-pro/conexao-com-passkey-apis-nao-oficiais.md). # Conexão com Passkey — APIs não oficiais Em 30/06/2025, o WhatsApp ativou uma nova camada de segurança que exige uma **Chave de Acesso (Passkey)** durante o processo de vinculação de novos dispositivos. Isso quebrou o fluxo tradicional de leitura de QR Code utilizado pelas bibliotecas não oficiais — o problema **não é específico do Z-PRO** e afeta todo o ecossistema de APIs não oficiais. *** ### Status de compatibilidade por biblioteca | Biblioteca | Status | | ----------------- | --------------------------------------------------- | | **Baileys** | ✅ Compatível — já disponível no Z-PRO | | **WhatsMeow** | ✅ Compatível — já disponível no Z-PRO | | **UAZAPI** | ✅ Compatível — disponível via Hotfix | | **Z-API** | 🟡 Conector próprio — sem suporte nativo no momento | | **wwebjs** | 🟠 Aguardando atualização da biblioteca oficial | | **Evolution API** | 🟠 Aguardando atualização da biblioteca base | {% hint style="info" %} Se a sua sessão já está conectada e funcionando, **não desconecte nem recrie a sessão** sem necessidade até que sua biblioteca esteja homologada. {% endhint %} *** ### Solução: extensão Passkey Linker A ZDG desenvolveu e disponibiliza gratuitamente a extensão **Passkey Linker** para o Google Chrome. Ela autentica via WhatsApp Web e exporta automaticamente as credenciais para o Z-PRO — reproduzindo o fluxo tradicional de QR Code de forma transparente para o usuário final. {% embed url="" %} Milhares de APIs Foram Impactadas pela Nova Atualização do WhatsApp {% endembed %} *** ### Passo a passo para usuários Z-PRO #### Passo 1 — Instale a extensão Passkey Linker Acesse a Chrome Web Store e instale a versão mais recente da extensão: {% embed url="" %} Passkey Linker — Chrome Web Store {% endembed %} {% hint style="warning" %} **Versão mínima recomendada: 3.6.0.** Se você já utilizava a extensão, verifique se ela foi atualizada para essa versão na Chrome Web Store antes de prosseguir. {% endhint %} #### Passo 2 — Autentique no WhatsApp Web Abra o [WhatsApp Web](https://web.whatsapp.com/) no Chrome e faça o login normalmente com o celular: 1. Leia o QR Code com o aplicativo do WhatsApp 2. Se o WhatsApp solicitar a verificação de Passkey, complete o processo de autenticação exigido (Google Authenticator, chave de segurança ou chave salva no Chrome) 3. Aguarde o WhatsApp Web carregar completamente #### Passo 3 — Conecte o canal no Z-PRO 1. No painel, acesse **Administração → Canais** 2. Clique em **Adicionar canal** e selecione o tipo **Baileys** ou **WhatsMeow** 3. Dê um nome ao canal e salve 4. Na tela de conexão do canal, clique no botão **WhatsApp Web** O Z-PRO detectará automaticamente a sessão autenticada do WhatsApp Web e importará as credenciais. Basta confirmar a conexão. {% hint style="success" %} Processo concluído. A partir da versão 3.6.0 **não é mais necessário clicar em "Extrair Sessão"** — a integração com o Z-PRO é automática. {% endhint %} *** ### Usando a extensão com outros sistemas (não Z-PRO) A extensão Passkey Linker é white-label e pode ser usada com qualquer sistema compatível com Baileys ou WhatsMeow. 1. Instale a extensão conforme o Passo 1 2. Abra o WhatsApp Web e autentique normalmente (com Passkey, se exigido) 3. Clique no ícone da extensão na barra do Chrome 4. Clique em **Extrair sessão** e copie as credenciais exibidas 5. Cole-as no backend ou sistema que você utiliza para autenticação {% hint style="info" %} **Revendedores Z-PRO:** a extensão é gratuita e white-label — pode ser indicada livremente aos seus clientes. {% endhint %} *** ### Perguntas frequentes **Minha sessão já está conectada. Preciso fazer algo?** Não. O Passkey Linker é necessário apenas para conectar **novas** sessões. Sessões existentes e ativas não são afetadas — não as desconecte sem necessidade. **A extensão funciona com wwebjs ou Evolution?** Ainda não. Essas bibliotecas aguardam atualização dos seus respectivos mantenedores. Assim que estiver disponível, publicaremos um Hotfix do Z-PRO com a compatibilidade. **A extensão tem custo?** Não. É gratuita e disponibilizada pela ZDG para toda a comunidade. --- # 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.zdg.com.br/central-do-assinante/atualizacoes-e-status-do-z-pro/conexao-com-passkey-apis-nao-oficiais.md?ask=&goal= ``` `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.