Ticketdetails abrufen

Ermöglicht das Abfragen von Ticketdetails anhand der Ticket-ID.

Anfrage-Methode

GET

Anfrage-URL

https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id

Authentifizierung

Details zur Authentifizierung finden Sie in der Beschreibung unter API-Übersicht.

Anfrage

Beispielanfrage

curl -X GET 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \ -H 'Content-Type: application/json' \ -H 'Authorization: Basic base64(api_key:api_secret)' \

              
              curl -X GET 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \

Diesen Codeblock im schwebenden Fenster anzeigen

Pfadparameter

Feld	Typ	Erforderlich	Beschreibung
ticket_id	String	Ja	Ticket-ID.

Beispielantwort

{ "code": 0, "message": "Success", "data": { "ticket_id": "tk_20251104_789abc", "title": "Papierstau im Drucker, Drucken nicht möglich", "description": "Kund:in meldet, dass A4-Papier im Ausgabefach gestaut ist. Dringende Bearbeitung erforderlich.", "attachments": [ { "file_url": "https://example.com/files/error.jpg" } ], "status": "open", "priority": "high", "ticket_type": "incident", "requester": { "euid": "contact_12345", "name": "Zhang San", "email": "zhangsan@example.com", "phone": "+8613900000000", "channel_contacts": { "channel_id": "inbox_100", "contact_id": "-1001234567890", "sub_contact_id": "23232323", "followers": ["u_12345", "u_67890"] } }, "submitter": { "id": "u_99999" }, "assignment_team": { "id": 5, "name": "IT Support" }, "custom_fields": { "device_sn": "PRN-2024-001" }, "conversation_list": [ { "message_id": "msg_20251104_001", "sender": { "id": "u_12345", "type": "internal_member", "name": "Agent Li" }, "content": "Wir haben Ihr Feedback erhalten und bearbeiten es derzeit.", "content_type": "text", "attachments": [ { "file_type": "image/jpeg", "file_url": "https://example.com/files/progress.jpg" }, { "file_type": "application/pdf", "file_url": "https://example.com/files/report.pdf" } ], "sent_at": "2025-11-19T05:55:25Z", "is_internal": false } ], "status_changes": [ { "to_status": "in_progress", "changed_at": "2025-11-04T09:25:00+08:00", "changed_by_type": "user", "changed_by_id": "u_12345" }, { "to_status": "resolved", "changed_at": "2025-11-04T10:30:00+08:00", "changed_by_type": "system" } ], "tags": ["Drucker", "Hardware"], "sla": { "first_response_due": "2025-11-04T10:00:00+08:00", "resolution_due": "2025-11-05T18:00:00+08:00", "first_response_at": "2025-11-04T09:20:00+08:00", "breached": false }, "followers": [ {"id": "u_12345"}, {"id": "u_67890"} ], "satisfactions": { "rating": 5, "feedback": "Sehr schnelle Bearbeitung", "submitted_at": "2025-11-05T09:20:00+08:00" }, "created_at": "2025-11-04T09:15:22+08:00", "updated_at": "2025-11-04T09:18:45+08:00", "resolved_at": null, "closed_at": null } }

              
              {
  "code": 0,
  "message": "Success",
  "data": {
    "ticket_id": "tk_20251104_789abc",
    "title": "Papierstau im Drucker, Drucken nicht möglich",
    "description": "Kund:in meldet, dass A4-Papier im Ausgabefach gestaut ist. Dringende Bearbeitung erforderlich.",
    "attachments": [
      {
        "file_url": "https://example.com/files/error.jpg"
      }
    ],
    "status": "open",
    "priority": "high",
    "ticket_type": "incident",
    "requester": {
      "euid": "contact_12345",
      "name": "Zhang San",
      "email": "zhangsan@example.com",
      "phone": "+8613900000000",
      "channel_contacts": {
        "channel_id": "inbox_100",
        "contact_id": "-1001234567890",
        "sub_contact_id": "23232323",
        "followers": ["u_12345", "u_67890"]
      }
    },
    "submitter": {
      "id": "u_99999"
    },
    "assignment_team": {
      "id": 5,
      "name": "IT Support"
    },
    "custom_fields": {
      "device_sn": "PRN-2024-001"
    },
    "conversation_list": [
      {
        "message_id": "msg_20251104_001",
        "sender": {
          "id": "u_12345",
          "type": "internal_member",
          "name": "Agent Li"
        },
        "content": "Wir haben Ihr Feedback erhalten und bearbeiten es derzeit.",
        "content_type": "text",
        "attachments": [
          {
            "file_type": "image/jpeg",
            "file_url": "https://example.com/files/progress.jpg"
          },
          {
            "file_type": "application/pdf",
            "file_url": "https://example.com/files/report.pdf"
          }
        ],
        "sent_at": "2025-11-19T05:55:25Z",
        "is_internal": false
      }
    ],
    "status_changes": [
      {
        "to_status": "in_progress",
        "changed_at": "2025-11-04T09:25:00+08:00",
        "changed_by_type": "user",
        "changed_by_id": "u_12345"
      },
      {
        "to_status": "resolved",
        "changed_at": "2025-11-04T10:30:00+08:00",
        "changed_by_type": "system"
      }
    ],
    "tags": ["Drucker", "Hardware"],
    "sla": {
      "first_response_due": "2025-11-04T10:00:00+08:00",
      "resolution_due": "2025-11-05T18:00:00+08:00",
      "first_response_at": "2025-11-04T09:20:00+08:00",
      "breached": false
    },
    "followers": [
      {"id": "u_12345"},
      {"id": "u_67890"}
    ],
    "satisfactions": {
      "rating": 5,
      "feedback": "Sehr schnelle Bearbeitung",
      "submitted_at": "2025-11-05T09:20:00+08:00"
    },
    "created_at": "2025-11-04T09:15:22+08:00",
    "updated_at": "2025-11-04T09:18:45+08:00",
    "resolved_at": null,
    "closed_at": null
  }
}

