CCaaS_ตรวจสอบความพร้อมใช้งานของตัวแทนสำหรับการสนทนา

ใช้ CCaaS_GetRepresentativeAvailabilityForConversation API เพื่อรับคิวและความพร้อมใช้งานของตัวแทนบริการในระหว่างการสนทนาที่ใช้งานอยู่ด้วย ID การสนทนาที่ถูกต้อง

ตัวอย่างเช่น เมื่อลูกค้าที่สนทนากับตัวแทน IVR หรือ AI ร้องขอการเลื่อนระดับไปยังตัวแทนฝ่ายบริการ เจ้าหน้าที่ AI จะเรียกใช้ API นี้เพื่อกําหนดความพร้อมใช้งานของตัวแทนบริการและกําหนดเส้นทางการสนทนาตามการตอบสนอง

ขอรายละเอียด

URL

/\<orgurl\>/api/data/v9.2/CCaaS\_ GetRepresentativeAvailabilityForConversation

วิธีการ

POST

เวอร์ชัน

1.0

ส่วนหัวของคำขอ

ชื่อ คำอธิบาย:
การอ นุ ญาต บังคับ Microsoft Entra ID โทเค็นแบเรอร์สําหรับผู้เรียก API ในอินสแตนซ์ของ Contact Center เรียนรู้เพิ่มเติมใน โทเค็นการตั้งค่าสําหรับการอนุญาต API

เนื้อหาคำขอตัวอย่าง

คำอธิบาย: คําขอตัวอย่าง
กำหนดความพร้อมใช้งานของคิวและตัวแทนสำหรับการสนทนาที่กำลังดำเนินอยู่ curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "2f2508bd-b58e-4982-b142-651e36dc8df3" }'
กําหนดความพร้อมใช้งานของคิวและตัวแทนสําหรับการสนทนาที่กฎการกําหนดเวลาต่อคิวจําเป็นต้องมีรายการบริบทเพิ่มเติม curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "cf21df54-6d64-4aea-b668-405b8aa42b07", "CustomContextItems": "{\"contextItem1\": {\"value\": \"contextItemValue1\", \"isDisplayable\": true, \"datatype\": \"DataType1\"}, \"contextItem2\": {\"value\": \"contextItemValue2\", \"isDisplayable\": true, \"datatype\": \"DataType2\"}}" }'
กฎอยู่ในแบบสํารวจรายการบริบท (ชนิด: ข้อความ ค่า: อินเดีย) curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "ConversationId": "94c002c8-b14e-4a0e-8069-78dcf0d6c208", "CustomContextItems": "{\"Survey\": {\"value\": \"India\", \"isDisplayable\": true, \"datatype\": \"192350000\"}}" }'

โน้ต

  • ในเนื้อความของคำขอ CustomContextItems เป็นสตริงที่มีรายการบริบทที่ใช้ในกฎสำหรับการจัดเส้นทางไปยังคิว รายการตัวอย่างของรายการบริบท:

    {
  "contextItemName1": {
    "value": "contextItemValue1",
    "isDisplayable": true,
    "datatype": "DataType1"
  },
  "contextItemName2": {
    "value": "contextItemValue2",
    "isDisplayable": true,
    "datatype": "DataType2"
  }
}

  • isDisplayable ระบุว่ารายการบริบทจะแสดงบนหน้าจอหรือไม่ ค่านี้เป็น True หรือ False

  • datatype สามารถเป็น ข้อความ = 192350000 หรือ จํานวนเต็ม = 192350001 เท่านั้น

การตอบสนอง

หากสําเร็จ วิธีนี้จะส่งกลับรหัสการตอบสนอง 200 ตกลง เมธอด จะส่งกลับรหัสสถานะต่อไปนี้ด้วย

