# Obtener hilo de conversación del assistant (/es/api/analytics/assistant-thread)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1829 · updated: 2026-09-23 -->
Related: [Obtener comentarios](/es/api/analytics/feedback.md), [Obtener comentarios por página](/es/api/analytics/feedback-by-page.md), [Obtener conversaciones del assistant](/es/api/analytics/assistant-conversations.md), [Obtener estadísticas de llamadas del assistant](/es/api/analytics/assistant-caller-stats.md), [Obtener consultas de búsqueda](/es/api/analytics/searches.md), [Obtener vistas de página](/es/api/analytics/views.md)

<div id="usage">
  ## Uso [#uso]
</div>

Usa este endpoint para obtener la transcripción completa de mensajes de una única conversación del assistant en formato JSON. La respuesta incluye la lista ordenada de mensajes del usuario y del assistant, cada uno con un ID, rol, contenido y marca de tiempo.

Usos comunes:

* Adjuntar la transcripción de la conversación a un ticket de soporte cuando un usuario contacta desde el assistant.
* Reconstruir una conversación específica para revisión, control de calidad o análisis fuera de línea.

<div id="getting-a-thread-id">
  ## Obtener un thread ID [#obtener-un-thread-id]
</div>

Puedes obtener un `threadId` desde cualquiera de las siguientes fuentes:

* El campo `id` de cualquier fila devuelta por [Obtener conversaciones del assistant](/es/api/analytics/assistant-conversations).
* El parámetro de consulta `threadId` que Mintlify añade a la URL de soporte cuando el assistant deriva a tu plataforma de soporte usando la [derivación por enlace](/es/assistant/configure#deflect-to-a-support-link).

## Límites de uso [#límites-de-uso]

Este endpoint permite 100 solicitudes por organización por hora. Todos los endpoints de analytics comparten este límite.

`GET /v1/analytics/{projectId}/assistant/threads/{threadId}`

Devuelve la transcripción completa de mensajes para un único hilo de conversación del assistant. El ID del hilo está disponible desde el endpoint de conversaciones del assistant, o como parámetro de consulta `threadId` añadido a las URL de soporte de derivación por enlace del assistant.

Autentícate con una clave de API de administrador.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "Tu ID de proyecto. Puedes copiarlo desde la página [API keys](https://dashboard.mintlify.com/settings/organization/api-keys) en tu dashboard."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    },
    {
      "schema": {
        "type": "string",
        "format": "ulid",
        "description": "ID del hilo de conversación del assistant (ULID)."
      },
      "required": true,
      "name": "threadId",
      "in": "path"
    }
  ],
  "responses": {
    "200": {
      "description": "La transcripción de la conversación",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "threadId": {
                "type": "string",
                "description": "Identificador del hilo de conversación del assistant (ULID)."
              },
              "createdAt": {
                "type": "string",
                "description": "Marca de tiempo de creación del hilo."
              },
              "messages": {
                "type": "array",
                "description": "Lista ordenada de mensajes intercambiados en el hilo.",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Identificador único del mensaje."
                    },
                    "role": {
                      "type": "string",
                      "enum": [
                        "user",
                        "assistant"
                      ],
                      "description": "Si el mensaje fue enviado por el usuario o por el assistant."
                    },
                    "content": {
                      "type": "string",
                      "description": "Contenido de texto del mensaje."
                    },
                    "createdAt": {
                      "type": "string",
                      "description": "Marca de tiempo de envío del mensaje."
                    }
                  },
                  "required": [
                    "id",
                    "role",
                    "content",
                    "createdAt"
                  ]
                }
              }
            },
            "required": [
              "threadId",
              "createdAt",
              "messages"
            ]
          }
        }
      }
    },
    "400": {
      "description": "ID de hilo no válido",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de error que describe lo que salió mal."
              },
              "details": {
                "type": "array",
                "description": "Detalles adicionales del error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Descripción de un error específico de validación o procesamiento."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "404": {
      "description": "Hilo no encontrado",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de error que describe lo que salió mal."
              },
              "details": {
                "type": "array",
                "description": "Detalles adicionales del error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Descripción de un error específico de validación o procesamiento."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "500": {
      "description": "Error del servidor",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de error que describe lo que salió mal."
              },
              "details": {
                "type": "array",
                "description": "Detalles adicionales del error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Descripción de un error específico de validación o procesamiento."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    }
  }
}
```