แชร์ผ่าน


ใช้ CCaaS_CreateProactiveVoiceDelivery API

คุณสามารถใช้ 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 นี้ ให้ทําดังต่อไปนี้:
  1. ไปที่ Power Apps และเลือกสภาพแวดล้อมที่ต้องการ
  2. เลือก ตาราง>การกําหนดค่าการมีส่วนร่วมเชิงรับ
  3. เลือก 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 เพื่อกําหนดเวลาการโทรกลับ ดำเนินการขั้นตอนต่อไปนี้:

  1. ทําตามขั้นตอนใน สร้างโฟลว์ที่คุณสามารถใช้กับตัวแทนด้วย พารามิเตอร์ต่อไปนี้:
  • ระบุ ดําเนินการ (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

ใช้ตารางการมีส่วนร่วมเชิงรุกสําหรับการรายงาน