หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
คุณสามารถใช้ CCaaS_CreateProactiveVoiceDelivery API เพื่อเริ่มการโทรออกเชิงรุกไปยังลูกค้า หรืออนุญาตให้ลูกค้ากําหนดเวลาการโทรกลับผ่านบริการการมีส่วนร่วมเชิงรับ
สําคัญ
หากองค์กรใช้ CCaaS_CreateProactiveVoiceDelivery API เพื่อเริ่มการโทรออกองค์กรจะต้องรับผิดชอบในการจัดการความยินยอมรวมถึงการอัปเดต "รายการห้ามโทร" ด้วยตนเองสําหรับการตั้งค่าชั่วโมงเงียบสําหรับการติดต่อลูกค้า ตรวจสอบให้แน่ใจว่าตรงตามเงื่อนไขต่อไปนี้:
- ได้รับความยินยอมที่เหมาะสมก่อนติดต่อลูกค้า
- ลูกค้าจะได้รับการติดต่อในช่วงเวลาที่ได้รับอนุญาตเท่านั้น
ข้อกําหนดเบื้องต้น
- คุณต้องมีบทบาทเอเจนต์ช่องทาง Omni หรือผู้ดูแลช่องทาง Omni เพื่อเรียก API นี้
- มีการกําหนดค่าการมีส่วนร่วมเชิงรุก เรียนรู้เพิ่มเติมในกําหนดค่าการมีส่วนร่วมเชิงรุก
เริ่มการโทรออกเชิงรุก
การมีส่วนร่วมเชิงรุกช่วยให้องค์กรสามารถปรับปรุงการโต้ตอบกับลูกค้าโดยเริ่มต้นการสื่อสารขาออกผ่านช่องทางเสียง คุณสามารถกําหนดค่าการมีส่วนร่วมเชิงรุกโดยใช้การเดินทางของ Customer Insights หรือปุ่ม CCaaS_CreateProactiveVoiceDelivery.
API ช่วยให้ CCaaS_CreateProactiveVoiceDelivery องค์กรสามารถเริ่มต้นการโทรออกเชิงรุกไปยังลูกค้าผ่านบริการการมีส่วนร่วมเชิงรุก API จะทริกเกอร์การโทรด้วยเสียงขาออกผ่านระบบ Voice Runtime การโทรจะถูกวางตามโหมดการโทรที่กําหนดค่าไว้ทันที (หากไม่มีการระบุกรอบเวลา) หรือระหว่างกรอบเวลาที่กําหนดที่คุณให้ไว้
API นี้ช่วยให้ศูนย์ติดต่อสามารถเข้าถึงลูกค้าได้ในเวลาที่เหมาะสมด้วยข้อมูลการแจ้งเตือนหรือการแจ้งเตือนที่เกี่ยวข้องปรับปรุงประสบการณ์ของลูกค้าในขณะที่เพิ่มประสิทธิภาพการดําเนินงาน
รายละเอียดคำขอ
- URL:
https://contosowebservice.azurewebsites.net/odata - วิธีการ: POST
- เวอร์ชัน: 1.0
- การทํางานของ OData: การกระทํา
- ประเภท OData: ไม่มีขอบเขต
- ขออนุญาต: จําเป็น ต้องมีโทเค็น Azure AD Bearer ที่ถูกต้องสําหรับผู้ใช้ที่ทําการเรียก API โทเค็นนี้ต้องออกจากผู้เช่า Azure AD เดียวกันกับอินสแตนซ์ Customer Service
ส่วนหัวของคำขอ
| คีย์ | ประเภท | คำอธิบาย |
|---|---|---|
| ApiVersion | สตริง | เวอร์ชัน CCaaS API |
| ProactiveEngagementConfigId | สตริง | รหัสของการตั้งค่าคอนฟิกการมีส่วนร่วมเชิงรับที่จะใช้ ซึ่งจะระบุชนิดโหมดการโทร สตรีมงาน และโพรไฟล์ขาออกที่จะใช้ เมื่อต้องการรับ ID นี้ ให้ทําดังต่อไปนี้:
|
| หมายเลขโทรศัพท์ปลายทาง | สตริง | หมายเลขโทรศัพท์ของลูกค้าที่จะโทร |
| ผู้ติดต่อ | สตริง | รหัสของผู้ติดต่อลูกค้าใน Dynamics CRM |
| หน้าต่าง | อาร์เรย์ JSON ของวัตถุ Window | ระบุช่วงเวลาที่ถูกต้องเมื่อสามารถโทรออกได้ หากไม่ได้ระบุ ระบบจะตั้งค่าเริ่มต้นเป็นกรอบเวลา 24 ชั่วโมงโดยเริ่มทันที (ตั้งแต่เวลาปัจจุบันจนถึง 24 ชั่วโมงต่อมา) |
| แอตทริบิวต์อินพุต | ออบเจ็กต์ JSON ของสตริงคีย์-ค่า | ไม่บังคับ ตัวแปรที่สามารถอ้างอิงได้ภายในโฟลว์ตัวแทน Copilot เพื่อปรับแต่งพฤติกรรม ขับเคลื่อนตรรกะตามเงื่อนไข หรือดึงข้อมูลส่วนบุคคลจากเรกคอร์ด Dataverse |
วัตถุ Windows
| คีย์ | ประเภท | คำอธิบาย |
|---|---|---|
| เริ่ม | สตริง | การประทับเวลาเริ่มต้นสําหรับหน้าต่างนี้ ต้องระบุเป็น UTC ในรูปแบบyyyy-MM-ddTHH:mm:ss.fffZ |
| สิ้นสุด | สตริง | การประทับเวลาสิ้นสุดสําหรับหน้าต่างนี้ ต้องระบุเป็น UTC ในรูปแบบyyyy-MM-ddTHH:mm:ss.fffZ |
สําคัญ
ไคลเอนต์บางรายต้องการรูปแบบเฉพาะ เช่น "Windows": "[{\"Start\":\"2025-01-30T16:32:45.930Z\",\"End\":\"2025-06-25T16:32:45.930Z\"}]". เราขอแนะนําให้คุณทดสอบตามนั้น
คำขอตัวอย่าง
{
"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. รหัสการจัดส่งคือตัวระบุเฉพาะที่กําหนดให้กับคําขอการมีส่วนร่วมเชิงรับแต่ละรายการที่ยอมรับผ่าน 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 เพื่อกําหนดเวลาการโทรกลับจากแพลตฟอร์มต่างๆ รวมถึงเว็บ แอปพลิเคชันมือถือ ตัวแทนเสียงและแชท คุณสามารถทำรายการนี้ได้ในวิธีต่อไปนี้:
- สร้างโฟลว์ Power Automate จากตัวแทน Copilot Studio
- ผสานรวม API การเรียกกลับตามกําหนดการกับเว็บไซต์ของคุณ
สร้างโฟลว์ Power Automate จากตัวแทน Copilot
คุณสามารถสร้างโฟลว์ Power Automate จากตัวแทน Copilot เพื่อกําหนดเวลาการโทรกลับ ดำเนินการขั้นตอนต่อไปนี้:
- ทําตามขั้นตอนใน สร้างโฟลว์ที่คุณสามารถใช้กับตัวแทนด้วย พารามิเตอร์ต่อไปนี้:
- ระบุ ดําเนินการ (Perform an unbound) เป็นการกระทํา
- เลือก CCaaS_CreateProactiveVoiceDelivery เป็น ชื่อการดําเนินการ
- ใน พารามิเตอร์ขั้นสูง ให้ระบุฟิลด์บังคับต่อไปนี้:
- Item/DestinationPhoneNumber: หมายเลขโทรศัพท์ของลูกค้าที่จะโทร
- Item/ProactiveEngagementConfigId: รหัสของการตั้งค่าคอนฟิกการมีส่วนร่วมเชิงรุกที่จะใช้ ซึ่งระบุชนิดโหมดการโทร สตรีมงาน และโพรไฟล์ขาออกที่จะใช้เมื่อติดต่อลูกค้า คุณสามารถคัดลอกรหัสนี้ได้จากตาราง >>ตาราง การกําหนดค่าการมีส่วนร่วมเชิงรับ
- รายการ / ApiVersion: 1.0
- Item/ContactId: รหัสของผู้ติดต่อลูกค้าใน Dynamics CRM
- หรือคุณสามารถระบุ Item/InputAttributes ได้ ฟิลด์นี้ควรมีออบเจ็กต์ JSON ที่ใช้โดยตัวแทน Copilot ตัวอย่างเช่น:
{ "msdyn_CaseTitle" : "Vitre cassée", "msdyn_CustomerName" : "Sarah", "msdyn_CustomerPhone" : "+1234567890", "msdyn_CustomerId" : "cfaa617b-2fc1-ef11-b8e8-000d3a5bcd16" }
ใช้ API เพื่อกําหนดเวลาการเรียกกลับ
ผสานรวม CCaaS_CreateProactiveVoiceDelivery API กับเว็บไซต์ของคุณเพื่อให้ลูกค้าสามารถขอความช่วยเหลือในเวลาที่สะดวกที่สุดสําหรับพวกเขา
คําขอตัวอย่าง
{
"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
ระงับ ดําเนินการต่อ และยกเลิก
สถานะการดําเนินงาน: อยู่ระหว่างการพัฒนา
| API | CCaaS_CreateOperation |
|---|---|
| คำอธิบาย | ขอยกเลิก ระงับ หรือดําเนินการต่อบน PES |
| URL | https://< orgurl>/api/data/v9.2/CaaS_CreateOperation |
| เวอร์ชัน | 1.0 |
| การทํางานของ OData | การดำเนินการ |
| ประเภท OData | มีขอบเขต |
| คํากริยา HTTP | POST |
| ส่วนหัวของคําขอ HTTP | การให้สิทธิ์: <บังคับ โทเค็นผู้ถือจาก Azure AD สําหรับผู้ใช้ผู้เรียก API ในผู้เช่าของอินสแตนซ์ CCaaS> |
| สถานการณ์ตัวอย่าง | |
| สิทธิพิเศษที่จําเป็น |
คีย์คําขอ HTTP
| คีย์ | ประเภท | ต้องมี | คำอธิบาย |
|---|---|---|---|
| ApiVersion | สตริง | ใช่ | ต้องตั้งค่าเป็น "1.0" |
| ProactiveEngagementConfigId | สตริง | ไม่ใช่ | รหัสการมีส่วนร่วมเชิงรุก |
| รหัสการจัดส่ง | สตริง | ไม่ใช่ | ถ้ายกเลิกการจัดส่งจะถูกยกเลิก |
| การดำเนินงาน | สตริง | ใช่ | ระงับ ดําเนินการต่อ หรือยกเลิก |
ส่วนข้อมูลตัวอย่าง
{
"ApiVersion": "1.0",
"ProactiveEngagementConfigId": "47089bbe-deb7-ef11-b8e6-000d3a36a6b3",
"Operation ": "Resume"
}
สถานะการตอบสนอง HTTP
| HTTP | หมายเหตุสถานะ |
|---|---|
| 202 | ได้รับการยอมรับ |
| 400 | คําขอไม่ถูกต้อง (พารามิเตอร์อินพุตไม่ถูกต้อง) |
| 401 | ไม่ได้รับอนุญาต |
| 404 | ไม่พบทรัพยากร |
| 429 | ขีดจํากัดอัตรา (คําขอมากเกินไป) |
| 405 | ไม่อนุญาต API |