สถานะของ HTTP คำอธิบาย:
400 คําขอไม่ถูกต้อง (พารามิเตอร์อินพุตไม่ถูกต้อง)
401 ไม่ได้รับอนุญาต
404 ไม่พบทรัพยากร
429 ขีดจํากัดอัตรา (คําขอมากเกินไป)
405 ไม่อนุญาต API
500 ข้อผิดพลาดภายในของเซิร์ฟเวอร์

ค่าการตอบสนอง

ชื่อ ชนิด คำอธิบาย:
queueId สตริง คิวเป้าหมายที่คําขอถูกส่งตามการกําหนดค่ากฎการกําหนดเส้นทางและข้อมูลป้อนเข้า เช่น ค่าเอนทิตีและบริบทที่เป็นส่วนหนึ่งของกฎการกําหนดเส้นทาง
isQueueAvailable แบบบูลีน แสดง TRUE ถ้าคิวอยู่ภายในชั่วโมงทําการ ค่าความผิดพลาด ถ้าคิวอยู่นอกเวลาทำงาน
เวลาเริ่มต้นของชั่วโมงการทำงานถัดไป วันที่และเวลา เวลาเริ่มต้น (UTC) ของชั่วโมงการทำงานสำหรับคิว หากเวลานี้อยู่นอกเวลาทำการ ส่งกลับ 01-01-0001 ในช่วงชั่วโมงทํางาน
เวลาสิ้นสุดของชั่วโมงการทำงานถัดไป วันที่และเวลา เวลา (UTC) ที่ชั่วโมงการทำงานของคิวสิ้นสุด หากในขณะนั้นอยู่นอกเวลาทำการ ส่งกลับ 01-01-0001 ในช่วงชั่วโมงทํางาน
เวลาการเปลี่ยนผ่านครั้งถัดไป วันที่และเวลา เวลา (UTC) เมื่อคิวกลับมาทํางานอีกครั้งหากอยู่นอกเวลาทําการ ในระหว่างชั่วโมงการทำงาน จะแสดงเมื่อคิวไม่สามารถใช้งานได้
ตำแหน่งในคิว ตัวเลข จัดตําแหน่งในคิวสําหรับลูกค้าที่กําลังรอผู้อื่นอยู่เบื้องหลังในคิวเดียวกัน
ตัวแทนพร้อมใช้งานหรือไม่ แบบบูลีน แสดง:
  • TRUE ถ้าตัวแทนบริการในคิวพร้อมให้บริการสําหรับคําขอตามกฎการกำหนดเส้นทางและการกำหนดงานในขณะนี้
  • FALSE ถ้าตัวแทนบริการไม่สามารถรับคําขอได้
เวลาเฉลี่ยในการรอ ตัวเลข เวลารอเฉลี่ยเป็นนาทีสําหรับลูกค้าในคิวเป้าหมาย
เวลาเฉลี่ยในการรอเป็นวินาที ตัวเลข เวลารอเฉลี่ยเป็นวินาทีสําหรับลูกค้าในคิวเป้าหมาย
จำนวนผู้เชี่ยวชาญที่พร้อมให้บริการในคิว ตัวเลข จํานวนตัวแทนบริการที่พร้อมใช้งานในปัจจุบันเพื่อยอมรับการสนทนาในคิวเป้าหมาย

การตอบสนองตัวอย่าง

{  
"@odata.context": "https://<org-url>/api/data/v9.2/\$metadata#Microsoft.Dynamics.CRM.CCaaS_GetRepresentativeAvailabilityForConversationResponse",  
"NextTransitionTime": "9999-12-31T23:59:59Z",
"NumberOfExpertsAvailableInQueue": 5,
"AverageWaitTimeInSeconds": 45  
"PositionInQueue": 1,  
"AverageWaitTime": null,  
"StartTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"EndTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"QueueId": "85e55877-f27a-e911-a81a-000d3a1ca610",  
"IsAgentAvailable": true,  
"IsQueueAvailable": true  
}

ใช้ API ความพร้อมใช้งานของตัวแทน
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on