CCaaS_GetRepresentativeAvailabilityForConversation

CCaaS_GetRepresentativeAvailabilityForConversation API를 사용하여 유효한 대화 ID를 사용하여 활성 대화 중에 큐 및 서비스 담당자 가용성을 가져옵니다.

예를 들어 IVR 또는 AI 에이전트와 채팅하는 고객이 서비스 담당자에게 에스컬레이션을 요청하는 경우 AI 에이전트는 이 API를 호출하여 서비스 담당자의 가용성을 확인하고 응답에 따라 대화를 라우팅합니다.

세부 정보 요청

URL

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

메서드

POST

Version

1.0

요청 헤더

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

샘플 요청 본문

설명 샘플 요청
활성 대화의 큐 및 대표 가용성을 결정합니다. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "2f2508bd-b58e-4982-b142-651e36dc8df3" }'
큐로 라우팅 규칙에 더 많은 컨텍스트 항목이 필요한 대화의 큐 및 대표 가용성을 결정합니다. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "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_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "ConversationId": "94c002c8-b14e-4a0e-8069-78dcf0d6c208", "CustomContextItems": "{\"Survey\": {\"value\": \"India\", \"isDisplayable\": true, \"datatype\": \"192350000\"}}" }'

메모

  • 요청 본문 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 내부 서버 오류

응답 값

이름 유형 설명
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_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on