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. |
| 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. |
| 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). |










