Obtenir les détails du ticket

Permet d'interroger et de récupérer les détails d'un ticket à partir de son ID.

Méthode de requête

GET

URL de requête

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

Authentification

Pour plus de détails, consultez la description de la méthode d'authentification dans la Vue d'ensemble de l'API.

Requête

Exemple de requête

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)' \

            
Afficher ce bloc de code dans la fenêtre flottante

Paramètres de chemin

Field Type Required Description
ticket_id String Yes ID du ticket.

Réponse

Exemple de réponse

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

            
Afficher ce bloc de code dans la fenêtre flottante

Paramètres de réponse

Field Type Required Description
ticket_id String Yes ID unique du ticket.
title String Yes Titre du ticket.
description String Yes Description détaillée du ticket (prise en charge de Markdown).
attachments Array No Liste des pièces jointes au niveau du ticket.
file_name String Yes Nom du fichier.
file_type String Yes Type MIME.
file_url String Yes URL du fichier.
file_size String Yes Taille du fichier.
status String Yes Statut du ticket : open/in_progress/resolved/closed, etc.
priority String No Priorité : low/medium/high/urgent.
ticket_type String No Type de ticket : incident/question/problem/task.
requester Object Yes Informations sur le demandeur.
euid String No ID de contact unique.
name String No Nom du contact.
email String No Adresse e-mail du contact.
phone String No Numéro de mobile du contact.
channel_contacts Object No Mappage des contacts du canal (au moins l'un de ce champ et euid doit exister).
channel_id String Yes ID du canal.
contact_id String Yes ID du contact du canal (par exemple, le chat_id TG).
sub_contact_id String No ID du sous-contact du canal (par exemple, le topic_id TG ou le thread_id d'e-mail).
followers Array No Informations sur les ID des abonnés utilisées pour les notifications push dans le canal, incluant les champs id et name.
  • id : ID de l'abonné.
  • name : Nom de l'abonné.
  • submitter Object No Membre interne ayant soumis le ticket.
    id String Yes ID utilisateur du soumetteur.
    assignment_team Object No Informations sur l'équipe assignée.
    id Integer Yes ID de l'équipe.
    name String Yes Nom de l'équipe.
    custom_fields Object No Champs personnalisés, tels que le numéro de série de l'appareil ou le numéro de commande.
    device_sn String Yes Numéro de série de l'appareil.
    conversation_list Array Yes Historique complet des messages du ticket.
    message_id String Yes ID unique du message.
    sender Object Yes Informations sur l'expéditeur.
    id String Yes ID de l'expéditeur.
    type String Yes Type d'expéditeur : internal_member/system/bot.
    name String No Nom de l'expéditeur.
    content String No Contenu textuel du message.
    content_type String Yes Type de contenu : text/image/file/audio/video.
    attachments Array No Liste des pièces jointes du message.
    file_type String Yes Type MIME.
    file_url String Yes URL du fichier.
    sent_at String Yes Heure d'envoi (ISO 8601).
    is_internal boolean Yes Indique si le message est interne (non visible par les clients).
    status_changes Array No Historique des changements de statut du ticket.
    to_status String No Statut après la modification (open/resolved ou code personnalisé).
    changed_at String No Heure de modification (ISO 8601).
    changed_by_type String No Source de la modification : user/system/bot.
    changed_by_id String No Renvoyé lorsque changed_by_type est user.
    tags Array No Tags du ticket.
    sla Object No Informations SLA (accord de niveau de service).
    first_response_due String No Heure limite de la première réponse.
    resolution_due String No Heure limite de résolution.
    first_response_at String No Heure réelle de la première réponse.
    breached boolean No Indique si le SLA a été violé.
    followers Array No Liste des abonnés.
    satisfactions Object No Résultat de l'enquête de satisfaction.
    rating Integer No Note de 1 à 5.
    feedback String No Retour textuel.
    submitted_at String No Heure de soumission.
    created_at String Yes Heure de création du ticket (ISO 8601).
    updated_at String Yes Heure de la dernière mise à jour du ticket.
    resolved_at String No Heure de résolution (null si non résolu).
    closed_at String No Heure de clôture (null si non clôturé).
    Icon Solid Transparent White Qiyu
    Contactez-nous