เอกสาร

เรียนรู้ TicketsX ได้เร็วขึ้น

คู่มือการตั้งค่า รายการคำสั่งทั้งหมด ฟีเจอร์ Premium และ REST API รวมอยู่ที่เดียว

13.8

การส่งข้อความผ่านเว็บฮุก

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

ส่งข้อความแบบเว็บฮุกลงในช่องของทิกเก็ต เหมาะกับการแจ้งอัตโนมัติ การอัปเดตสถานะ หรือข้อความจากระบบอื่น

เนื้อหาคำขอ

ชื่อ	ชนิด	จำเป็น	คำอธิบาย
content	string	ไม่บังคับ	เนื้อหาข้อความแบบข้อความธรรมดา
embed_title	string	ไม่บังคับ	หัวเรื่องของข้อความฝัง หากต้องการใช้
embed_description	string	ไม่บังคับ	ส่วนคำอธิบายของข้อความฝัง
embed_color	string	ไม่บังคับ	สีของข้อความฝัง เป็นสตริงฐานสิบหกหรือชื่อสีของ Discord
username	string	ไม่บังคับ	เปลี่ยนชื่อที่เว็บฮุกแสดง
avatar	string	ไม่บังคับ	เปลี่ยนรูปโปรไฟล์ของเว็บฮุกด้วยที่อยู่ของรูปภาพ

ต้องมีอย่างน้อยหนึ่งฟิลด์ในบรรดา 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"
}