Sử dụng API CCaaS_CreateProactiveVoiceDelivery (xem trước)

2025-06-02

[Bài viết này là tài liệu trước khi phát hành và có thể thay đổi.]

Bạn có thể sử dụng CCaaS_CreateProactiveVoiceDelivery API để bắt đầu cuộc gọi thoại đi chủ động cho khách hàng hoặc cho phép khách hàng lên lịch gọi lại thông qua Dịch vụ tương tác chủ động.

Quan trọng

Nếu một tổ chức đang sử dụng CCaaS_CreateProactiveVoiceDelivery API để bắt đầu cuộc gọi thoại đi, tổ chức đó chịu trách nhiệm quản lý sự đồng ý, bao gồm cả việc cập nhật thủ công "danh sách không gọi" để đặt giờ yên tĩnh để liên hệ với khách hàng. Đảm bảo rằng các điều kiện sau được đáp ứng:

Có được sự đồng ý thích hợp trước khi liên hệ với khách hàng
Khách hàng chỉ được liên hệ trong giờ cho phép.

Quan trọng

Đây là một tính năng xem trước.
Các tính năng xem trước không được dùng cho sản xuất và có thể có chức năng bị hạn chế. Các tính năng này phải tuân theo các điều khoản sử dụng bổ sung và có sẵn trước khi phát hành chính thức để khách hàng có thể truy cập sớm và cung cấp phản hồi.

Điều kiện tiên quyết

Bạn phải có vai trò Omnichannel Agent hoặc Omnichannel Supervisor để gọi API này.
Tương tác chủ động được định cấu hình. Tìm hiểu thêm trong Định cấu hình tương tác chủ động (xem trước).

Bắt đầu cuộc gọi đi chủ động

Tương tác chủ động cho phép các tổ chức tăng cường tương tác với khách hàng bằng cách bắt đầu giao tiếp ra ngoài thông qua kênh thoại. Bạn có thể đặt cấu hình tương tác chủ động bằng cách sử dụng hành trình Customer Insights hoặc tệp CCaaS_CreateProactiveVoiceDelivery.

API cho CCaaS_CreateProactiveVoiceDelivery phép các tổ chức bắt đầu cuộc gọi thoại đi đi chủ động cho khách hàng thông qua Dịch vụ Tương tác Chủ động. API kích hoạt cuộc gọi thoại đi thông qua hệ thống Voice Runtime. Các cuộc gọi được thực hiện theo chế độ quay số đã định cấu hình ngay lập tức (nếu không có khoảng thời gian nào được chỉ định) hoặc trong khoảng thời gian được chỉ định mà bạn cung cấp.

API này cho phép contact center tiếp cận khách hàng vào đúng thời điểm với các thông tin, lời nhắc hoặc thông báo liên quan, nâng cao trải nghiệm khách hàng đồng thời tối ưu hóa hiệu quả hoạt động.

Chi tiết yêu cầu

Địa chỉ: https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery
Phương pháp: POST
Phiên bản: 1.0
Hoạt động OData: Hành động
Loại OData: Không giới hạn
Yêu cầu ủy quyền: Bắt buộc. Phải chứa mã thông báo Azure AD Bearer hợp lệ cho người dùng thực hiện lệnh gọi API. Mã thông báo này phải được cấp từ cùng một đối tượng thuê Azure AD với phiên bản Customer Service.

Tiêu đề yêu cầu

