LIST_DEVICES | A client sends FETCH_DEVICES. | Device list with name, device, and jid entries. |
LOGIN_SUCCESS | WhatsApp pairs the device. | null. Refresh device status over REST. |
PASSKEY_REQUEST | WhatsApp requests a passkey assertion. | device_id, challenge (WebAuthn options). |
PASSKEY_CONFIRMATION | WhatsApp reports the passkey handoff result. | device_id, code, skip_handoff_ux. When skip_handoff_ux is true, the active QR flow sends the confirmation automatically. Otherwise compare the code with the phone and call POST /app/passkey/confirm. |
PASSKEY_ERROR | Passkey pairing fails. | device_id, continuation. Read the error text from message. |
DEVICE_LOGGED_OUT | The device logs out and keeps its slot. | device_id and either reason for a remote logout or devices for an API logout. The list shape depends on the logout endpoint. |
DEVICE_REMOVED | The device slot is deleted. | device_id, devices (remaining slots). |
DEVICE_STREAM_REPLACED | Another client connects with the same WhatsApp session. | device_id. |
DEVICE_TEMPORARY_BAN | WhatsApp reports a temporary ban. | device_id, code, reason, expires_in_seconds, and expires_at when WhatsApp supplies an expiry. |
DEVICE_REACHOUT_TIMELOCK | WhatsApp reports or lifts a restriction on starting new chats. | device_id, is_active, and optional enforcement_type and ends_at. |
DEVICE_WEBHOOK_UPDATED | The device’s webhook URL changes. | device_id, webhook_url. |
DEVICE_WEBHOOK_CONFIG_UPDATED | The device’s webhook settings change. | device_id. |