Support WhatsApp passkey flow when linking device with QR code or pairing code

I maintainer di solito rispondono entro 2 giorni

Valutazione

Direzione di ricerca

Descrizione

Fixed

• GOWS
  • https://github.com/tulir/whatsmeow/issues/1184
  • https://github.com/tulir/whatsmeow/pull/1186
  • 2026.7.1 - GOWS - Passkey (WebAuthn) session pairing — pair sessions from your own UI - How to Handle Passkey
• NOWEB
  • https://github.com/WhiskeySockets/Baileys/issues/2672
• WEBJS
  • https://github.com/wwebjs/whatsapp-web.js/issues/201806
• WPP
  • https://github.com/wppconnect-team/wppconnect/issues/2815

Summary

WhatsApp is now requiring a passkey flow when linking a device. WAHA exposes QR code and pairing code flows, but both get stuck because the WhatsApp mobile app asks the user to continue on WhatsApp Web and complete passkey verification.

Environment

• WAHA image: devlikeapro/waha:gows
• Engine: GOWS
• Auth methods tested:
  • QR Code
  • Pairing code via POST /api/{session}/auth/request-code
• WhatsApp mobile app: Android
• WAHA session status after starting: SCAN_QR_CODE

What happens

When scanning the QR code, WhatsApp accepts the QR initially, but then shows:

Continue on WhatsApp Web
Keep app open on both devices. You may need to scan another QR code to use your Passkey.

When deleting the passkey and trying again, WhatsApp shows:

Create a passkey to log in
For security reasons, your account needs a passkey to link devices

The same requirement appears when using the pairing code flow.

Expected behavior

WAHA should either:

• support this new passkey continuation flow,
• expose a way for the user to complete the passkey step,
• document which engines support it,
• or clearly document that WhatsApp accounts requiring passkeys cannot currently be linked.

Steps to reproduce

1. Start a new WAHA session.
2. Get QR code for the session.
3. Scan the QR code using WhatsApp mobile app.
4. WhatsApp asks to continue on WhatsApp Web for passkey verification.
5. Session does not complete in WAHA.

Alternative:

1. Start a new WAHA session.
2. Call POST /api/{session}/auth/request-code with the phone number.
3. Enter the pairing code in WhatsApp.
4. WhatsApp still requires passkey before linking the device.
5. Session does not complete in WAHA.

Additional context

The same WhatsApp account can be linked successfully using the official WhatsApp Web flow, because the user can complete passkey verification in the browser.

The problem is that with WAHA, especially GOWS, there is no visible/interactable WhatsApp Web screen where the user can complete the passkey step.

Could you confirm whether this passkey flow is supported by any WAHA engine, such as WEBJS or WPP, or whether it is currently unsupported?

Preparare l'ambiente

Come iniziare

1. Leggi tutta la issue e poi la guida ai contributi del progetto.
2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
3. Fai un fork del repository e lavora su un branch.
4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di devlikeapro/waha

• [GOWS] - Link preview request sends User-Agent and Accept values swapped

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  bug

  Difficoltà 2/5 1-3 ore Idoneità per principianti 83/100

  devlikeapro/waha#2322 · Aperta il 20/10/2026

  I maintainer di solito rispondono entro 2 giorni

• [GOWS] Expose whatsmeow KeepAlive interval via env — sessions flap behind idle-socket-reaping proxies

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  patron:PLUS

  Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100

  devlikeapro/waha#2167 · 1 commento · Aperta il 19/7/2026

  I maintainer di solito rispondono entro 2 giorni

• [NOWEB] sendImage WebP accepted but absent on recipient mobile (visible on Web)

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla

  Difficoltà 3/5 1-2 giorni Idoneità per principianti 52/100

  devlikeapro/waha#2321 · Aperta il 19/10/2026

  I maintainer di solito rispondono entro 2 giorni

• Ability to take screenshot of particular chats

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  patron:PLUS

  Difficoltà 5/5 Più di una settimana Idoneità per principianti 45/100

  devlikeapro/waha#2320 · Aperta il 19/10/2026

  I maintainer di solito rispondono entro 2 giorni

• GOWS: FAILED has no reason, and temporary ban / stream replaced / client outdated leave the session silently dead

  Forse già presa @diego-goncalves-teixeira l’ha presa 4 giorni fa. Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  patron:PLUS

  Difficoltà 4/5 3-5 giorni Idoneità per principianti 25/100

  devlikeapro/waha#2317 · Aperta il 16/10/2026

  I maintainer di solito rispondono entro 2 giorni

Tutte le issue di devlikeapro/waha

Issue simili

• [BUG] rag: sentence content can cross the reported sentence boundaries

  Forse già presa @LJK-ikun l’ha presa oggi. Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  bug

  Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100

  VoltAgent/voltagent#1469 · Aperta il 21/10/2026

  I maintainer di solito rispondono entro 1 giorno

• [Bug]: preview_evaluate accepts returnByValue:false but returns no usable object reference

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  bug needs-triage

  Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100

  pingdotgg/t3code#22946 · Aperta il 21/10/2026

  I maintainer di solito rispondono entro 1 giorno

• README: the Resource URI Schemas example's file://documents/* pattern only matches that literal URI

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla

  Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100

  platformatic/mcp#361 · Aperta il 21/10/2026

  I maintainer di solito rispondono entro 1 giorno

• [FE] Refactor: Consolidate the academic-year date helpers

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla
  frontend

  Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100

  NIAEFEUP/tts#918 · Aperta il 21/10/2026

  I maintainer di solito rispondono entro 1 giorno

• Push: sem service worker ou sem VAPID, o interruptor de Notificações fica ligado sem avisar nada

  Aperta

  ⋯Segnala un problema con questa issue

  • Qualcosa non va?

  • Già presa in carico
  • Non adatta ai principianti
  • Obsoleta o non valida
  • Altro…
  • Invia Annulla

  Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100

  melgarafael/DeskcommCRM#3164 · Aperta il 21/10/2026

  I maintainer di solito rispondono entro 1 giorno

Altre issue su TypeScript