← API 參考
接收事件

account.auth.required

帳號需要（重新）認證——驗證碼、掃碼或者兩步驗證。

事件載荷

{
  "id": "evt_auth_3c4d5e6f7a",
  "type": "account.auth.required",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:23:00Z",
  "data": {
    "auth_status": "awaiting_qr_scan",
    "runtime_status": "disconnected",
    "auth_payload": {
      "qr_code": "2@A1B2C3D4..."
    },
    "event": {
      "kind": "account_auth_status",
      "auth_status": "awaiting_qr_scan"
    }
  }
}

備註

  • 帳號需要使用者操作先可以上線。data.auth_status 表示目前等緊邊一步，data.auth_payload 帶住要渲染或者展示嘅材料，例如 qr_code、url、pin 或 verify_code，視 provider 同 auth_mode 而定。