Lire les conversations
Lister les sessions d'un canal API et consulter leurs résumés et messages.
Lire les conversations
Utilisez le session_id renvoyé par POST /execute pour consulter une conversation. Ces routes ne permettent pas d'envoyer des messages. Pour démarrer une session, envoyer un message ou répondre à un nœud Question, utilisez /execute.
Chaque requête nécessite Authorization: Bearer <clé> pour le même canal API. Une session appartenant à un autre canal ou locataire retourne 404. Les requêtes GET ne nécessitent pas de signature HMAC. Une clé publique nx_pub_ peut lire une session connue, mais pas lister les sessions.
Lister les sessions
GET /public/v1/api/conversations nécessite une clé serveur (nx_live_ ou nx_test_). Une clé publique reçoit 403 server_key_required.
| Paramètre | Défaut | Contrainte |
|---|---|---|
limit | 50 | De 1 à 500 |
offset | 0 | Supérieur ou égal à 0 |
search | Aucun | 200 caractères au maximum ; recherche dans les messages |
La réponse contient conversations (avec session_id, first_message, last_activity, run_count, status), total, limit et offset. Les sessions sont triées par activité récente.
Résumé d'une session
GET /public/v1/api/conversations/{session_id}/summary retourne session_id, first_message, last_activity, message_count, run_count, channel_id et status.
Dans la liste et le résumé, status décrit la session (completed, waiting_input, active, failed). Il ne correspond pas à l'état d'une exécution renvoyé par /execute (success, error, pending, cancelled).
Historique des messages
GET /public/v1/api/conversations/{session_id}/messages?limit=50 retourne les messages de l'automatisation et du livechat dans l'ordre chronologique. limit va de 1 à 200 ; token_budget vaut 0 par défaut (sans limite). Contrairement à output.messages de /execute, cette route inclut les tours précédents.
La réponse contient session_id, messages, total_messages, total_tokens, mode, livechat_status_message et livechat_conversation_id. Les trois derniers champs peuvent être null ; mode peut valoir bot, livechat_waiting, livechat_active, livechat_closed, livechat_expired, livechat_cancelled ou livechat_unavailable.
Chaque message contient origin (automation ou livechat), role, content, timestamp au format ISO, turn_index commençant à 0, token_count et les champs facultatifs run_id, publication_id, step_id, node_type, tool_calls, tool_call_id, livechat_message_id et sender. Une réponse humaine a origin: "livechat", role: "assistant" et sender: "agent". Le serveur attribue turn_index après avoir fusionné les messages.
Une session inconnue ou appartenant à un autre canal retourne 404 avec l'enveloppe error standard.