# Récupérer les conversations de l'Assistant (/fr/api/analytics/assistant-conversations)
Related: [Obtenir des retours](/fr/api/analytics/feedback.md), [Récupérer les statistiques d'appels de l'Assistant](/fr/api/analytics/assistant-caller-stats.md)
## Utilisation [#utilisation]
Utilisez cet endpoint pour exporter l’historique des conversations de l’Assistant IA à partir de votre documentation. Chaque conversation inclut la requête de l’utilisateur, la réponse de l’Assistant IA, les sources citées, le statut de résolution et la catégorie de la requête.
Parcourez les résultats à l’aide du paramètre `cursor` renvoyé dans la réponse. Continuez à récupérer les données tant que `hasMore` vaut `true`.
## Filtrage [#filtrage]
Filtrez les conversations par plage de dates à l'aide des paramètres `dateFrom` et `dateTo`.
## Données de conversation [#données-de-conversation]
Chaque conversation comprend :
* **query** : la question de l’utilisateur
* **response** : la réponse de l’Assistant
* **sources** : les pages référencées dans la réponse, avec leur title et leur URL
* **resolutionStatus** : indique si l’Assistant a répondu correctement à la question. La valeur est `answered` ou `unanswered`. Utilisez ce champ pour suivre et analyser les lacunes de la documentation mises en évidence par les questions des utilisateurs auxquelles l’Assistant n’a pas pu répondre.
* **queryCategory** : la classification du type de requête (si disponible)
* **pageUrl** : URL complète de la page de documentation où la conversation a démarré, ou `null` si aucun chemin de page n'est disponible. Utilisez ce champ pour attribuer les conversations à une page spécifique.
## Limites de débit [#limites-de-débit]
Cet endpoint autorise 100 requêtes par organisation et par heure. Tous les endpoints d'analytics partagent cette limite.
`GET /v1/analytics/{projectId}/assistant`
Renvoie l’historique de conversation paginé de l’Assistant IA
Authentifiez-vous avec une clé d'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": "Date au format ISO 8601 ou AAAA-MM-JJ",
"example": "2024-01-01"
},
"required": false,
"name": "dateFrom",
"in": "query"
},
{
"schema": {
"type": "string",
"description": "Date au format ISO 8601 ou AAAA-MM-JJ. `dateTo` est une borne supérieure exclusive. Les résultats incluent les dates antérieures, mais pas la date spécifiée.",
"example": "2024-01-01"
},
"required": false,
"name": "dateTo",
"in": "query"
},
{
"schema": {
"type": "number",
"minimum": 1,
"maximum": 1000,
"default": 100,
"description": "Nombre maximal de résultats par page"
},
"required": false,
"name": "limit",
"in": "query"
},
{
"schema": {
"type": "string",
"format": "ulid",
"description": "Curseur de pagination (format ULID)"
},
"required": false,
"name": "cursor",
"in": "query"
}
],
"responses": {
"200": {
"description": "Données de conversation paginées",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"conversations": {
"type": "array",
"description": "Liste des conversations de l’Assistant.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Identifiant unique de la conversation."
},
"timestamp": {
"type": "string",
"description": "Horodatage de la conversation."
},
"query": {
"type": "string",
"description": "La question de l’utilisateur adressée à l’Assistant."
},
"response": {
"type": "string",
"description": "La réponse générée par l’Assistant."
},
"sources": {
"type": "array",
"description": "Pages de documentation référencées dans la réponse.",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Titre de la page de documentation référencée."
},
"url": {
"type": "string",
"description": "URL de la page de documentation référencée."
}
},
"required": [
"title",
"url"
]
}
},
"queryCategory": {
"type": [
"string",
"null"
],
"description": "Catégorie de regroupement automatiquement attribuée à la conversation, le cas échéant."
},
"pageUrl": {
"type": [
"string",
"null"
],
"description": "URL complète de la page de documentation où la conversation a démarré. Null si aucun chemin de page n'a été capturé."
}
},
"required": [
"id",
"timestamp",
"query",
"response",
"sources",
"queryCategory",
"pageUrl"
]
}
},
"nextCursor": {
"type": [
"string",
"null"
],
"description": "Curseur de pagination permettant de récupérer la page de résultats suivante. Null s’il n’y a plus de résultats."
},
"hasMore": {
"type": "boolean",
"description": "Indique si des résultats supplémentaires sont disponibles au‑delà de cette page."
}
},
"required": [
"conversations",
"nextCursor",
"hasMore"
]
}
}
}
},
"400": {
"description": "Paramètres de requête invalides",
"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 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"
]
}
}
}
}
}
}
```