Tài liệu

Nắm TicketsX nhanh hơn

Hướng dẫn thiết lập, toàn bộ danh sách lệnh, tính năng Premium và REST API, gom về một chỗ.

13.8

Gửi tin nhắn webhook

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

Gửi vào kênh ticket một tin nhắn theo kiểu webhook. Tiện cho thông báo tự động, cập nhật tình trạng hoặc tin nhắn từ hệ thống khác.

Thân yêu cầu

TênKiểuBắt buộcMô tả
contentstring
tùy chọn
Nội dung tin nhắn ở dạng chữ thường.
embed_titlestring
tùy chọn
Tiêu đề cho tin nhắn nhúng, nếu có dùng.
embed_descriptionstring
tùy chọn
Phần mô tả trong tin nhắn nhúng.
embed_colorstring
tùy chọn
Màu của tin nhắn nhúng, dạng chuỗi thập lục phân hoặc tên màu của Discord.
usernamestring
tùy chọn
Đổi tên hiển thị của webhook.
avatarstring
tùy chọn
Đổi ảnh đại diện của webhook bằng địa chỉ một hình.

Cần ít nhất một trong các trường content, embed_title hoặc embed_description. Các trường còn lại là tùy chọn và nếu bỏ trống thì dùng giá trị mặc định.

Ví dụ về yêu cầu
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
Ví dụ về phản hồi
{
  "success": true,
  "message_id": "1234567890123456789"
}