대화 전 상담사 가용성을 확인하려면 CCaaS_GetRepresentativeAvailabilityBeforeConversation을 사용하세요.

CCaaS_GetRepresentativeAvailabilityBeforeConversation 사용하여 대화가 시작되기 전에 큐 및 서비스 담당자 가용성을 가져옵니다.

예를 들어 서비스 담당자 가용성을 확인하려면 이 API를 호출하여 관련 큐가 운영 시간 내에 있는 경우에만 웹 사이트에 채팅 위젯을 표시합니다.

외부 시스템이 서비스 담당자 가용성을 사전에 쿼리하고 감독자가 큐에 대한 인력 최적화 결정을 내릴 수 있도록 도와야 하는 경우 이 API를 사용합니다.

세부 정보 요청

URL

/\<orgurl\>/api/data/v9.2/CCaaS\_ GetRepresentativeAvailabilityBeforeConversation

메서드

POST

Version

1.0

요청 헤더

이름 설명
승인 필수. Contact Center 인스턴스에서 API 호출자에 대한 Microsoft Entra ID의 전달자 토큰. API 권한 부여를 위한 설치 토큰에 대한 자세한 정보

샘플 요청

시나리오 샘플 코드
단일 기본 큐가 있는 작업 스트림의 서비스 담당자 가용성을 확인합니다. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityBeforeConversation \ --header 'Authorization: Bearer token' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "LiveWorkStreamId": "8a581641-291b-2002-5b86-55e0cfa0fc63" }'
컨텍스트 변수가 경로-큐 규칙에 사용되는 작업 스트림에 대한 관련 큐 가용성을 결정합니다. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityBeforeConversation \ --header 'Authorization: Bearer token' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "LiveWorkStreamId": "cf21df54-6d64-4aea-b668-405b8aa42b07", "CustomContextItems": "{\"contextItem1\": {\"value\": \"contextItemValue1\", \"isDisplayable\": true, \"datatype\": \"DataType1\"}, \"contextItem2\": {\"value\": \"contextItemValue2\", \"isDisplayable\": true, \"datatype\": \"DataType2\"}}" }'
컨텍스트 항목을 추가하거나 재정의합니다. 예를 들어 설문 조사입니다. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityBeforeConversation \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "LiveWorkStreamId": "8a581641-291b-2002-5b86-55e0cfa0fc63", "CustomContextItems": "{\"Survey\": {\"value\": \"India\", \"isDisplayable\": true, \"datatype\": \"192350000\"}}" }'
대화의 참여 컨텍스트 엔티티에 규칙이 있는 경우, 서비스 담당자의 가용성을 결정합니다. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityBeforeConversation \ --header 'Authorization: Bearer token' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "LiveWorkStreamId": "8a581641-291b-2002-5b86-55e0cfa0fc63", "ChannelEngagementContext": "{"msdyn_browser": "Edge",\n "msdyn_city": "florida"\n}"" '
컨텍스트 항목과 계약 컨텍스트 둘 다에 규칙이 있는 경우 서비스 담당자 가용성 확인 curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityBeforeConversation \ --header 'Authorization: Bearer token' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "LiveWorkStreamId": "8a581641-291b-2002-5b86-55e0cfa0fc63", "ChannelEngagementContext": "{"msdyn_browser": "Edge", \n "msdyn_city": "florida"\n}", "CustomContextItems": "{\"contextItem1\": {\n \"value\": \"contextItemValue1\",\n \"isDisplayable\": true,\n \"datatype\": \"DataType1\"\n },\"contextItem12\": {\n \"value\": \"contextItemValue2\",\n \"isDisplayable\": true,\n \"datatype\": \"DataType2\"\n }}" }'

