スレッドのリストを取得

Customer Experience Insights で会話を一覧表示するときに、1 つ以上の特性でフィルタして結果を絞り込むことができます。選択した会話属性で結果を並べ替えることもできます。

並べ替え

ListConversations API から返される会話は、リクエストの order_by フィールドで次のいずれかの値を渡すことで、その値に基づいて並べ替えることができます。

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

デフォルトの並べ替え順序は昇順ですが、asc または desc を指定して並べ替え順序を設定できます。

フィルタリング

会話は、[会話のフィルタリング] ページに記載されている 1 つ以上の特性に基づいてフィルタできます。

エージェント ID

特定のエージェント ID によって処理された会話をフィルタします。サポートされている演算子は等価演算子のみです。

REST

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • AGENT_ID: エージェント ID。

HTTP メソッドと URL:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "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 の会話

Dialogflow 会話リソース名にマッピングされる会話をフィルタします。サポートされている演算子は等号のみです。このフィルタは、Dialogflow で会話を作成し、Dialogflow ランタイム統合を有効にして、Customer Experience Insights のどの会話が Dialogflow のどの会話に対応しているかを確認する場合に便利です。

REST

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • DIALOGFLOW_CONVERSATION: Dialogflow の会話リソース名。形式は projects/{project}/locations/{location}/conversations/{conversation} です。

HTTP メソッドと URL:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "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 会話プロファイル ID

Dialogflow 会話プロファイル ID にマッピングされる会話をフィルタします。サポートされている演算子は等価演算子のみです。このフィルタは、Dialogflow 会話プロファイルを構成して Dialogflow で会話を作成し、Dialogflow ランタイム統合を有効にして、Customer Experience Insights のどの会話が特定の Dialogflow 会話プロファイルで作成された会話にマッピングされるかを確認する場合に役立ちます。

REST

リクエストのデータを使用する前に、次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • DIALOGFLOW_CONVERSATION_PROFILE_ID: Dialogflow 会話プロファイル ID。これは ID のみであり、リソースパスではありません。

HTTP メソッドと URL:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

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