Premiers pasConversationsTopics

Obtenir les sujets de conversation de l'agent

Renvoie les résultats de la dernière exécution de découverte de sujets pour un agent donné.

Paramètres de chemin

agent_idstringRequis

ID de l’agent

En-têtes

xi-api-keystringOptionnel

Paramètres de requête

page_sizeintegerOptionnel1-100

Nombre de groupes de sujets de premier niveau à renvoyer.

sort_byenumOptionnel

Colonne selon laquelle classer les sujets. Utilisez conversations pour le volume, sentiment avec sort_direction=asc pour les sujets les plus négatifs, et frustration avec sort_direction=desc pour les plus frustrants. Les sujets sans score sont toujours classés en dernier.

Valeurs autorisées:
sort_directionenumOptionnel
Sens de tri des sujets.
Valeurs autorisées:
from_unix_secsintegerOptionnel
Début de la fenêtre pour laquelle afficher les sujets. Lorsqu’il est défini avec to_unix_secs, les exécutions quotidiennes terminées de découverte de sujets comprises dans la plage sont agrégées ; la fenêtre délimite donc les métriques ainsi que l’ensemble de sujets. La valeur est arrondie au début de son jour UTC, car les exécutions couvrent des journées UTC entières ; aggregated_run_count indique le nombre d’exécutions additionnées. Omettez les deux bornes pour obtenir uniquement la dernière exécution.
to_unix_secsintegerOptionnel

Fin de la période pour laquelle afficher les sujets.

include_evaluation_criteriabooleanOptionnelPar défaut true

Inclut le détail de l’évaluation par critère dans les métriques de chaque sujet. Transmettez false pour l’omettre : il représente l’essentiel de la charge utile, et le success_rate pondéré est renvoyé dans les deux cas.

cursorstringOptionnel

Utilisé pour récupérer la page suivante. Le curseur est renvoyé dans la réponse.

Réponse

Réponse réussie

topicslist of objects
window_start_unix_secsinteger
window_end_unix_secsinteger
aggregated_run_countintegerOptionnelPar défaut 0

Nombre d’exécutions quotidiennes de découverte de sujets sur lesquelles les métriques renvoyées ont été cumulées.

has_morebooleanOptionnelPar défaut false
next_cursorstringOptionnel

Erreurs

422
Topics Get Request Unprocessable Entity Error