Ouvrir la conversation de l'assistant
Savoir si l'assistant est ouvert à l'utilisateur, puis obtenir l'identifiant de sa conversation « Mon assistant ».
1L'assistant est-il ouvert ?
GET https://staging-api.docage.com/Assistant/Status
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…curl "https://staging-api.docage.com/Assistant/Status" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…"using HttpClient client = new();
using HttpRequestMessage request = new(HttpMethod.Get, "https://staging-api.docage.com/Assistant/Status");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
using HttpResponseMessage response = await client.SendAsync(request);
string result = await response.Content.ReadAsStringAsync();
if (!response.IsSuccessStatusCode)
throw new HttpRequestException(result);const response = await fetch("https://staging-api.docage.com/Assistant/Status", {
headers: {
Authorization: `Bearer ${token}`
}
});
const text = await response.text();
if (!response.ok) throw new Error(text);
const result = text ? JSON.parse(text) : null;{ "Enabled": true, "Problem": null }Enabled à false : l'assistant est fermé pour l'organisation de l'utilisateur, Problem le dit. Si l'offre de l'organisation ne le
comprend pas, la route répond 403 (« Le module « Assistant IA » n'est pas accessible à votre organisation. »).
2Ouvrir sa conversation
POST https://staging-api.docage.com/Assistant/Conversation
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…curl -X POST "https://staging-api.docage.com/Assistant/Conversation" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…"using HttpClient client = new();
using HttpRequestMessage request = new(HttpMethod.Post, "https://staging-api.docage.com/Assistant/Conversation");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
using HttpResponseMessage response = await client.SendAsync(request);
string result = await response.Content.ReadAsStringAsync();
if (!response.IsSuccessStatusCode)
throw new HttpRequestException(result);const response = await fetch("https://staging-api.docage.com/Assistant/Conversation", {
method: "POST",
headers: {
Authorization: `Bearer ${token}`
}
});
const text = await response.text();
if (!response.ok) throw new Error(text);
const result = text ? JSON.parse(text) : null;{ "ConversationId": "00000000-0000-4000-8000-000000000701" }La conversation de l'assistant est une par utilisateur : le premier appel la crée, les suivants rendent la même — rouverte si l'utilisateur l'avait fermée. Gardez son identifiant : toutes les étapes suivantes passent par les routes des conversations.
403 : l'assistant n'est pas ouvert à l'utilisateur (« L'assistant n'est pas activé pour votre organisation. »).
La retrouver parmi ses conversations
Une fois créée, elle figure dans les conversations de l'utilisateur, avec le genre 5 :
GET https://staging-api.docage.com/Conversations/Mine
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…curl "https://staging-api.docage.com/Conversations/Mine" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…"using HttpClient client = new();
using HttpRequestMessage request = new(HttpMethod.Get, "https://staging-api.docage.com/Conversations/Mine");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
using HttpResponseMessage response = await client.SendAsync(request);
string result = await response.Content.ReadAsStringAsync();
if (!response.IsSuccessStatusCode)
throw new HttpRequestException(result);const response = await fetch("https://staging-api.docage.com/Conversations/Mine", {
headers: {
Authorization: `Bearer ${token}`
}
});
const text = await response.text();
if (!response.ok) throw new Error(text);
const result = text ? JSON.parse(text) : null;Son état — messages non lus (UnreadCount), participants — se lit par GET https://staging-api.docage.com/Conversations/{id}/Summary.
Les pièges
- Avant le premier appel à
POST https://staging-api.docage.com/Assistant/Conversation, la conversation n'existe pas : ni la liste ni la création d'une conversation ordinaire ne la font naître. - Lisez son état par
GET https://staging-api.docage.com/Conversations/{id}/Summary, la lecture d'une conversation par ses participants. - Suite : Confier une demande et lire la réponse.