← API 參考
接收事件

account.auth.failed

一次認證嘗試失敗。

事件載荷

{
  "id": "evt_auth_5e6f7a8b9c",
  "type": "account.auth.failed",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:25:00Z",
  "data": {
    "auth_status": "failed",
    "runtime_status": "disconnected",
    "last_error": "logged_out_from_another_device",
    "event": {
      "kind": "account_auth_status",
      "auth_status": "failed"
    }
  }
}

備註

  • 一次認證嘗試失敗，或已有會話被渠道置為失效。provider 給出原因時，data.last_error 是機器可讀的錯誤值；向使用者展示失敗後，再發起新的認證流程。