Analytics
Obtenir un fil de conversation de l'assistant
Récupère 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 l’assistant lorsque le routage du support utilise le mode Link.
Authentifiez-vous avec une clé API administrateur.
GET
/
v1
/
analytics
/
{projectId}
/
assistant
/
threads
/
{threadId}
Obtenir le fil de conversation de l'assistant
curl --request GET \
--url https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"threadId": "<string>",
"createdAt": "<string>",
"messages": [
{
"id": "<string>",
"role": "user",
"content": "<string>",
"createdAt": "<string>"
}
]
}{
"error": "<string>",
"details": [
{
"message": "<string>"
}
]
}{
"error": "<string>",
"details": [
{
"message": "<string>"
}
]
}{
"error": "<string>",
"details": [
{
"message": "<string>"
}
]
}
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. Mintlify remplace les adresses e-mail et les numéros de téléphone du contenu des messages par
[REDACTED_EMAIL] et [REDACTED_PHONE].
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.
threadId depuis l’une des sources suivantes :
- Le champ
conversationIdde n’importe quelle ligne renvoyée par Obtenir les conversations de l’assistant. - Le paramètre de requête
threadIdque Mintlify ajoute à l’URL de support lorsque l’assistant oriente les utilisateurs vers votre plateforme de support avec l’option de support Lien.
Limites d’utilisation
Cet endpoint autorise 100 requêtes par organisation et par heure. Tous les endpoints analytics partagent cette limite.Autorisations
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 de votre Dashboard.
Paramètres de chemin
ID de votre projet. Vous pouvez le copier depuis la page API keys de votre Dashboard.
⌘I
Obtenir le fil de conversation de l'assistant
curl --request GET \
--url https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mintlify.com/v1/analytics/{projectId}/assistant/threads/{threadId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"threadId": "<string>",
"createdAt": "<string>",
"messages": [
{
"id": "<string>",
"role": "user",
"content": "<string>",
"createdAt": "<string>"
}
]
}{
"error": "<string>",
"details": [
{
"message": "<string>"
}
]
}{
"error": "<string>",
"details": [
{
"message": "<string>"
}
]
}{
"error": "<string>",
"details": [
{
"message": "<string>"
}
]
}