Belgeler

TicketsX'i daha hızlı öğren

Kurulum rehberleri, tüm komutlar, Premium özellikleri ve REST API tek yerde.

13.18

Konuşma kaydı getirme

GET/<guild_id>/api/transcripts/<ticket_id>

Kapanmış bir talebin bütün konuşma kaydını talep kimliğiyle getirir: eksiksiz üstveriler (açan kişi, panel, değerlendirme, kapatma gerekçesi, üstlenenler, zaman bilgileri), zaman sırasıyla bütün mesajlar ve katılımcı bazında mesaj istatistikleri. Talebi önce **Konuşma kayıtlarında arama** ile bulun ya da hazır arşivi **Konuşma kaydı HTML'i getirme** ile alın. `view_transcripts` yetkisi gerekir (varsayılan olarak kapalı).

Sorgu parametreleri

AdTürZorunluAçıklama
limitnumber
isteğe bağlı
Sayfa başına mesaj sayısı, 1-1000 (varsayılan 500).
offsetnumber
isteğe bağlı
Sayfalama için atlanacak mesaj sayısı (varsayılan 0).

messages ve participants içerikleri, sunucunuzda Premium varken kurulan ve ilk yükseltmenizde mevcut arşivinize de uygulanan konuşma kaydı dizininden gelir. Yükseltmeden önce (veya dizin doldurma sürerken) kapanmış bir talep indexed: false ve boş bir messages dizisiyle döner. Bunlar için Konuşma kaydı HTML'i getirme uç noktasını ya da transcript.TranscriptUrl alanını kullanın. Uzun talepleri pagination nesnesiyle sayfalayın.

İstek örneği
curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>?limit=500"
Yanıt örneği
{
  "transcript": {
    "TicketId": 42,
    "PanelId": 1,
    "PanelName": "Support",
    "AuthorId": "123456789",
    "AuthorUsername": "jane",
    "Rating": 5,
    "RatingCount": 1,
    "CloseReason": "Resolved",
    "CreatedAt": 1732200000,
    "ClosedAt": 1732210000,
    "ClosedBy": "987654321",
    "ClaimedIds": ["987654321"],
    "TranscriptUrl": "https://tickets.example.com/<guild_id>/transcripts/42"
  },
  "indexed": true,
  "messages": [
    { "MessageId": "111", "AuthorId": "123456789", "AuthorUsername": "jane", "IsBot": false, "Content": "My login is broken", "CreatedAt": 1732200050 },
    { "MessageId": "112", "AuthorId": "987654321", "AuthorUsername": "staff", "IsBot": false, "Content": "Looking into it now!", "CreatedAt": 1732200110 }
  ],
  "participants": [
    { "UserId": "123456789", "Username": "jane", "IsBot": false, "MessageCount": 12, "FirstMessageAt": 1732200050, "LastMessageAt": 1732209900 }
  ],
  "pagination": { "total": 2, "limit": 500, "offset": 0, "returned": 2 }
}