Obtenir les détails du ticket

Fournit la fonction de requête et d'obtention des détails d'un ticket à partir de l'ID du ticket.

Méthode de requête

GET

URL de requête

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

Authentification

Consultez la description de l'authentification dans Présentation de l'API pour plus de détails.

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

Champ	Type	Obligatoire	Description
ticket_id	String	Oui	ID du ticket.

Exemple de réponse

{ "code": 0, "message": "Succès", "data": { "ticket_id": "tk_20251104_789abc", "title": "Bourrage papier imprimante, impossible d'imprimer", "description": "Le client signale un bourrage de papier A4 au niveau du bac de sortie, nécessite une intervention urgente.", "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": "Support informatique" }, "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": "Nous avons bien reçu votre retour et sommes en cours de traitement.", "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": ["imprimante", "matériel"], "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": "Traitement très rapide", "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": "Succès",
  "data": {
    "ticket_id": "tk_20251104_789abc",
    "title": "Bourrage papier imprimante, impossible d'imprimer",
    "description": "Le client signale un bourrage de papier A4 au niveau du bac de sortie, nécessite une intervention urgente.",
    "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": "Support informatique"
    },
    "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": "Nous avons bien reçu votre retour et sommes en cours de traitement.",
        "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": ["imprimante", "matériel"],
    "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": "Traitement très rapide",
      "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

Champ	Type	Obligatoire	Description
ticket_id	String	Oui	ID unique du ticket.
title	String	Oui	Titre du ticket.
description	String	Oui	Description détaillée du ticket (prend en charge le Markdown).
attachments	Array	Non	Liste des pièces jointes au niveau du ticket.
file_name	String	Oui	Nom du fichier.
file_type	String	Oui	Type MIME.
file_url	String	Oui	Adresse du fichier.
file_size	String	Oui	Taille.
status	String	Oui	Statut du ticket : open/in_progress/resolved/closed, etc.
priority	String	Non	Priorité : low/medium/high/urgent.
ticket_type	String	Non	Type de ticket : incident/question/problem/task.
requester	Object	Oui	Informations sur le demandeur.
euid	String	Non	ID unique du contact.
name	String	Non	Nom du contact.
email	String	Non	Email du contact.
phone	String	Non	Numéro de téléphone du contact.
channel_contacts	Object	Non	Correspondance des contacts du canal (au moins un avec euid existe).
channel_id	String	Oui	ID du canal.
contact_id	String	Oui	ID du contact du canal (ex : TG chat_id).
sub_contact_id	String	Non	ID du sous-contact du canal (ex : TG topic_id / Email thread_id).
followers	Array	Non	Informations sur les abonnés (pour notification/push dans le canal), incluant les champs id et name. id : ID de l'abonné. name : Nom de l'abonné.
submitter	Object	Non	Membre interne ayant soumis le ticket.
id	String	Oui	ID utilisateur du soumissionnaire.
assignment_team	Object	Non	Informations sur l'équipe assignée.
id	Integer	Oui	ID de l'équipe.
name	String	Oui	Nom de l'équipe.
custom_fields	Object	Non	Champs personnalisés (ex : numéro de série de l'appareil, numéro de commande, etc.).
device_sn	String	Oui	Numéro de série de l'appareil.
conversation_list	Array	Oui	Historique complet des messages du ticket.
message_id	String	Oui	ID unique du message.
sender	Object	Oui	Informations sur l'expéditeur.
id	String	Oui	ID de l'expéditeur.
type	String	Oui	Type d'expéditeur : internal_member/system/bot.
name	String	Non	Nom de l'expéditeur.
content	String	Non	Contenu textuel du message.
content_type	String	Oui	Type de contenu : text/image/file/audio/video.
attachments	Array	Non	Liste des pièces jointes du message.
file_type	String	Oui	Type MIME.
file_url	String	Oui	Adresse du fichier.
sent_at	String	Oui	Date d'envoi (ISO8601).
is_internal	boolean	Oui	Indique s'il s'agit d'un message interne (invisible pour les clients).
status_changes	Array	Non	Historique des changements de statut du ticket.
to_status	String	Non	Statut après changement (open/resolved ou code personnalisé).
changed_at	String	Non	Date du changement (ISO8601).
changed_by_type	String	Non	Source du changement : user/system/bot.
changed_by_id	String	Non	Renvoyé si changed_by_type est user.
tags	Array	Non	Étiquettes du ticket.
sla	Object	Non	Informations sur l'accord de niveau de service (SLA).
first_response_due	String	Non	Date limite de première réponse.
resolution_due	String	Non	Date limite de résolution.
first_response_at	String	Non	Heure réelle de la première réponse.
breached	boolean	Non	Indique si la SLA a été dépassée.
followers	Array	Non	Liste des abonnés.
satisfactions	Object	Non	Résultat de l'enquête de satisfaction.
rating	Integer	Non	Note de 1 à 5.
feedback	String	Non	Retour textuel.
submitted_at	String	Non	Date de soumission.
created_at	String	Oui	Date de création du ticket (ISO8601).
updated_at	String	Oui	Date de dernière mise à jour du ticket.
resolved_at	String	Non	Date de résolution (null si non résolu).
closed_at	String	Non	Date de clôture (null si non clôturé).