Obtener detalles del ticket

Proporciona la capacidad de consultar y recuperar los detalles de un ticket mediante su ID.

Método de solicitud

GET

URL de la solicitud

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

Autenticación

Para obtener más información, consulta la descripción del método de autenticación en Información general de la API.

Solicitud

Ejemplo de solicitud

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

            
Este bloque de código se muestra en una ventana flotante

Parámetros de ruta

Field Type Required Description
ticket_id String Yes ID del ticket.

Respuesta

Ejemplo de respuesta

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

            
Este bloque de código se muestra en una ventana flotante

Parámetros de respuesta

Field Type Required Description
ticket_id String Yes ID único del ticket.
title String Yes Título del ticket.
description String Yes Descripción detallada del ticket (admite Markdown).
attachments Array No Lista de archivos adjuntos a nivel de ticket.
file_name String Yes Nombre del archivo.
file_type String Yes Tipo MIME.
file_url String Yes URL del archivo.
file_size String Yes Tamaño del archivo.
status String Yes Estado del ticket: open/in_progress/resolved/closed, etc.
priority String No Prioridad: low/medium/high/urgent.
ticket_type String No Tipo de ticket: incident/question/problem/task.
requester Object Yes Información del solicitante.
euid String No ID único del contacto.
name String No Nombre del contacto.
email String No Correo electrónico del contacto.
phone String No Número de teléfono móvil del contacto.
channel_contacts Object No Asignación de contacto del canal (debe existir al menos uno entre este campo y euid).
channel_id String Yes ID del canal.
contact_id String Yes ID del contacto del canal (por ejemplo, TG chat_id).
sub_contact_id String No ID secundario del contacto del canal (por ejemplo, TG topic_id o Email thread_id).
followers Array No Información de ID de los seguidores utilizada para notificaciones push dentro del canal; incluye los campos id y name.
  • id: ID del seguidor.
  • name: Nombre del seguidor.
  • submitter Object No Miembro interno que envió el ticket.
    id String Yes ID de usuario del remitente.
    assignment_team Object No Información del equipo asignado.
    id Integer Yes ID del equipo.
    name String Yes Nombre del equipo.
    custom_fields Object No Campos personalizados, como el número de serie del dispositivo o el número de pedido.
    device_sn String Yes Número de serie del dispositivo.
    conversation_list Array Yes Historial completo de mensajes dentro del ticket.
    message_id String Yes ID único del mensaje.
    sender Object Yes Información del remitente.
    id String Yes ID del remitente.
    type String Yes Tipo de remitente: internal_member/system/bot.
    name String No Nombre del remitente.
    content String No Contenido de texto del mensaje.
    content_type String Yes Tipo de contenido: text/image/file/audio/video.
    attachments Array No Lista de archivos adjuntos del mensaje.
    file_type String Yes Tipo MIME.
    file_url String Yes URL del archivo.
    sent_at String Yes Hora de envío (ISO 8601).
    is_internal boolean Yes Indica si el mensaje es interno (no visible para los clientes).
    status_changes Array No Registros de cambios de estado del ticket.
    to_status String No Estado después del cambio (open/resolved o un código personalizado).
    changed_at String No Hora del cambio (ISO 8601).
    changed_by_type String No Origen del cambio: user/system/bot.
    changed_by_id String No Se devuelve cuando changed_by_type es user.
    tags Array No Etiquetas del ticket.
    sla Object No Información del SLA (acuerdo de nivel de servicio).
    first_response_due String No Hora límite de la primera respuesta.
    resolution_due String No Hora límite de resolución.
    first_response_at String No Hora real de la primera respuesta.
    breached boolean No Indica si se incumplió el SLA.
    followers Array No Lista de seguidores.
    satisfactions Object No Resultado de la encuesta de satisfacción.
    rating Integer No Valoración de 1 a 5.
    feedback String No Comentarios en texto.
    submitted_at String No Hora de envío.
    created_at String Yes Hora de creación del ticket (ISO 8601).
    updated_at String Yes Hora de la última actualización del ticket.
    resolved_at String No Hora de resolución (null si no se ha resuelto).
    closed_at String No Hora de cierre (null si no está cerrado).
    Icon Solid Transparent White Qiyu
    Contacto