CCaaS_CreateProactiveVoiceDelivery API 사용

API를 CCaaS_CreateProactiveVoiceDelivery 사용하여 고객에게 사전 예방적 아웃바운드 음성 통화를 시작하거나 고객이 Proactive Engagement Service를 통해 콜백을 예약하도록 허용할 수 있습니다.

필수 조건

• 이 API를 호출하려면 옴니채널 에이전트 또는 옴니채널 감독자 역할이 있어야 합니다.
• 선제적 참여가 구성됩니다. 자세한 내용은 ' 선제적 참여 구성'에서 확인하세요.

사전 발신 통화 시작

선제적 참여를 통해 조직은 음성 채널을 통해 아웃바운드 커뮤니케이션을 시작하여 고객 상호 작용을 향상시킬 수 있습니다. Customer Insights 여정 또는 를 사용하여 사전 예방적 참여를 구성할 수 있습니다 CCaaS_CreateProactiveVoiceDelivery.

API를 CCaaS_CreateProactiveVoiceDelivery 통해 조직은 Proactive Engagement Service를 통해 고객에게 사전 예방적 아웃바운드 음성 통화를 시작할 수 있습니다. API는 음성 런타임 시스템을 통해 아웃바운드 음성 호출을 트리거합니다. 구성된 다이얼 모드에 따라 즉시(시간 창이 지정되지 않은 경우) 또는 사용자가 제공하는 지정된 시간 창 동안 통화가 이루어집니다.

이 API를 통해 컨택 센터는 관련 정보, 미리 알림 또는 알림을 적시에 고객에게 연락하여 고객 경험을 향상시키는 동시에 운영 효율성을 최적화할 수 있습니다.

요청 정보

• 홈페이지: https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery
• 메서드: POST
• 버전: 1.0
• OData 작업: 작업
• OData 형식: 바인딩되지 않음
• 권한 부여 요청: 필수 항목입니다. API를 호출하는 사용자에 대한 유효한 Azure AD 전달자 토큰을 포함해야 합니다. 이 토큰은 고객 서비스 인스턴스와 동일한 Azure AD 테넌트에서 발급되어야 합니다.

요청 헤더

Windows 개체

샘플 요청

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
    "orderNumber": "ORD123456789",
    "type": "callback",
    "isFinalAttempt": "false"
  }
}

응답 세부 정보

성공하면 이 메서드는 를 반환합니다 DeliveryId. 게재 ID는 API를 통해 수락되고 msdyn_proactive_delivery 테이블에 저장되는 각 사전 적극적 참여 요청에 할당된 고유 식별자입니다.

샘플 응답은 다음과 같습니다.

{
	"@odata.context": "[Organization URI]api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.CCaaS_CreateProactiveVoiceDeliveryResponse",
	"DeliveryId": "9838deee-0b4e-4116-bf73-ecb80474568d"
}

모든 플랫폼에서 콜백 예약

Proactive Engagement 솔루션을 사용하여 웹, 모바일 애플리케이션, 음성 및 채팅 에이전트를 포함한 다양한 플랫폼에서 콜백을 예약할 수 있습니다. 다음 방법으로 이 작업을 수행할 수 있습니다.

• Copilot Studio 에이전트에서 Power Automate 흐름을 만듭니다.
• 일정 콜백 API를 웹사이트와 통합합니다.

Copilot 에이전트에서 Power Automate 흐름 만들기

Copilot 에이전트에서 Power Automate 흐름을 만들어 콜백을 예약할 수 있습니다. 다음 단계를 수행합니다.

1. 다음 매개 변수를 사용하여 에이전트와 함께 사용할 수 있는 흐름 만들기 의 단계를 수행합니다.

• 언바운드 작업 수행을 작업으로 지정합니다.
• 작업 이름으로CCaaS_CreateProactiveVoiceDelivery 선택합니다.
• Advanced parameters(고급 매개변수)에서 다음 필수 필드를 지정합니다.
  • Item/DestinationPhoneNumber: 전화할 고객의 전화 번호입니다.
  • Item/ProactiveEngagementConfigId: 사용할 사전 관리 참여 구성의 ID입니다. 이는 고객에게 연락할 때 사용할 다이얼 모드 유형, 작업 스트림 및 아웃바운드 프로필을 나타냅니다. Power Apps >테이블>사전 참여 구성 테이블에서 이 ID를 복사할 수 있습니다.
  • 항목/ApiVersion: 1.0
  • 항목/ContactId: Dynamics CRM에 있는 고객 연락처의 ID입니다.
  • 필요에 따라 Item/InputAttributes를 지정할 수 있습니다. 이 필드에는 Copilot 에이전트에서 사용하는 JSON 개체가 포함되어야 합니다. 예: { "msdyn_CaseTitle" : "Vitre cassée", "msdyn_CustomerName" : "Sarah", "msdyn_CustomerPhone" : "+1234567890", "msdyn_CustomerId" : "cfaa617b-2fc1-ef11-b8e8-000d3a5bcd16" }.

API를 사용하여 콜백 예약

API를 CCaaS_CreateProactiveVoiceDelivery 웹사이트와 통합하여 고객이 가장 편리한 시간에 지원을 요청할 수 있도록 합니다.

샘플 요청

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
     "type": "callback"
    "isLastAttempt": "false"
  }
}

CCaaS_CreateOperation

일시 중지, 재개, 취소.

구현 상태: 개발 중입니다

HTTP 요청 키

샘플 페이로드

{ 
  "ApiVersion": "1.0", 
  "ProactiveEngagementConfigId": "47089bbe-deb7-ef11-b8e6-000d3a36a6b3", 
  "Operation ": "Resume"
}

HTTP 응답 상태

관련 정보

보고를 위해 사전 예방적 참여 테이블 사용