Khóa	Loại	Mô tả
Phiên bản ApiVersion	Xâu	Phiên bản API CCaaS.
ProactiveEngagementConfigId	Xâu	Id của Cấu hình Tương tác Chủ động để sử dụng. Điều này chỉ định loại chế độ quay số, luồng công việc và hồ sơ đi để sử dụng. Để lấy ID này, hãy làm như sau: Truy cập Power Apps và chọn môi trường cần thiết. Chọn bảng>Cấu hình tương tác chủ động Chọn ID của bản ghi được yêu cầu.
Số điện thoại đích	Xâu	Số điện thoại của khách hàng cần gọi.
ContactId	Xâu	Id của người liên hệ khách hàng trong Dynamics CRM.
Cửa sổ	Mảng JSON của các đối tượng Window	Chỉ định khoảng thời gian hợp lệ khi cuộc gọi đi có thể được thực hiện. Nếu không được cung cấp, hệ thống mặc định là cửa sổ 24 giờ bắt đầu ngay lập tức (từ thời gian hiện tại cho đến 24 giờ sau).
Thuộc tính đầu vào	Đối tượng JSON của chuỗi khóa-giá trị	Tùy chọn. Các biến có thể được tham chiếu trong các dòng tác nhân Copilot để tùy chỉnh hành vi, thúc đẩy logic có điều kiện hoặc truy xuất thông tin được cá nhân hóa từ bản ghi Dataverse.

Đối tượng Windows

Khóa	Loại	Mô tả
Bắt đầu	Xâu	Dấu thời gian bắt đầu cho cửa sổ này. Phải được chỉ định bằng UTC ở `yyyy-MM-ddTHH:mm:ss.fffZ` định dạng.
Kết thúc	Xâu	Dấu thời gian kết thúc cho cửa sổ này. Phải được chỉ định bằng UTC ở `yyyy-MM-ddTHH:mm:ss.fffZ` định dạng.

Yêu cầu mẫu


{
  "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"
  }
}

Chi tiết phản hồi

Nếu thành công, phương thức này trả về DeliveryId. ID phân phối là mã định danh duy nhất được gán cho mỗi yêu cầu tương tác chủ động được chấp nhận thông qua API và được lưu trữ trong bảng msdyn_proactive_delivery.

Câu trả lời mẫu như sau:


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

Lên lịch gọi lại từ bất kỳ nền tảng nào

Bạn có thể sử dụng giải pháp Tương tác chủ động để lên lịch gọi lại từ nhiều nền tảng khác nhau bao gồm web, ứng dụng di động, nhân viên thoại và trò chuyện. Bạn có thể làm điều này theo các cách sau:

Tạo dòng Power Automate từ tác nhân Copilot Studio.
Tích hợp API gọi lại lịch trình với trang web của bạn.

Tạo dòng Power Automate từ tác nhân Copilot

Bạn có thể tạo dòng Power Automate từ tác nhân Copilot để lên lịch gọi lại. Thực hiện các bước sau:

Thực hiện các bước trong Tạo quy trình bạn có thể sử dụng với tổng đài viên với các thông số sau:

Chỉ định Thực hiện một hành động không liên kết làm hành động.
Chọn CCaaS_CreateProactiveVoiceDelivery làm Tên hành động.
Trong Thông số nâng cao, chỉ định các trường bắt buộc sau:
- Item/DestinationPhoneNumber: Số điện thoại của khách hàng cần gọi.
- Item/ProactiveEngagementConfigId: Id của cấu hình tương tác chủ động để sử dụng. Điều này cho biết loại chế độ quay số, luồng công việc và hồ sơ đi để sử dụng khi liên hệ với khách hàng. Bạn có thể sao chép ID này từ bảng >> Bảng Power Apps.
- Item/ApiVersion: 1.0
- Item/ContactId: Id của người liên hệ khách hàng trong Dynamics CRM.
- Tùy chọn, bạn có thể chỉ định Item/InputAttributes. Trường này phải chứa một đối tượng JSON được sử dụng bởi tác nhân Copilot. Ví dụ, { "msdyn_CaseTitle" : "Vitre cassée", "msdyn_CustomerName" : "Sarah", "msdyn_CustomerPhone" : "+1234567890", "msdyn_CustomerId" : "cfaa617b-2fc1-ef11-b8e8-000d3a5bcd16" }.

Sử dụng API để lên lịch gọi lại

Tích hợp CCaaS_CreateProactiveVoiceDelivery API với trang web của bạn để cho phép khách hàng yêu cầu hỗ trợ vào những thời điểm thuận tiện nhất cho họ.

Yêu cầu mẫu

{
  "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"
  }
}

Sử dụng bảng tương tác chủ động để báo cáo