說明文件

更快上手 TicketsX

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

13.8

發送 Webhook 訊息

POST/<guild_id>/api/tickets/<ticket_id>/webhook-message

以 Webhook 樣式向工單頻道送出一則訊息。適合張貼自動通知、狀態更新,或來自外部系統的訊息。

請求本文

名稱型別必填說明
contentstring
選填
純文字的訊息內容。
embed_titlestring
選填
選用嵌入訊息的標題。
embed_descriptionstring
選填
嵌入訊息的描述內文。
embed_colorstring
選填
嵌入訊息的顏色,可用十六進位字串或 Discord 顏色名稱。
usernamestring
選填
覆寫 Webhook 顯示的使用者名稱。
avatarstring
選填
用圖片 URL 覆寫 Webhook 的頭像。

contentembed_titleembed_description 三者至少要填一個。其餘欄位都是選填,省略時會採用預設值。

請求範例
curl -X POST \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"content":"Deployment complete","embed_title":"Status Update","embed_description":"v2.4.1 is now live","embed_color":"#5865F2","username":"Deploy Bot"}' \
  https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/webhook-message
回應範例
{
  "success": true,
  "message_id": "1234567890123456789"
}