13.8
發送 Webhook 訊息
POST
/<guild_id>/api/tickets/<ticket_id>/webhook-message以 Webhook 樣式向工單頻道送出一則訊息。適合張貼自動通知、狀態更新,或來自外部系統的訊息。
請求本文
| 名稱 | 型別 | 必填 | 說明 |
|---|---|---|---|
| content | string | 選填 | 純文字的訊息內容。 |
| embed_title | string | 選填 | 選用嵌入訊息的標題。 |
| embed_description | string | 選填 | 嵌入訊息的描述內文。 |
| embed_color | string | 選填 | 嵌入訊息的顏色,可用十六進位字串或 Discord 顏色名稱。 |
| username | string | 選填 | 覆寫 Webhook 顯示的使用者名稱。 |
| avatar | string | 選填 | 用圖片 URL 覆寫 Webhook 的頭像。 |
content、embed_title、embed_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"
}