หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
แสดงการแจ้งเตือนที่สามารถใช้เพื่อแจ้งให้ตัวแทนทราบเกี่ยวกับการสนทนาขาเข้า
Syntax
Microsoft.CIFramework.notifyEvent(input, correlationId, cancellationToken).then(successCallback, errorCallback);
Parameters
| ชื่อ | ประเภท | ต้องมี | คำอธิบาย |
|---|---|---|---|
| อินพุต | วัตถุ JSON | ใช่ | สตริง |
| correlationId | GUID | ไม่ | ใช้เพื่อจัดกลุ่มการเรียก API ที่เกี่ยวข้องทั้งหมดเข้าด้วยกันสําหรับการวัดทางไกลในการวินิจฉัย |
| cancellationToken | สตริง | ไม่ | เป็นสตริงที่ไม่ซ้ํากันที่ใช้โดย cancelEvent วิธีการยกเลิกการแจ้งเตือนเกี่ยวกับการสนทนาขาเข้า |
| successCallback | ฟังก์ชัน | ไม่ | ฟังก์ชันที่จะเรียกใช้เมื่อคําขอสําเร็จ เมื่อเรียกกลับสําเร็จ ออบเจ็กต์การตอบกลับจะมีข้อมูลว่าลูกค้ายอมรับหรือปฏิเสธการสนทนา |
| errorCallback | ฟังก์ชัน | ไม่ | ฟังก์ชันที่จะเรียกใช้เมื่อคําขอล้มเหลว |
รายละเอียดฟังก์ชันการโทรกลับ
วัตถุต่อไปนี้จะถูกส่งผ่านไปยังsuccessCallbackฟังก์ชัน and errorCallback
successCallback (ฟังก์ชัน successCallback)
ตัวอย่างวัตถุ JSON:
{
"value": {"actionName" : "Accept",
"responseReason" : "Accept"}
}
พารามิเตอร์
| ชื่อการกระทํา | คําตอบเหตุผล | คำอธิบาย |
|---|---|---|
| รับ | รับ | เมื่อผู้ใช้ยอมรับการแจ้งเตือน |
| รับ | ยอมรับอัตโนมัติ | การแจ้งเตือนได้รับการยอมรับโดยค่าเริ่มต้นผ่านเทมเพลตการแจ้งเตือน |
| ปฏิเสธ | ปฏิเสธโดยตัวแทน | เมื่อผู้ใช้ปฏิเสธการแจ้งเตือน |
| ปฏิเสธ | NotificationQueueLimit เกิน | การแจ้งเตือนจะถูกปฏิเสธหากขีดจํากัดเกินสิบการแจ้งเตือนในคิว |
| ปฏิเสธ | การแจ้งเตือนคิวไทม์จํากัดเกิน | เมื่อการแจ้งเตือนในคิวเกินระยะเวลาหมดเวลาที่กําหนดไว้ |
| หมดเวลา | DisplayTimeout | เมื่อผู้ใช้ไม่ตอบสนองต่อการแจ้งเตือนภายในระยะเวลาหมดเวลา |
errorCallback (ฟังก์ชัน errorCallback)
ตัวอย่างวัตถุ JSON:
{
"message" : "<error details>",
"msdyn_name" : "NotifyEvent"
}
พารามิเตอร์
| ข้อความ | คำอธิบาย |
|---|---|
| การแจ้งเตือนแม่แบบไม่พบข้อผิดพลาด | เมื่อไม่พบชื่อแม่แบบที่ระบุ |
| RejectAfterClientError | เกิดข้อยกเว้นที่ไม่รู้จัก (เกิดขึ้นเมื่อการเรียก API ของแพลตฟอร์มล้มเหลวหรือพารามิเตอร์อินพุตบางอย่างหายไป) |
ตัวอย่าง
var canceltoken = "cancellationtoken"+ Math.ceil(Math.random() * 100000 + 100000).toString();
var input = {
templateName: "msdyn_chat_incoming_unauthenticated",
// unique name of the configured template
templateParameters: {
},
// unique random token, to identify the notification during cancelEvent call
cancellationToken: canceltoken
}
Microsoft.CIFramework.notifyEvent(input).then(
function success(result) {
console.log(result);
// Perform operations
},
function (error) {
console.log(error.message);
// Handle error conditions
}
);