Unterhaltungen auflisten

Wenn Sie Konversationen in Customer Experience Insights auflisten, können Sie sie nach einem oder mehreren Merkmalen filtern, um die Ergebnisse einzugrenzen. Sie können die Ergebnisse auch nach bestimmten Attributen sortieren.

Wird sortiert

Von der ListConversations API zurückgegebene Unterhaltungen können nach einem der folgenden Werte sortiert werden. Dazu muss der entsprechende Wert im Feld order_by der Anfrage übergeben werden:

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

Die Standardsortierreihenfolge ist aufsteigend. Sie kann aber durch Angabe von asc oder desc festgelegt werden.

Filtern

Konversationen können nach einem oder mehreren der auf der Seite Konversationsfilterung aufgeführten Merkmale gefiltert werden.

Agent-ID

Unterhaltungen filtern, die von einer bestimmten Kundenservicemitarbeiter-ID bearbeitet werden. Der einzige unterstützte Operator ist der Gleichheitsoperator.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Projekt-ID in Google Cloud .
  • AGENT_ID: die Agent-ID.

HTTP-Methode und URL: 

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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",
      ...
    },
  ]
}

Dialogflow-Unterhaltung

Unterhaltungen filtern, die einem Dialogflow-Unterhaltungsressourcennamen zugeordnet sind. Der einzige unterstützte Operator ist „Gleichheit“. Dieser Filter ist hilfreich, wenn Sie Unterhaltungen in Dialogflow erstellen, die Dialogflow-Laufzeitintegration aktivieren und herausfinden möchten, welche Unterhaltungen in Customer Experience Insights welchen Unterhaltungen in Dialogflow zugeordnet sind.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Projekt-ID in Google Cloud .
  • DIALOGFLOW_CONVERSATION: Der Ressourcenname der Dialogflow-Unterhaltung. Das Format dafür ist projects/{project}/locations/{location}/conversations/{conversation}.

HTTP-Methode und URL: 

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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",
        },
      },
      ...
    },
  ]
}

Dialogflow-Unterhaltungsprofil-ID

Filtern Sie Unterhaltungen, die einer Dialogflow-Unterhaltungsprofil-ID zugeordnet sind. Der einzige unterstützte Operator ist der Gleichheitsoperator. Dieser Filter ist hilfreich, wenn Sie Dialogflow-Konversationsprofile konfigurieren, um Konversationen in Dialogflow zu erstellen, die Dialogflow-Laufzeitintegration aktivieren und herausfinden möchten, welche Konversationen in Customer Experience Insights den Konversationen entsprechen, die von einem bestimmten Dialogflow-Konversationsprofil erstellt wurden.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Projekt-ID in Google Cloud .
  • DIALOGFLOW_CONVERSATION_PROFILE_ID: Die ID des Dialogflow-Unterhaltungsprofils. Beachten Sie, dass dies nur die ID und nicht der Ressourcenpfad ist.

HTTP-Methode und URL: 

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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",
      ...
    },
  ]
}