WhatsApp Mudou Tudo! Como Conectar Após a Nova Passkey

Links importantes

Nova Segurança do WhatsApp Web (PSK): Como Manter suas APIs Funcionando

Nova Segurança do WhatsApp Web (PSK): Como Manter suas APIs Funcionando


Bora pra ação! O WhatsApp acaba de liberar uma nova camada de segurança para o WhatsApp Web que está impactando todas as APIs não oficiais do mercado. Trata-se da exigência de uma chave de segurança (PSK - Pre-Shared Key) durante a conexão, um passo que quebra o fluxo de leitura de QR Code tradicional.

Neste guia, vou te apresentar a solução que desenvolvemos: uma extensão gratuita da Comunidade ZDG que contorna esse problema e permite que você continue usando suas APIs Baileys, WPPConnect-Mio e outras.

Material de Apoio

O link para baixar a nova extensão PSK Linker (e o pacote para instalação manual, caso necessário) está disponível logo acima nesta página.

O Problema: O Que é a Verificação de Segurança PSK?

Se sua conta já foi impactada, ao tentar conectar o WhatsApp Web, você verá uma nova tela de "Verificação de Segurança" que solicita uma chave de acesso (gerada pelo Google Authenticator, por exemplo). Esse passo extra impede que as APIs consigam completar a autenticação via QR Code da forma como sempre fizeram.

A Solução: A Extensão PSK Linker da ZDG

Para resolver isso, criamos a PSK Linker, uma extensão para o Chrome que extrai as credenciais de autenticação necessárias (as "creds") diretamente do seu WhatsApp Web, após você completar o login, e as disponibiliza para serem usadas em sistemas como o Z-PRO ou qualquer outra aplicação que consuma uma API não oficial.

Passo a Passo: Como Usar a Extensão

1. Instalação e Preparação

  1. Instale a Extensão: Baixe a "PSK Linker" pela Chrome Web Store através do link de apoio.
    Atenção: Se a versão na loja ainda for a 3.0, baixe o pacote .zip da versão 3.30 na página de apoio, descompacte-o e instale manualmente no Chrome (em "Gerenciar Extensões" > "Carregar sem compactação").
  2. Regra de Ouro: Remova qualquer outra extensão de WhatsApp do seu navegador para evitar conflitos.
  3. Reinicie o Navegador: Feche e abra o Chrome novamente.
  4. Acesse o WhatsApp Web: Faça o login na sua conta do WhatsApp Web. Se a verificação PSK for solicitada, complete-a. A extensão só funciona com o WhatsApp Web já carregado.

2. Usando com o Z-PRO (Fluxo Automatizado)

Para usuários do Z-PRO, o processo é extremamente fluido e integrado (disponível a partir do Hotfix .13).

  1. No Z-PRO, ao criar ou reconectar um canal (Baileys ou Mio), escolha a opção de conexão "WhatsApp Web" em vez de "Novo QR Code".
  2. O sistema abrirá uma nova aba com o WhatsApp Web. Faça seu login normalmente.
  3. Com o WhatsApp Web carregado, clique no ícone da extensão PSK Linker no seu navegador.
  4. Clique no botão "Extrair Sessão para o Z-PRO".

Pronto! A extensão irá extrair as credenciais, enviá-las automaticamente para o seu backend do Z-PRO e conectar o canal. O usuário final terá uma experiência quase idêntica à de ler um QR Code, mantendo a simplicidade do processo.

3. Usando com Outros Sistemas (Fluxo Manual)

Se você não usa o Z-PRO, mas precisa das credenciais para sua própria aplicação, o processo é igualmente simples.

  1. Siga o passo de instalação e login no WhatsApp Web.
  2. Clique no ícone da extensão PSK Linker.
  3. Clique no botão "Copiar Creds".

As credenciais de autenticação (em formato JSON) serão copiadas para sua área de transferência. Agora, basta colá-las no local apropriado do seu sistema ou backend para estabelecer a conexão com a API.

Status das APIs

No momento, esta solução está totalmente compatível com as APIs Baileys e WPPConnect, Meow. Estamos aguardando atualizações dos mantenedores de outras bibliotecas, como a Evolution API, para adaptar a solução.

Essa mudança da Meta reforça a constante evolução do ecossistema do WhatsApp. Com a PSK Linker, garantimos que a comunidade ZDG continue operando com o mínimo de impacto. Fique ligado para mais atualizações!

Qualquer dúvida, é só chamar. Tamo junto!