WZAPI
gateway :18080
vinculación de sesiones

Cómo se vincula una sesión

QR · 180 s código · 5 min passkey · 10 min PairSuccess → Connected
cuál método usar

Dos formas de arrancar el mismo pareo

Escanear un QR

POST /session/connect · GET /session/qr

Código de teléfono

POST /session/connect → POST /session/pairphone

criterio QR código de teléfono
Ventana
Endpoint GET /session/qr QR POST /session/pairphone
Cuándo conviene
Qué ve el usuario
paso a paso

Los cuatro flujos

A QR sin passkey

QR sin passkey

  1. Conecta la sesión

    POST /session/connect

  2. Muestra el QR

    QR GET /session/qr

  3. El usuario escanea

  4. Vinculado

    PairSuccess Connected

B QR + passkey

QR passkey

  1. Igual que A, pasos 1 a 3

    POST /session/connect QR

  2. WhatsApp exige la passkey

    PasskeyRequest

  3. Un humano firma

    GET /passkey/api/{token}/challenge

  4. Devuelve la aserción y confirma

    POST /passkey/api/{token}/response PasskeyConfirmation POST /passkey/api/{token}/confirm

  5. Vinculado

    PairSuccess Connected

C Código sin passkey

código sin passkey

  1. Conecta la sesión

    POST /session/connect

  2. Pide el código

    POST /session/pairphone

  3. El usuario lo teclea

  4. Vinculado

    PairSuccess Connected

D Código + passkey

código passkey

  1. Igual que C, pasos 1 a 3

    POST /session/connect POST /session/pairphone

  2. WhatsApp exige la passkey

    PasskeyRequest

  3. La misma ceremonia que en B

    GET /passkey/api/{token}/challenge POST /passkey/api/{token}/response POST /passkey/api/{token}/confirm

  4. Vinculado

    PairSuccess Connected
cuando algo falla

Qué puede salir mal

El QR o el código caducaron

El enlace de la ceremonia caducó

El paso de passkey no puede atenderse

Dónde mirar