Transkript abrufen

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

Ruft anhand der Ticket-ID das komplette Transkript eines geschlossenen Tickets ab: sämtliche Metadaten (Autor, Panel, Bewertung, Schließgrund, Zuständige, Zeitstempel), jede Nachricht in zeitlicher Reihenfolge und Nachrichtenstatistiken je Beteiligtem. Finde das Ticket zuerst über **Transkripte durchsuchen**, oder hol dir das fertige Archiv über **Transkript-HTML abrufen**. Erfordert die Berechtigung `view_transcripts` (standardmäßig aus).

Abfrageparameter

Name	Typ	Pflichtfeld	Beschreibung
limit	number	optional	Nachrichten pro Seite, 1-1000 (Standard 500).
offset	number	optional	Anzahl der zu überspringenden Nachrichten für die Seitennavigation (Standard 0).

Die Inhalte von messages und participants stammen aus dem Transkriptindex, der aufgebaut wird, solange dein Server Premium hat, und beim ersten Upgrade für dein vorhandenes Archiv nachgetragen wird. Ein Ticket, das vor dem Upgrade geschlossen wurde (oder während ein Nachtrag noch läuft), kommt mit indexed: false und einem leeren Array messages zurück. Nutze dafür Transkript-HTML abrufen oder transcript.TranscriptUrl. Mit dem Objekt pagination blätterst du durch lange Tickets.

Beispielanfrage

curl -X GET \
  -H "Authorization: Bearer <API_TOKEN>" \
  "https://api.ticketsx.xyz/<guild_id>/api/transcripts/<ticket_id>?limit=500"

Beispielantwort

{
  "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 }
}