메모

  • 요청 본문 CustomContextItems 에서 경로-큐 규칙에 사용되는 컨텍스트 항목이 있는 문자열입니다. 컨텍스트 항목의 샘플 목록:

    {
  "contextItemName1": {
    "value": "contextItemValue1",
    "isDisplayable": true,
    "datatype": "DataType1"
  },
  "contextItemName2": {
    "value": "contextItemValue2",
    "isDisplayable": true,
    "datatype": "DataType2"
  }
}

  • isDisplayable 는 상황에 맞는 항목이 화면에 표시되는지 나타냅니다. 이 값은 True 또는 False입니다.

  • datatype 텍스트 = 192350000 또는 정수 = 192350001

응답

성공하면 이 메서드는 200 OK 응답 코드를 반환합니다. 이 메서드는 다음 상태 코드도 반환합니다.

HTTP 상태 설명
400 잘못된 요청(잘못된 입력 매개변수)
401 Unauthorized
404 리소스를 찾을 수 없습니다
429 속도 제한 (요청이 너무 많음)
405 API 허용되지 않음
500 내부 서버 오류

응답 값

성공하면 이 메서드는 200 OK 응답 코드를 반환합니다. 이 메서드는 다음 상태 코드도 반환합니다.

HTTP 상태 설명
400 잘못된 요청(잘못된 입력 매개변수)
401 Unauthorized
404 리소스를 찾을 수 없습니다
429 속도 제한 (요청이 너무 많음)
405 API 허용되지 않음
500 내부 서버 오류

응답 값

이름 유형 설명
queueId String 라우팅 규칙 구성 및 라우팅 규칙의 일부인 엔터티 값 및 컨텍스트와 같은 입력 데이터를 기반으로 요청이 라우팅되는 대상 큐입니다.
isQueueAvailable Boolean 큐가 작동 시간 내에 있는 경우 TRUE를 표시합니다. 큐가 작동 시간 외인 경우 FALSE입니다.
다음작업시간의시작시간 날짜/시간 현재 운영 시간이 아닌 경우 큐에 대한 운영 시간의 시작 시간(UTC)입니다. 운영 시간 동안 01-01-0001을 반환합니다.
다음 운영 시간 종료 시각 날짜/시간 현재 운영 시간이 아닌 경우 큐에 대한 운영 시간이 종료되는 시간(UTC)입니다. 운영 시간 동안 01-01-0001을 반환합니다.
다음 전환 시간 날짜/시간 대기열이 운영 시간 외인 경우 다시 작동하는 시간(UTC)입니다. 작동 시간 동안 큐가 비작동 상태가 되는 경우 이를 표시합니다.
positionInQueue Number 동일한 큐에서 다른 사용자 뒤에서 대기 중인 고객을 위해 큐에 배치합니다.
isAgentAvailable Boolean 표시:
  • TRUE이면 큐의 서비스 담당자가 현재 작업 스트림에 대한 라우팅 및 할당 규칙에 따라 요청을 수행할 수 있습니다.
  • 서비스 담당자가 요청을 수행할 수 없는 경우 FALSE입니다.
평균대기시간 Number 대상 큐에 있는 고객의 평균 대기 시간(분)입니다.
평균대기시간(초) 숫자 대상 큐에 있는 고객의 평균 대기 시간(초)입니다.
NumberOfExpertsAvailableInQueue 숫자 현재 대상 큐에서 대화를 수락할 수 있는 서비스 담당자 수입니다.

샘플 응답

{  
"@odata.context": "https://<org-url>/api/data/v9.2/\$metadata#Microsoft.Dynamics.CRM.CCaaS_GetRepresentativeAvailabilityForConversationResponse",  
"NextTransitionTime": "9999-12-31T23:59:59Z",
"NumberOfExpertsAvailableInQueue": 5,
"AverageWaitTimeInSeconds": 45  
"PositionInQueue": 1,  
"AverageWaitTime": null,  
"StartTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"EndTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"QueueId": "85e55877-f27a-e911-a81a-000d3a1ca610",  
"IsAgentAvailable": true,  
"IsQueueAvailable": true  
}

대표적인 가용성 API 사용
CCaaS_GetRepresentativeAvailabilityForConversation

  • Last updated on