13.18
Konuşma kaydı getirme
/<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
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| limit | number | isteğe bağlı | Sayfa başına mesaj sayısı, 1-1000 (varsayılan 500). |
| offset | number | 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.
curl -X GET \
-H "Authorization: Bearer <API_TOKEN>" \
"https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>?limit=500"{
"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 }
}