ElevenAgentsConversations

Lister les conversations

Récupère toutes les conversations des agents appartenant à l’utilisateur, avec une option pour les limiter à un agent spécifique.

En-têtes

xi-api-keystringOptionnel

Paramètres de requête

cursorstring or nullOptionnel

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

agent_idstring or nullOptionnel

Agent id (agent_…) or speech engine external id (seng_), resolved to the same underlying resource.

visited_agent_idslist of strings or nullOptionnel

Filtrer les conversations auxquelles l’un de ces agents a participé. Ne peut pas dépasser 50 valeurs.

visited_agent_branch_idslist of strings or nullOptionnel

Filtrer les conversations auxquelles l’une de ces branches d’agent a participé. Ne peut pas dépasser 50 valeurs.

triggered_procedure_idslist of strings or nullOptionnel

Filtrer les conversations dans lesquelles l’une de ces procédures a été déclenchée. Ne peut pas dépasser 50 valeurs.

call_successfulenum or nullOptionnel

Le résultat de l’évaluation de réussite

Valeurs autorisées:
call_start_before_unixinteger or nullOptionnel

Horodatage Unix, en secondes, permettant de filtrer les conversations jusqu’à cette date de début.

call_start_after_unixinteger or nullOptionnel

Horodatage Unix, en secondes, permettant de filtrer les conversations postérieures à cette date de début.

call_duration_min_secsinteger or nullOptionnel

Durée minimale de l’appel en secondes.

call_duration_max_secsinteger or nullOptionnel

Durée maximale de l’appel en secondes.

rating_maxinteger or nullOptionnel1-5

Note globale maximale (1 à 5).

rating_mininteger or nullOptionnel1-5

Note globale minimale (1 à 5).

has_feedback_commentboolean or nullOptionnel
Filtrer les conversations contenant des commentaires d'utilisateurs.
user_idstring or nullOptionnel

Filtrer les conversations par ID de l’utilisateur qui les a initiées.

evaluation_paramslist of strings or nullOptionnel

Filtres d’évaluation. Paramètre répétable. Format : criteria_id:result, où result est success|failure|unknown. Exemple : eval=value_framing:success

data_collection_paramslist of strings or nullOptionnel
Filtres de collecte de données. Paramètre répétable. Format : id:op:value, où op est l'une des valeurs eq|neq|gt|gte|lt|lte|in. Pour in, séparez les valeurs par une barre verticale. Une valeur vide correspond aux conversations où le champ n'a pas été collecté (id:eq:), tandis que neq avec une valeur vide correspond à celles où il l'a été (id:neq:). eq indique une égalité exacte. gt|gte|lt|lte requièrent une valeur numérique.
dynamic_variable_paramslist of strings or nullOptionnel
Filtres de variables dynamiques. Paramètre répétable. Format : name:op:value, où op correspond à eq|neq|gt|gte|lt|lte|in. Pour in, séparez les valeurs par des barres verticales. Une valeur vide correspond aux conversations où la variable n’était pas définie (name:eq:) ; neq avec une valeur vide correspond aux conversations où elle l’était (name:neq:). eq indique une égalité exacte. gt|gte|lt|lte requièrent une valeur numérique. Les noms contenant ':' ne peuvent pas être exprimés.
data_collection_idslist of strings or nullOptionnel

ID des champs de collecte de données à inclure dans chaque résumé de conversation. Paramètre répétable. S’il est omis, data_collection_results n’est pas renvoyé.

evaluation_criteria_idslist of strings or nullOptionnel

ID des critères d’évaluation à inclure dans chaque résumé de conversation. Paramètre répétable. Lorsqu’il est omis, evaluation_criteria_results n’est pas renvoyé.

tool_nameslist of strings or nullOptionnel

Filtrer les conversations par noms d’outils utilisés pendant l’appel.

tool_names_successfullist of strings or nullOptionnel

Filtrer les conversations par noms d’outils ayant généré des appels réussis.

tool_names_erroredlist of strings or nullOptionnel

Filtrer les conversations par noms d’outils ayant généré des appels en erreur.

include_invalid_tool_callsbooleanOptionnelPar défaut false

Inclut également les appels d’outils qui n’ont jamais été exécutés.

main_languageslist of strings or nullOptionnel

Filtrer les conversations par langue principale détectée (code de langue).

page_sizeintegerOptionnel1-100Par défaut 30

Nombre maximal de conversations à renvoyer. Ne peut pas dépasser 100 ; 30 par défaut.

summary_modeenumOptionnelPar défaut exclude

Indique s’il faut inclure les résumés de transcriptions dans la réponse.

Valeurs autorisées:
searchstring or nullOptionnelDeprecated

Recherche en texte intégral ou approximative dans les messages de transcription

conversation_initiation_sourceenum or nullOptionnelPar défaut unknown

Énumération représentant les sources possibles d’initiation d’une conversation.

text_onlyboolean or nullOptionnel
conversation_product_typeenum or nullOptionnel

Limite les résultats à une seule interface du produit de conversation.

Valeurs autorisées:
branch_idstring or nullOptionnel
Filtrer les conversations par ID de branche.
version_idstring or nullOptionnel
Filtrer les conversations par ID de version.
parent_conversation_idstring or nullOptionnel

Filtrer les conversations par ID de conversation parente pour les conversations de sous-agents.

topic_idslist of strings or nullOptionnel

Filtrer les conversations par ID de sujets attribués lors de la découverte de sujets.

exclude_statuseslist of enums or nullOptionnel

Exclut les conversations ayant les statuts indiqués. Utile pour masquer des listes les conversations en cours ou en traitement.

Valeurs autorisées:
tag_idslist of strings or nullOptionnel

Filtrer les conversations par ID de tags de conversation attribués via les points de terminaison conversation-tags.

workflow_node_entered_idstring or nullOptionnel

Filtrer les conversations pour ne renvoyer que celles ayant atteint le nœud indiqué.

termination_reasonslist of strings or nullOptionnel

Filtrer les conversations par leur termination_reason enregistrée (metadata.termination_reason). Répétez le paramètre pour correspondre à l’une de plusieurs valeurs.

guardrail_typeslist of enums or nullOptionnel

Filtrer les conversations dans lesquelles une règle de sécurité de l’un de ces types a été déclenchée (metadata.triggered_guardrails.guardrail_type). Répétez le paramètre pour correspondre à l’une de plusieurs valeurs.

custom_guardrail_nameslist of strings or nullOptionnel
Filtrer les conversations dans lesquelles une règle de sécurité personnalisée portant l'un de ces noms a été déclenchée (metadata.triggered_guardrails.guardrail_name). Seules les règles de sécurité personnalisées possèdent un nom. Répétez le paramètre pour correspondre à l'une de plusieurs valeurs.
sort_directionenumOptionnel

L’ordre de tri des conversations selon l’heure de début de l’appel. Par défaut : décroissant (plus récentes d’abord).

Valeurs autorisées:

Réponse

Réponse réussie

conversationslist of objects
has_moreboolean
next_cursorstring or nullOptionnel

Erreurs

422
Unprocessable Entity Error