說明文件

更快上手 TicketsX

設定指南、完整指令說明、Premium 功能和 REST API 都在這裡。

13.15

切換工單所屬面板

POST/<guild_id>/api/tickets/<ticket_id>/switch-panel

把工單轉到另一個單一面板。這是 /switchpanel 指令的 API 版本。工單會依新面板的命名規則重新命名,頻道形式的工單還會移到新面板的分類下,新面板的客服團隊也會取得存取權。需要 `switch_panel` 權限(預設關閉)。

請求本文

名稱型別必填說明
panel_idnumber
必填
工單要切換到的單一面板 ID(參見「列出面板」)。
keep_permissionsboolean
選填
在新面板團隊之外,同時保留頻道目前的身分組權限(預設 true)。設為 false 會把身分組存取權重設為只保留新面板的客服團隊。

工單形式必須一致:頻道形式的工單只能切換到頻道形式的面板,討論串形式的工單只能切換到討論串形式的面板。由於切換會重新命名頻道,Discord 把這項操作限制在每 10 分鐘約兩次;本端點與之一致,超出時會回傳 429 並帶上 retry_after

請求範例
curl -X POST \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"panel_id":2,"keep_permissions":true}' \
  https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/switch-panel
回應範例
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}