Evolution API / Evolution Go is an open-source WhatsApp integration API
Evolution Passkey Helper
Extensão de navegador que conclui o pareamento por chave de acesso (passkey) do WhatsApp Web para o Evolution GO.
Desde que o WhatsApp passou a exigir passkey ao vincular um novo dispositivo, o
QR Code sozinho não basta em algumas contas: é preciso executar uma cerimônia
WebAuthn (navigator.credentials.get), e o navegador só permite isso quando o
código roda no origin da relying party — whatsapp.com. Esta extensão roda
somente em web.whatsapp.com e serve apenas como "palco" com o origin
correto para a biometria/PIN. Ela não interage com o login do WhatsApp Web e
não coleta nem envia dados para terceiros.
Como funciona
- Você escaneia o QR normalmente no Evolution (manager). Se a conta exigir passkey, o painel de conexão mostra o botão "Abrir WhatsApp Web".
- Esse botão abre
https://web.whatsapp.com/#wapk=<payload>, ondepayloadé um base64url de{ "t": "<token da instância>", "b": "<url base da API>" }. - O content script lê esse payload, consulta o status da cerimônia na API,
executa a cerimônia WebAuthn no origin
whatsapp.come envia a assinatura de volta para o Evolution. - Se o pareamento exigir confirmação manual do código, o painel mostra o código e um botão "Confirmar código". Na maioria dos casos (QR escaneado antes), o Evolution confirma automaticamente e você só precisa voltar ao manager.
Nenhuma host_permission é necessária: as chamadas partem do origin
web.whatsapp.com e o backend do Evolution já libera CORS para essa origem.
Endpoints usados (Evolution GO)
GET {base}/passkey-ceremony/{token}— status/desafio da cerimôniaPOST {base}/passkey-ceremony/{token}/response— envia a assertion WebAuthnPOST {base}/passkey-ceremony/{token}/confirm— confirma o código (quando aplicável)
Onde base é a URL da sua API Evolution e token é o token da instância.
Instalar no Google Chrome
- Baixe/descompacte esta pasta (a que contém
manifest.json). - Abra
chrome://extensions. - Ative o Modo do desenvolvedor (canto superior direito).
- Clique em Carregar sem compactação.
- Selecione esta pasta.
- Volte ao Evolution e clique em "Abrir WhatsApp Web".
Instalar no Microsoft Edge
- Baixe/descompacte esta pasta (a que contém
manifest.json). - Abra
edge://extensions. - Ative o Modo de desenvolvedor (canto inferior esquerdo).
- Clique em Carregar sem pacote.
- Selecione esta pasta.
- Volte ao Evolution e clique em "Abrir WhatsApp Web".
Dicas
- Use o navegador logado na mesma conta (Google/iCloud) onde a passkey do WhatsApp está salva, ou tenha o celular por perto para o fluxo de biometria.
- A cerimônia tem validade curta. Se expirar, gere um novo QR no Evolution.
Whitelabel
A extensão é genérica: nada de URL ou token fica embutido no código — tudo vem
no payload da URL. Para personalizar nome/ícone, edite o manifest.json e o
título/descrição do painel em content.js.