대화 나열

Customer Experience Insights에서 대화를 나열할 때 하나 이상의 특성으로 필터링하여 결과를 좁힐 수 있습니다. 선택한 대화 속성을 기준으로 결과를 정렬할 수도 있습니다.

정렬

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를 지정하여 정렬 순서를 설정할 수 있습니다.

필터링

대화 필터링 페이지에 나열된 특성 중 하나 이상을 기준으로 대화를 필터링할 수 있습니다.

에이전트 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",
      ...
    },
  ]
}