Diesen Codeblock im schwebenden Fenster anzeigen

Antwortparameter

Feld	Typ	Erforderlich	Beschreibung
ticket_id	String	Ja	Eindeutige Ticket-ID.
title	String	Ja	Ticket-Titel.
description	String	Ja	Ausführliche Ticket-Beschreibung (unterstützt Markdown).
attachments	Array	Nein	Liste der Ticket-Anhänge.
file_name	String	Ja	Dateiname.
file_type	String	Ja	MIME-Typ.
file_url	String	Ja	Dateiadresse.
file_size	String	Ja	Dateigröße.
status	String	Ja	Ticket-Status: open/in_progress/resolved/closed usw.
priority	String	Nein	Priorität: niedrig/mittel/hoch/dringend.
ticket_type	String	Nein	Ticket-Typ: incident/question/problem/task.
requester	Object	Ja	Informationen zur anfragenden Person.
euid	String	Nein	Eindeutige Kontakt-ID.
name	String	Nein	Name des Kontakts.
email	String	Nein	E-Mail-Adresse des Kontakts.
phone	String	Nein	Telefonnummer des Kontakts.
channel_contacts	Object	Nein	Kanal-Kontakt-Zuordnung (mindestens eine EUID vorhanden).
channel_id	String	Ja	Kanal-ID.
contact_id	String	Ja	Kanal-Kontakt-ID (z. B. TG chat_id).
sub_contact_id	String	Nein	Kanal-Subkontakt-ID (z. B. TG topic_id / E-Mail thread_id).
followers	Array	Nein	Follower-IDs (für Push/Benachrichtigung im Kanal), inkl. id und name. id: Follower-ID. name: Follower-Name.
submitter	Object	Nein	Interne:r Mitarbeiter:in, der/die das Ticket eingereicht hat.
id	String	Ja	User-ID des/der Einreichenden.
assignment_team	Object	Nein	Informationen zum zugewiesenen Team.
id	Integer	Ja	Team-ID.
name	String	Ja	Teamname.
custom_fields	Object	Nein	Benutzerdefinierte Felder (z. B. Gerätenummer, Bestellnummer).
device_sn	String	Ja	Gerätenummer.
conversation_list	Array	Ja	Komplette Nachrichtenhistorie des Tickets.
message_id	String	Ja	Eindeutige Nachrichten-ID.
sender	Object	Ja	Informationen zum/zur Absender:in.
id	String	Ja	Absender-ID.
type	String	Ja	Absender-Typ: internal_member/system/bot.
name	String	Nein	Name des/der Absender:in.
content	String	Nein	Nachrichtentext.
content_type	String	Ja	Inhaltstyp: text/image/file/audio/video.
attachments	Array	Nein	Nachrichtenanhänge.
file_type	String	Ja	MIME-Typ.
file_url	String	Ja	Dateiadresse.
sent_at	String	Ja	Sendezeitpunkt (ISO8601).
is_internal	boolean	Ja	Interne Nachricht (nicht für Kund:innen sichtbar).
status_changes	Array	Nein	Ticket-Statusänderungen.
to_status	String	Nein	Status nach Änderung (open/resolved oder benutzerdefiniert).
changed_at	String	Nein	Änderungszeitpunkt (ISO8601).
changed_by_type	String	Nein	Änderungsquelle: user/system/bot.
changed_by_id	String	Nein	Wird zurückgegeben, wenn changed_by_type user ist.
tags	Array	Nein	Ticket-Tags.
sla	Object	Nein	SLA-Service-Level-Agreement-Informationen.
first_response_due	String	Nein	Frist für die erste Reaktion.
resolution_due	String	Nein	Frist zur Lösung.
first_response_at	String	Nein	Tatsächliche Zeit der ersten Reaktion.
breached	boolean	Nein	SLA-Verletzung.
followers	Array	Nein	Follower-Liste.
satisfactions	Object	Nein	Ergebnis der Zufriedenheitsumfrage.
rating	Integer	Nein	Bewertung 1–5.
feedback	String	Nein	Textliches Feedback.
submitted_at	String	Nein	Zeitpunkt der Abgabe.
created_at	String	Ja	Ticket-Erstellungszeitpunkt (ISO8601).
updated_at	String	Ja	Letzte Aktualisierung des Tickets.
resolved_at	String	Nein	Zeitpunkt der Lösung (null, wenn nicht gelöst).
closed_at	String	Nein	Zeitpunkt des Schließens (null, wenn nicht geschlossen).