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)
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:
- PSK Linker (Extensão para Chrome): Ela extrai as credenciais de autenticação ("creds") do seu WhatsApp Web após você fazer o login.
- 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):
- Clone o repositório:
git clone https://github.com/pedroherpeto/evo-passkey-injector - Navegue para a pasta:
cd evo-passkey-injector - Configure o
.env: Renomeie o.env.examplepara.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. - Suba o contêiner:
docker-compose up --build -d
Via NPM (Método Local):
- Siga os mesmos passos de clonar o repositório e configurar o arquivo
.env. - Instale as dependências:
npm install - Inicie o serviço:
npm run dev(para desenvolvimento) ounpm start(após rodarnpm run buildpara 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:
- Crie uma nova instância na sua Evolution API normalmente.
- Acesse o WhatsApp Web no seu navegador e faça login com o número que deseja conectar.
- Com o WhatsApp Web carregado, clique no ícone da extensão PSK Linker.
- Clique em "Copiar Creds".
- Abra a interface do PSK Injector (ex:
http://localhost:3001). - Cole as "creds" que você copiou no campo apropriado.
- 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!
