Lister les conversations

Lorsque vous listez les conversations dans Insights sur l'expérience client, vous pouvez les filtrer selon une ou plusieurs caractéristiques pour affiner les résultats. Vous pouvez également trier les résultats selon certains attributs de conversation.

Effectuer un tri

Les conversations renvoyées par l'API ListConversations peuvent être triées selon l'une des valeurs suivantes en les transmettant dans le champ order_by de la requête :

  • create_time {asc, desc}
  • customer_satisfaction_rating {asc, desc}
  • duration {asc, desc}
  • latest_analysis {asc, desc}
  • start_time {asc, desc}
  • turn_count {asc, desc}

L'ordre de tri par défaut est croissant, mais vous pouvez le définir en spécifiant asc ou desc.

Filtrage

Vous pouvez filtrer les conversations en fonction d'une ou plusieurs des caractéristiques listées sur la page Filtrage des conversations.

ID de l'agent

Filtrez les conversations traitées par un ID d'agent spécifique. Le seul opérateur accepté est l'égalité.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud .
  • AGENT_ID : ID de l'agent.

Méthode HTTP et URL : 

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=agent_id=\"AGENT_ID\"

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_1",
      "agentId": "AGENT_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_2",
      "agentId": "AGENT_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_3",
      "agentId": "AGENT_ID",
      ...
    },
  ]
}

Conversation Dialogflow

Filtrez les conversations qui correspondent à un nom de ressource de conversation Dialogflow. Le seul opérateur accepté est l'égalité. Ce filtre est utile si vous créez des conversations dans Dialogflow, activez l'intégration de l'environnement d'exécution de Dialogflow et souhaitez savoir quelles conversations dans Customer Experience Insights correspondent à quelles conversations dans Dialogflow.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud .
  • DIALOGFLOW_CONVERSATION : nom de la ressource de conversation Dialogflow. Son format est projects/{project}/locations/{location}/conversations/{conversation}.

Méthode HTTP et URL : 

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=data_source.dialogflow_source.dialogflow_conversation=\"DIALOGFLOW_CONVERSATION\"

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_1",
      "dataSource": {
        "dialogflowSource": {
          "dialogflowConversation": "DIALOGFLOW_CONVERSATION",
        },
      },
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_2",
      "dataSource": {
        "dialogflowSource": {
          "dialogflowConversation": "DIALOGFLOW_CONVERSATION",
        },
      },
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_3",
      "dataSource": {
        "dialogflowSource": {
          "dialogflowConversation": "DIALOGFLOW_CONVERSATION",
        },
      },
      ...
    },
  ]
}

ID du profil de conversation Dialogflow

Filtrez les conversations qui correspondent à un ID de profil de conversation Dialogflow. Le seul opérateur accepté est l'opérateur d'égalité. Ce filtre est utile si vous configurez des profils de conversation Dialogflow pour créer des conversations dans Dialogflow, activez l'intégration de l'environnement d'exécution Dialogflow et souhaitez savoir quelles conversations dans Customer Experience Insights correspondent aux conversations créées par un profil de conversation Dialogflow spécifique.

REST

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre projet Google Cloud .
  • DIALOGFLOW_CONVERSATION_PROFILE_ID : ID du profil de conversation Dialogflow. Notez qu'il s'agit uniquement de l'ID et non du chemin d'accès à la ressource.

Méthode HTTP et URL : 

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=dialogflow_conversation_profile_id=\"DIALOGFLOW_CONVERSATION_PROFILE_ID\"

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_1",
      "dialogflowConversationProfileId": "DIALOGFLOW_CONVERSATION_PROFILE_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_2",
      "dialogflowConversationProfileId": "DIALOGFLOW_CONVERSATION_PROFILE_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_3",
      "dialogflowConversationProfileId": "DIALOGFLOW_CONVERSATION_PROFILE_ID",
      ...
    },
  ]
}