대표적인 가용성 API 사용

대표 가용성 API를 사용하여 Dynamics 365 Contact Center의 대기열 및 고객 서비스 담당자의 가용성 정보를 검색합니다.

다음과 같은 시나리오에서 이러한 API를 사용할 수 있습니다.

  • AI 에이전트가 서비스 담당자를 사용할 수 있는 경우에만 진행 중인 대화를 해당 큐로 에스컬레이션해야 하는 경우
  • 고객이 큐가 운영 시간 내에 있거나 사용 가능한 담당자가 있는 경우에만 대화를 시작하려고 합니다.

대표 가용성 API는 음성, 라이브 채팅 및 디지털 메시징을 비롯한 모든 채널에 적용됩니다.

Prerequisites

  • 옴니채널 관리자 역할이 할당되었습니다.

API 권한 부여를 위한 토큰 설정

대표적인 가용성 API를 사용하려면 액세스 토큰을 생성해야 합니다. 이 토큰은 애플리케이션의 ID를 인증하고 특정 서비스 리소스에 액세스하도록 권한을 부여하는 보안 자격 증명 역할을 합니다.

Azure 포털 다음 단계를 수행합니다.

  1. 애플리케이션 등록 또는 Entra ID>앱 등록 이동한 다음 클라이언트 애플리케이션을 선택합니다. 다음 값을 복사합니다.

    • 애플리케이션(클라이언트) ID
    • 디렉터리(테넌트) ID

  2. 앱 등록에서 API 권한> 선택합니다.

  3. API 권한 요청에서 Microsoft API 탭을 선택한 다음, Dynamics CRM을 선택합니다.

  4. 위임된 권한을 선택한 다음 범위를 선택합니다user_impersonation.

  5. 권한 추가를 선택합니다.

  6. 애플리케이션에 대한 클라이언트 암호를 추가합니다.

Important

비밀 값을 즉시 복사하십시오. 이 값은 암호화되며 페이지를 나가면 다시 표시되지 않습니다.

토큰을 생성하려면 다음 요청을 실행합니다 POST . 다음 값을 바꿉다.

가치 Description
tenant-Id 앱의 디렉터리(테넌트) ID 입니다.
client_id Microsoft Entra ID 앱에 할당된 애플리케이션(클라이언트) ID입니다.
client_secret 앱 등록 중에 생성된 비밀 문자열입니다.
resource 요청된 권한을 정의하는 Dynamics 365 환경의 URL입니다. 
 
   curl --request POST \
   --url https://login.windows.net/{tenant-Id}/oauth2/token \
   --header 'Content-Type: multipart/form-data' \

   --header 'User-Agent: insomnia/10.1.0' \
   --cookie 'fpc=ApQqO0OrCftGhsPOawVKHv6SxOiUAgAAHN3YN8OAAAA; x-ms-gateway-slice=estsfd; stsservicecookie=estsfd' \
   --form grant_type=client_credentials \
   --form client_id={ApplicationIdFromAppRegistration} \
   --form 'client_secret={secretSavedInPreviousStep}' \
   --form resource={OrgUrl}

응답은 대표 가용성 API 호출의 권한 부여 헤더에서 전달자 토큰으로 사용할 수 있는 토큰이 포함된 JSON 개체를 반환합니다.

대표 가용성 API

다음과 같은 대표적인 가용성 API를 사용할 수 있습니다.

CCaaS_GetRepresentativeAvailabilityForConversation
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on