WhatsApp Bloqueou a Evolution API? Veja a Solução Gratuita!

Links importantes

Evolution API e a Nova Segurança PSK: A Solução Definitiva (PSK Injector)

Evolution API e a Nova Segurança PSK: A Solução Definitiva (PSK Injector)


Bora pra ação! A nova camada de segurança do WhatsApp Web (PSK) impactou todas as APIs não oficiais, incluindo a querida Evolution API e a EvoGO. Hoje, vou te apresentar a solução definitiva e gratuita que desenvolvemos para contornar esse problema: o PSK Injector.

Trata-se de um microserviço que funciona em conjunto com a extensão PSK Linker para injetar as credenciais de autenticação diretamente no banco de dados da sua Evolution, garantindo que suas conexões voltem a funcionar perfeitamente.

Material de Apoio

O link para o repositório do PSK Injector no GitHub, assim como o link para a extensão PSK Linker, estão disponíveis logo acima nesta página.

Entendendo o Problema e a Solução

A nova verificação de segurança do WhatsApp Web quebrou o fluxo de conexão via QR Code para as APIs. A solução que encontramos envolve duas partes que trabalham juntas:

  1. PSK Linker (Extensão para Chrome): Ela extrai as credenciais de autenticação ("creds") do seu WhatsApp Web após você fazer o login.
  2. PSK Injector (Microserviço): Ele recebe essas "creds" da extensão e as injeta diretamente na sessão correspondente no banco de dados da sua Evolution ou EvoGO, completando a autenticação.

Passo a Passo: Instalação e Configuração

1. Pré-requisitos

  • Sua instância da Evolution API ou EvoGO já deve estar rodando.
  • Git, Node.js e Docker Desktop instalados em sua máquina (para a instalação do Injector).
  • A extensão PSK Linker instalada no seu navegador Chrome.

2. Instalando o PSK Injector

Você pode instalar o Injector via Docker (recomendado) ou localmente com NPM.

Via Docker (Método Rápido):

  1. Clone o repositório: git clone https://github.com/pedroherpeto/evo-passkey-injector
  2. Navegue para a pasta: cd evo-passkey-injector
  3. Configure o .env: Renomeie o .env.example para .env. Dentro dele, preencha a string de conexão do banco de dados da sua Evolution (EVO_DATABASE_URL) ou da sua EvoGO (EVOGO_DATABASE_URL). Você pode configurar um ou ambos.
  4. Suba o contêiner: docker-compose up --build -d

Via NPM (Método Local):

  1. Siga os mesmos passos de clonar o repositório e configurar o arquivo .env.
  2. Instale as dependências: npm install
  3. Inicie o serviço: npm run dev (para desenvolvimento) ou npm start (após rodar npm run build para produção).

3. Usando a Solução

Com o PSK Injector rodando, o processo de conexão de uma nova instância da Evolution fica assim:

  1. Crie uma nova instância na sua Evolution API normalmente.
  2. Acesse o WhatsApp Web no seu navegador e faça login com o número que deseja conectar.
  3. Com o WhatsApp Web carregado, clique no ícone da extensão PSK Linker.
  4. Clique em "Copiar Creds".
  5. Abra a interface do PSK Injector (ex: http://localhost:3001).
  6. Cole as "creds" que você copiou no campo apropriado.
  7. Selecione a instância da Evolution que você criou e clique em "Conectar".

Fluxo Automatizado no Z-PRO

Para usuários do Z-PRO, esse processo é ainda mais simples e totalmente automatizado. Ao conectar uma Evolution, o sistema usa um fluxo OAuth que abre o WhatsApp Web, captura as creds com a extensão e as injeta sem que o usuário precise copiar e colar nada, mantendo a experiência fluida e prática.

Esta solução de código aberto foi criada para ajudar toda a comunidade a superar esse novo desafio imposto pela Meta. O repositório contém todas as instruções detalhadas para cada cenário de instalação.

Não deixe que a nova camada de segurança pare sua operação. Instale o PSK Injector e mantenha suas instâncias da Evolution 100% funcionais!

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