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

# Obtenir un fil de conversation de l'assistant

> Renvoie la transcription complète des messages d'un fil de conversation unique de l'assistant. L'ID du fil est disponible depuis l'endpoint des conversations de l'assistant, ou comme paramètre de requête `threadId` ajouté aux URL de support de redirection par lien de l'assistant.

Authentifiez-vous avec une clé API administrateur.

<div id="usage">
  ## Utilisation
</div>

Utilisez cet endpoint pour récupérer la transcription complète des messages d'une conversation de l'assistant au format JSON. La réponse contient la liste ordonnée des messages de l'utilisateur et de l'assistant, chacun avec un identifiant, un rôle, un contenu et un horodatage.

Cas d'usage courants :

* Joindre la transcription de la conversation à un ticket de support lorsqu'un utilisateur contacte votre équipe depuis l'assistant.
* Reconstituer une conversation spécifique pour révision, contrôle qualité ou analyse hors ligne.

<div id="getting-a-thread-id">
  ## Obtenir un thread ID
</div>

Vous pouvez obtenir un `threadId` depuis l'une des sources suivantes :

* Le champ `id` de n'importe quelle ligne renvoyée par [Obtenir les conversations de l'assistant](/docs/fr/api/analytics/assistant-conversations).
* Le paramètre de requête `threadId` que Mintlify ajoute à l'URL de support lorsque l'assistant redirige vers votre plateforme de support via la [redirection par lien](/docs/fr/assistant/configure#deflect-to-a-support-link).

## Limites d'utilisation

Cet endpoint autorise 100 requêtes par organisation et par heure. Tous les endpoints analytics partagent cette limite.


## OpenAPI

````yaml fr/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 d’exportation des données Analytics de la documentation
servers:
  - url: https://api.mintlify.com
    description: Production
security: []
paths:
  /v1/analytics/{projectId}/assistant/threads/{threadId}:
    get:
      tags:
        - Analytics
      summary: Obtenir un fil de conversation de l'assistant
      description: >-
        Renvoie la transcription complète des messages d'un fil de conversation
        unique de l'assistant. L'ID du fil est disponible depuis l'endpoint des
        conversations de l'assistant, ou comme paramètre de requête `threadId`
        ajouté aux URL de support de redirection par lien de l'assistant.


        Authentifiez-vous avec une clé API administrateur.
      parameters:
        - $ref: '#/components/parameters/projectId'
        - schema:
            type: string
            description: ID du fil de conversation de l'assistant (ULID).
          required: true
          name: threadId
          in: path
      responses:
        '200':
          description: La transcription de la conversation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssistantThreadResponse'
        '400':
          description: ID de fil invalide
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsErrorResponse'
        '404':
          description: Fil introuvable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsErrorResponse'
        '500':
          description: Erreur du serveur
          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: Identifiant du fil de conversation de l'assistant (ULID).
        createdAt:
          type: string
          description: Horodatage de création du fil.
        messages:
          type: array
          description: Liste ordonnée des messages échangés dans le fil.
          items:
            type: object
            properties:
              id:
                type: string
                description: Identifiant unique du message.
              role:
                type: string
                enum:
                  - user
                  - assistant
                description: >-
                  Indique si le message a été envoyé par l'utilisateur ou par
                  l'assistant.
              content:
                type: string
                description: Contenu textuel du message.
              createdAt:
                type: string
                description: Horodatage d'envoi du message.
            required:
              - id
              - role
              - content
              - createdAt
      required:
        - threadId
        - createdAt
        - messages
    AnalyticsErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Message d’erreur décrivant ce qui s’est mal passé.
        details:
          type: array
          description: Détails supplémentaires sur l’erreur.
          items:
            type: object
            properties:
              message:
                type: string
                description: >-
                  Description d’une erreur spécifique de validation ou de
                  traitement.
            required:
              - message
      required:
        - error
    projectId:
      type: string
      description: >-
        ID de votre projet. Vous pouvez le copier depuis la page [API
        keys](https://dashboard.mintlify.com/settings/organization/api-keys) de
        votre Dashboard.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        L'en-tête Authorization requiert un jeton Bearer. Utilisez une clé d'API
        administrateur. Il s'agit d'une clé secrète côté serveur. Générez-en une
        depuis la [page des clés
        d'API](https://dashboard.mintlify.com/settings/organization/api-keys) de
        votre Dashboard.

````

## Related topics

- [Configurer l'assistant](/docs/fr/assistant/configure.md)
- [Récupérer les conversations de l'Assistant](/docs/fr/api/analytics/assistant-conversations.md)
- [Créer un message de l'Assistant](/docs/fr/api/assistant/create-assistant-message-v2.md)