> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener hilo de conversación del assistant

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

<div id="usage">
  ## 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
</div>

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

* El campo `id` de cualquier fila devuelta por [Obtener conversaciones del assistant](/docs/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](/docs/es/assistant/configure#deflect-to-a-support-link).

## Límites de uso

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


## OpenAPI

````yaml es/analytics.openapi.json GET /v1/analytics/{projectId}/assistant/threads/{threadId}
openapi: 3.1.0
info:
  title: Mintlify Analytics Export API
  version: 1.0.0
  description: API para exportar datos de Analytics de la documentación
servers:
  - url: https://api.mintlify.com
    description: Producción
security: []
paths:
  /v1/analytics/{projectId}/assistant/threads/{threadId}:
    get:
      tags:
        - Analytics
      summary: Obtener un hilo de conversación del assistant
      description: >-
        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.
      parameters:
        - $ref: '#/components/parameters/projectId'
        - 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:
                $ref: '#/components/schemas/AssistantThreadResponse'
        '400':
          description: ID de hilo no válido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsErrorResponse'
        '404':
          description: Hilo no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsErrorResponse'
        '500':
          description: Error del servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsErrorResponse'
      security:
        - bearerAuth: []
components:
  parameters:
    projectId:
      schema:
        $ref: '#/components/schemas/projectId'
      required: true
      name: projectId
      in: path
  schemas:
    AssistantThreadResponse:
      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
    AnalyticsErrorResponse:
      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
    projectId:
      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.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        El encabezado Authorization requiere un token de tipo Bearer. Usa una
        clave de API de administrador. Esta es una clave secreta del lado del
        servidor. Genera una en la [página de claves de
        API](https://dashboard.mintlify.com/settings/organization/api-keys) de
        tu dashboard.

````

## Related topics

- [Configurar el assistant](/docs/es/assistant/configure.md)
- [Obtener estadísticas de llamadas del assistant](/docs/es/api/analytics/assistant-caller-stats.md)
- [Assistant](/docs/es/assistant/index.md)