Τεκμηρίωση

Μάθε το 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
προαιρετικό
Αλλάζει την εικόνα του 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"
}