# Obtenir un fil de conversation de l'assistant (/fr/api/analytics/assistant-thread)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1845 · updated: 2026-09-23 -->
Related: [Obtenir des retours](/fr/api/analytics/feedback.md), [Obtenir les retours par page](/fr/api/analytics/feedback-by-page.md), [Récupérer les conversations de l'Assistant](/fr/api/analytics/assistant-conversations.md), [Récupérer les statistiques d'appels de l'Assistant](/fr/api/analytics/assistant-caller-stats.md), [Obtenir les requêtes de recherche](/fr/api/analytics/searches.md), [Obtenir les vues de page](/fr/api/analytics/views.md)

<div id="usage">
  ## Utilisation [#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 [#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](/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](/fr/assistant/configure#deflect-to-a-support-link).

## Limites d'utilisation [#limites-dutilisation]

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

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

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.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "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."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    },
    {
      "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": {
            "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"
            ]
          }
        }
      }
    },
    "400": {
      "description": "ID de fil invalide",
      "content": {
        "application/json": {
          "schema": {
            "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"
            ]
          }
        }
      }
    },
    "404": {
      "description": "Fil introuvable",
      "content": {
        "application/json": {
          "schema": {
            "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"
            ]
          }
        }
      }
    },
    "500": {
      "description": "Erreur du serveur",
      "content": {
        "application/json": {
          "schema": {
            "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"
            ]
          }
        }
      }
    }
  }
}
```