หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ใช้ API ความพร้อมใช้งานตัวแทนในการดึงข้อมูลเกี่ยวกับคิวและความพร้อมใช้งานของเจ้าหน้าที่บริการลูกค้าใน Dynamics 365 Contact Center
คุณสามารถใช้ API เหล่านี้ในสถานการณ์ต่าง ๆ เช่น:
- เมื่อตัวแทน AI จําเป็นต้องเลื่อนระดับการสนทนาอย่างต่อเนื่องไปยังคิวเหล่านั้นที่มีตัวแทนฝ่ายบริการพร้อมใช้งานเท่านั้น
- คุณต้องการให้ลูกค้าเริ่มต้นการสนทนาเฉพาะเมื่อคิวอยู่ภายในเวลาทําการ หรือมีตัวแทนที่พร้อมให้ใช้งานเท่านั้น
API ความพร้อมใช้งานของตัวแทนจะใช้ได้กับทุกช่อง รวมถึงเสียง การแชทสด และการรับส่งข้อความดิจิทัล
ข้อกําหนดเบื้องต้น
- คุณได้รับการกำหนดเป็นผู้ดูแลระบบ Omnichannel
ตั้งค่าโทเค็นสําหรับการอนุญาต API
เมื่อต้องการใช้ API ความพร้อมใช้งานตัวแทน คุณต้องสร้างโทเค็นการเข้าถึง โทเค็นนี้ทําหน้าที่เป็นข้อมูลประจําตัวที่ปลอดภัยเพื่อรับรองความถูกต้องของข้อมูลประจําตัวของแอปพลิเคชันของคุณ และอนุญาตให้เข้าถึงทรัพยากรบริการเฉพาะ
ทําตามขั้นตอนต่อไปนี้ในพอร์ทัล Azure:
การลงทะเบียนแอปพลิเคชันของคุณ หรือไปที่ Entra ID>App registrations จากนั้นเลือกแอปพลิเคชันไคลเอ็นต์ของคุณ คัดลอกค่าต่อไปนี้:
- รหัสแอปพลิเคชัน (ไคลเอนต์)
- ID ไดเรกทอรี (ผู้เช่า)
ในการลงทะเบียนแอปของคุณ เลือกสิทธิ์> APIเพิ่มสิทธิ์
ในแท็บ Request API ให้เลือกแท็บ Microsoft จากนั้นเลือก Dynamics CRM
เลือก สิทธิ์ที่ได้รับมอบหมาย จากนั้นเลือก
user_impersonationขอบเขตเลือก เพิ่มสิทธิ์
สําคัญ
คัดลอกข้อมูลลับ ค่า ทันที ค่านี้ถูกเข้ารหัสลับและจะไม่แสดงอีกครั้งหลังจากที่คุณออกจากหน้า
หากต้องการสร้างโทเค็น ให้เรียกใช้คําขอต่อไปนี้POST แทนที่ค่าต่อไปนี้
| มูลค่า | รายละเอียด |
|---|---|
tenant-Id |
ID ไดเรกทอรี (ผู้เช่า) ของแอป |
client_id |
ID แอปพลิเคชัน (ไคลเอ็นต์) ที่กําหนดให้กับแอปของคุณใน Microsoft Entra ID |
client_secret |
สตริงข้อมูลลับที่สร้างขึ้นระหว่างการลงทะเบียนแอป |
resource |
URL ของสภาพแวดล้อม Dynamics 365 ของคุณ ที่กําหนดสิทธิ์ที่ร้องขอ |
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}
การตอบสนองจะส่งกลับออบเจ็กต์ JSON ด้วยโทเค็นที่คุณสามารถใช้ในส่วนหัวการอนุญาต ของการเรียกใช้ API ความพร้อมใช้งานตัวแทนของคุณเป็นโทเค็นแบเรอร์
API สำหรับความพร้อมให้บริการของตัวแทน
API ความพร้อมใช้งานของตัวแทนดังต่อไปนี้มีให้ใช้งาน:
- CCaaS_GetRepresentativeAvailabilityForConversation: แสดงคิวและการพร้อมให้บริการของตัวแทนบริการระหว่างการสนทนาที่ใช้งานอยู่โดยใช้ ID การสนทนาที่ถูกต้อง เรียนรู้เพิ่มเติมใน CCaaS_GetRepresentativeAvailabilityForConversation
- CCaaS_GetRepresentativeAvailabilityBeforeConversation: ส่งกลับความพร้อมใช้งานของคิวและบริการตัวแทนก่อนเริ่มการสนทนากับลูกค้า เรียนรู้เพิ่มเติมใน CCaaS_GetRepresentativeAvailabilityBeforeConversation
ข้อมูลที่เกี่ยวข้อง
CCaaS_GetRepresentativeAvailabilityForConversation
CCaaS_GetRepresentativeAvailabilityBeforeConversation