Logo Site EngageLab Mark Colored TransparentDokumentation
Suchen

Ticket-Details abrufen

Ermöglicht die Abfrage und den Abruf von Ticket-Details anhand der Ticket-ID.

Anfragemethode

GET

Anfrage-URL

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

Authentifizierung

Ausführliche Informationen finden Sie in der Beschreibung der Authentifizierungsmethode unter API Overview.

Anfrage

Anfragebeispiel

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

Field Type Required Description
ticket_id String Yes Ticket-ID.

Antwort

Antwortbeispiel

{ "code": 0, "message": "Success", "data": { "ticket_id": "tk_20251104_789abc", "title": "打印机卡纸,无法打印", "description": "客户反映A4纸卡在出纸口,急需处理。", "attachments": [ { "file_url": "https://example.com/files/error.jpg" } ], "status": "open", "priority": "high", "ticket_type": "incident", "requester": { "euid": "contact_12345", "name": "张三", "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支持" }, "custom_fields": { "device_sn": "PRN-2024-001" }, "conversation_list": [ { "message_id": "msg_20251104_001", "sender": { "id": "u_12345", "type": "internal_member", "name": "客服小李" }, "content": "我们已收到你的反馈,正在处理。", "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": ["printer", "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": "处理很快", "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": "打印机卡纸,无法打印",
    "description": "客户反映A4纸卡在出纸口,急需处理。",
    "attachments": [
      {
        "file_url": "https://example.com/files/error.jpg"
      }
    ],
    "status": "open",
    "priority": "high",
    "ticket_type": "incident",
    "requester": {
      "euid": "contact_12345",
      "name": "张三",
      "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支持"
    },
    "custom_fields": {
      "device_sn": "PRN-2024-001"
    },
    "conversation_list": [
      {
        "message_id": "msg_20251104_001",
        "sender": {
          "id": "u_12345",
          "type": "internal_member",
          "name": "客服小李"
        },
        "content": "我们已收到你的反馈,正在处理。",
        "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": ["printer", "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": "处理很快",
      "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

Field Type Required Description
ticket_id String Yes Eindeutige Ticket-ID.
title String Yes Ticket-Titel.
description String Yes Detaillierte Ticket-Beschreibung (unterstützt Markdown).
attachments Array No Liste der Anhänge auf Ticket-Ebene.
file_name String Yes Dateiname.
file_type String Yes MIME-Typ.
file_url String Yes Datei-URL.
file_size String Yes Dateigröße.
status String Yes Ticket-Status: open/in_progress/resolved/closed usw.
priority String No Priorität: low/medium/high/urgent.
ticket_type String No Ticket-Typ: incident/question/problem/task.
requester Object Yes Informationen zum Anfragenden.
euid String No Eindeutige Kontakt-ID.
name String No Name des Kontakts.
email String No E-Mail-Adresse des Kontakts.
phone String No Mobiltelefonnummer des Kontakts.
channel_contacts Object No Zuordnung der Kanalkontakte (mindestens eines dieser Felder oder euid muss vorhanden sein).
channel_id String Yes Kanal-ID.
contact_id String Yes Kanalkontakt-ID (z. B. TG chat_id).
sub_contact_id String No Unterkontakt-ID des Kanals (z. B. TG topic_id oder E-Mail thread_id).
followers Array No Informationen zu Follower-IDs für Push-Benachrichtigungen im Kanal, einschließlich der Felder id und name.
  • id: Follower-ID.
  • name: Follower-Name.
  • submitter Object No Internes Mitglied, das das Ticket eingereicht hat.
    id String Yes Benutzer-ID des Einreichenden.
    assignment_team Object No Informationen zum zugewiesenen Team.
    id Integer Yes Team-ID.
    name String Yes Teamname.
    custom_fields Object No Benutzerdefinierte Felder, z. B. Geräte-Seriennummer oder Bestellnummer.
    device_sn String Yes Geräte-Seriennummer.
    conversation_list Array Yes Vollständiger Nachrichtenverlauf innerhalb des Tickets.
    message_id String Yes Eindeutige Nachrichten-ID.
    sender Object Yes Informationen zum Absender.
    id String Yes Absender-ID.
    type String Yes Absendertyp: internal_member/system/bot.
    name String No Absendername.
    content String No Textinhalt der Nachricht.
    content_type String Yes Inhaltstyp: text/image/file/audio/video.
    attachments Array No Liste der Nachrichtenanhänge.
    file_type String Yes MIME-Typ.
    file_url String Yes Datei-URL.
    sent_at String Yes Sendezeit (ISO 8601).
    is_internal boolean Yes Gibt an, ob die Nachricht intern ist (für Kunden nicht sichtbar).
    status_changes Array No Änderungsprotokolle des Ticket-Status.
    to_status String No Status nach der Änderung (open/resolved oder ein benutzerdefinierter Code).
    changed_at String No Zeitpunkt der Änderung (ISO 8601).
    changed_by_type String No Quelle der Änderung: user/system/bot.
    changed_by_id String No Wird zurückgegeben, wenn changed_by_type user ist.
    tags Array No Ticket-Tags.
    sla Object No SLA-Informationen (Service-Level-Agreement).
    first_response_due String No Fälligkeitszeitpunkt für die erste Antwort.
    resolution_due String No Fälligkeitszeitpunkt für die Lösung.
    first_response_at String No Tatsächlicher Zeitpunkt der ersten Antwort.
    breached boolean No Gibt an, ob das SLA verletzt wurde.
    followers Array No Follower-Liste.
    satisfactions Object No Ergebnis der Zufriedenheitsumfrage.
    rating Integer No Bewertung von 1 bis 5.
    feedback String No Text-Feedback.
    submitted_at String No Zeitpunkt der Übermittlung.
    created_at String Yes Erstellungszeitpunkt des Tickets (ISO 8601).
    updated_at String Yes Zeitpunkt der letzten Aktualisierung des Tickets.
    resolved_at String No Zeitpunkt der Lösung (null, wenn ungelöst).
    closed_at String No Zeitpunkt des Schließens (null, wenn nicht geschlossen).
    Icon Solid Transparent White Qiyu
    Vertrieb kontaktieren