13.18
Lấy một bản ghi
/<guild_id>/api/transcripts/<ticket_id>Lấy theo số ticket toàn bộ bản ghi của một ticket đã đóng: đầy đủ dữ liệu mô tả (người mở, bảng, đánh giá, lý do đóng, những người đã nhận, các mốc thời gian), mọi tin nhắn theo thứ tự thời gian và số liệu tin nhắn cho từng người tham gia. Hãy tìm ticket trước bằng **Tìm trong bản ghi**, hoặc lấy kho lưu đã dựng sẵn bằng **Lấy bản ghi dạng HTML**. Cần quyền `view_transcripts` (mặc định tắt).
Tham số truy vấn
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| limit | number | tùy chọn | Số tin nhắn mỗi trang, 1-1000 (mặc định 500). |
| offset | number | tùy chọn | Số tin nhắn bỏ qua khi phân trang (mặc định 0). |
Nội dung của messages và participants lấy từ chỉ mục bản ghi, vốn được dựng trong lúc máy chủ có Premium và được bổ sung cho cả kho cũ của bạn ở lần nâng cấp đầu tiên. Ticket đóng trước lúc nâng cấp (hoặc trong khi việc bổ sung chỉ mục còn đang chạy) sẽ trả về indexed: false cùng mảng messages rỗng. Với những ticket đó, hãy dùng Lấy bản ghi dạng HTML hoặc transcript.TranscriptUrl. Ticket dài thì lật trang bằng đối tượng pagination.
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 }
}