ภาวะคับขัน

รับทราบเหตุการณ์ Duress ที่เปิดอยู่แทนผู้ใช้ โดยบันทึกว่าผู้ใช้กำลังตอบสนอง และสามารถหยุดการยกระดับเพิ่มเติมได้ รับทราบได้เฉพาะเหตุการณ์ที่เปิดอยู่เท่านั้น

ยืนยันก่อนเสมอ เรียกโดยไม่ใช้ confirm เพื่อดูเหตุการณ์ แจ้งผู้ใช้ว่ากำลังรับทราบอะไร แล้วเรียกอีกครั้งด้วย confirm: true หลังจากผู้ใช้ยินยอมแล้วเท่านั้น

ในเวิร์กโฟลว์หรือจาก Agent จะใช้ได้เฉพาะเมื่อแผนการตอบสนองของสถานที่อนุญาตให้เวิร์กโฟลว์รับทราบ ปิด และแจ้งเตือนภัยได้ หากต้องการปิดเหตุการณ์ ให้ใช้ duress_resolve_incident

อ่านปุ่ม Duress ที่สถานที่ ได้แก่ สถานะ (แบตเตอรี่ การรับสัญญาณล่าสุด การทดสอบล่าสุด) โปรไฟล์ทั้งหมด (ป้ายชื่อ ห้อง โซน ตำแหน่งติดตั้ง กล้อง ประตู และหน้าจอที่เชื่อมโยง การแจ้งเตือนที่ปิดเสียง สถานะการกำกับดูแล) สิ่งที่เชื่อมโยงได้ หน้าจอที่ส่งต่อการกดปุ่ม และการทดสอบการตั้งค่าของปุ่มที่เพิ่มใหม่

แบตเตอรี่: low คือ 30% หรือน้อยกว่า (ควรเปลี่ยนเร็ว ๆ นี้) critical คือ 20% หรือน้อยกว่า (ต้องเปลี่ยนทันที) หากแบตเตอรี่และ lastSeenAt เป็น null แสดงว่ายังไม่มีหน้าจอใดรับสัญญาณจากปุ่ม เวลาเป็นแบบ ISO

การดำเนินการ:

• status: สถานะปุ่ม แต่ละปุ่มพร้อมโซน ห้อง แบตเตอรี่ เวลาที่หน้าจอรับสัญญาณล่าสุด และเวลาที่ทดสอบล่าสุด เช่น "ปุ่ม Duress ใช้งานได้หรือไม่" "ปุ่มใดต้องเปลี่ยนแบตเตอรี่"
• list: โปรไฟล์ปุ่ม โปรไฟล์ทั้งหมดของแต่ละปุ่ม: สิ่งที่ duress_buttons_write update เปลี่ยนได้ พร้อมสัญญาณ หน้าจอที่รับสัญญาณในวันที่ผ่านมา สถานะการกำกับดูแล และการทดสอบการตั้งค่าที่รออยู่
• link_options: ตัวเลือกการเชื่อมโยง กล้อง ประตู หน้าจอ และโซนการเข้าถึงของสถานที่ที่เชื่อมโยงกับปุ่มได้ (ID สำหรับ duress_buttons_write update)
• receivers: ตัวรับสัญญาณปุ่ม หน้าจอแสดงผลที่สถานที่ซึ่งรับสัญญาณปุ่มและส่งต่อการกด และสถานะออนไลน์ของแต่ละหน้าจอ ready จะเป็น false เมื่อไม่มีสิ่งใดรับสัญญาณปุ่มได้
• setup_test: การทดสอบการตั้งค่า การทดสอบการตั้งค่าของปุ่มที่เพิ่มใหม่: waiting (การกดครั้งแรกเป็นเพียงการทดสอบ) received, expired, ended หรือ none และหน้าจอได้รับสัญญาณจากปุ่มตั้งแต่เพิ่มเข้ามาหรือไม่ ต้องระบุ deviceSerialNumber

เปลี่ยนแปลงปุ่ม Duress ที่สถานที่ ได้แก่ เพิ่มปุ่มใหม่ แก้ไขโปรไฟล์ (ป้ายชื่อ ห้อง โซน ตำแหน่งติดตั้ง หมายเหตุ กล้อง ประตู หน้าจอ และโซนการเข้าถึงที่เชื่อมโยง การแจ้งเตือนอุปกรณ์ที่ปิดเสียง) สั่งให้ปุ่มส่งเสียงบี๊บเพื่อให้พนักงานค้นหาได้ สิ้นสุดการทดสอบการตั้งค่าของปุ่มใหม่เพื่อเริ่มใช้งานจริง และนำปุ่มออก

ฟิลด์ที่ไม่ได้ระบุใน update จะคงค่าเดิมไว้ ส่วน null คือล้างค่า อ่านโปรไฟล์ปัจจุบันได้ด้วย duress_buttons_read list

การดำเนินการ:

• update: อัปเดตปุ่ม บันทึกโปรไฟล์ของปุ่มที่สถานที่ที่ลงทะเบียนไว้ (ต้องมี Duress Configuration ที่สถานที่นั้น) zone คือ 001 ถึง 999 และต้องไม่ซ้ำกันในสถานที่ alertsMutedUntil (ISO ล่วงหน้าไม่เกิน 30 วัน) จะปิดเสียงการแจ้งเตือนแบตเตอรี่และการออฟไลน์ ต้องระบุ deviceSerialNumber
• locate: สั่งให้ปุ่มส่งเสียงบี๊บ ทำให้ปุ่มส่งเสียงบี๊บและกะพริบเป็นเวลา 30 วินาทีเพื่อให้พนักงานค้นหาได้ เช่น ปุ่มที่รายงานแบตเตอรี่ต่ำอยู่เรื่อย ๆ หน้าจอที่อยู่ใกล้จะเป็นผู้ส่งคำสั่ง ปุ่มจึงต้องอยู่ในระยะของหน้าจอ ใช้ไม่ได้ขณะที่ปุ่มมีการแจ้งเตือนภัยที่เปิดอยู่ ต้องระบุ deviceSerialNumber
• go_live: เริ่มใช้งานปุ่มใหม่จริง สิ้นสุดการทดสอบการตั้งค่าของปุ่มที่เพิ่มใหม่ทันที การกดครั้งถัดไปจะเป็นการแจ้งเตือนภัยจริง ตรวจสอบ duress_buttons_read setup_test ก่อน ต้องมี การจัดการอุปกรณ์ หรือ Duress Configuration ที่สถานที่ ต้องระบุ deviceSerialNumber จะขอการยืนยัน
• remove: นำปุ่มออก ยกเลิกการจับคู่ปุ่มกับสถานที่และลบโปรไฟล์ ซึ่งจะทำให้โซนของปุ่มว่าง ใช้ไม่ได้ขณะที่ปุ่มมีการแจ้งเตือนภัยที่เปิดอยู่ ต้องมี การจัดการอุปกรณ์ ที่สถานที่ ต้องระบุ deviceSerialNumber จะขอการยืนยัน
• add: เพิ่มปุ่ม ลงทะเบียนปุ่ม Duress ใหม่ที่สถานที่ด้วยหมายเลขซีเรียลที่พิมพ์อยู่บนปุ่ม โดยค่าเริ่มต้น การกดครั้งแรกภายใน 30 นาทีถัดไปจะเป็นเพียงการทดสอบ (setupTest) สถานที่ต้องมีหน้าจอที่เปิด Duress alarm monitoring หรือมี IoT Gateway ต้องมี การจัดการอุปกรณ์ ที่สถานที่ ต้องระบุ deviceSerialNumber จะขอการยืนยัน

สิ้นสุดการทดสอบ Duress ที่กำลังทำงานอยู่ที่สถานที่ทันที การกดครั้งถัดไปจะเป็นการแจ้งเตือนภัยจริง ผลลัพธ์จะตามมาในอีกประมาณ 10 นาที เช่นเดียวกับการทดสอบทั่วไป

อ่านเหตุการณ์แจ้งเตือนภัย Duress (พนักงานกดปุ่ม Duress หรือเวิร์กโฟลว์แจ้งเตือนภัย) ได้แก่ รายการเหตุการณ์ ไทม์ไลน์และการส่งการแจ้งเตือนของเหตุการณ์หนึ่ง รายงานการทบทวนหลังเหตุการณ์ และภาพจากกล้องวงจรปิดในช่วงที่เกิดการแจ้งเตือนภัย

สถานะ: open (ยังไม่มีผู้รับทราบ) acknowledged (มีผู้กำลังตอบสนอง) resolved (ปิดแล้ว พร้อมผลสรุป: genuine, false_alarm, test หรือ unknown) active หมายถึง open หรือ acknowledged เหตุการณ์ทดสอบ (isTest) มาจากการทดสอบปุ่ม ส่วน testType 'unplanned' คือการแจ้งเตือนภัยที่แจ้งเป็นเหตุจริงแต่ผู้ตอบสนองปิดเป็นการทดสอบ

สถานะการส่ง: sent, acknowledged (ผู้รับยืนยันแล้ว), failed (ดู error), shadow (การทดลองโดยไม่ส่งจริง ไม่มีสิ่งใดถูกส่ง) การส่งไปยังศูนย์เฝ้าระวังจะรวมยอดไว้ใน monitoringCentre ด้วย ผลลัพธ์จะระบุชื่อบุคคล แต่จะไม่รวมหมายเลขโทรศัพท์หรืออีเมล เวลาเป็นแบบ ISO

การดำเนินการ:

• list: แสดงรายการเหตุการณ์ เรียงจากล่าสุด scope: facility (ค่าเริ่มต้น สถานที่ที่ระบุหรือที่เชื่อมต่ออยู่) หรือ organisation (ทุกสถานที่ในองค์กรที่คุณมองเห็นได้ ค่าเริ่มต้นคือองค์กรของสถานที่)
• get: ดูเหตุการณ์ สถานะ ปุ่มที่ถูกกด ไทม์ไลน์ (การกด การยกระดับ การรับทราบ หมายเหตุ) และความพยายามในการส่งการแจ้งเตือนหรือส่งไปยังศูนย์เฝ้าระวังทุกครั้งพร้อมผลลัพธ์ ต้องระบุ incidentId
• report: รายงานเหตุการณ์ สำหรับการทบทวนหลังเหตุการณ์: เหตุการณ์ จำนวนวินาทีจนถึงการรับทราบและการปิด ขั้นตอนที่ไปถึง ทุกรายการในไทม์ไลน์ สิ่งที่ส่งในแต่ละช่องทางและสิ่งที่ล้มเหลว และมีการเก็บภาพไว้หรือไม่ ใช้ร่วมกับ duress_incidents_write add_note เพื่อบันทึกการทบทวนไว้ในเหตุการณ์ ต้องระบุ incidentId
• footage_previews: ภาพของการแจ้งเตือนภัย แต่ละกล้องในภาพของการแจ้งเตือนภัย: สถานะ จำนวนเฟรมและคลิป คลิปที่อัปโหลดแล้ว และเฟรมที่ใกล้กับเวลากดปุ่มที่สุด (posterSeconds) เมื่อระบุ cameraId จะแสดงเฉพาะกล้องนั้นพร้อมเวลา Unix เป็นวินาทีของทุกเฟรม (frameSeconds) ต้องมีกล้องวงจรปิดที่สถานที่ ต้องระบุ incidentId
• footage_frame: เฟรมภาพของการแจ้งเตือนภัย เฟรม Timelapse หนึ่งเฟรมจากภาพของการแจ้งเตือนภัย ส่งคืนเป็นรูปภาพ: สำเนาที่เก็บไว้เมื่อเก็บภาพแล้ว มิฉะนั้นจะเป็นเฟรมสดภายในช่วงเวลาของการแจ้งเตือนภัย seconds คือค่า posterSeconds หรือ frameSeconds จาก footage_previews ต้องระบุ incidentId, cameraId, seconds

เปลี่ยนแปลงเหตุการณ์ Duress โดยไม่กระทบการแจ้งเตือนภัย ได้แก่ ตั้งชื่อเหตุการณ์ เพิ่มหมายเหตุของพนักงาน และเก็บหรือปล่อยภาพจากกล้องวงจรปิดในช่วงเหตุการณ์ จะไม่มีผู้ใดได้รับการแจ้งเตือน หากต้องการรับทราบ ปิด หรือแจ้งผู้ตอบสนอง ให้ใช้ duress_acknowledge_incident, duress_resolve_incident หรือ duress_post_update

การดำเนินการ:

• rename: ตั้งชื่อเหตุการณ์ ตั้งชื่อเหตุการณ์เพื่อให้ค้นหาได้ง่ายในภายหลัง เช่น "ผู้มาเยือนก้าวร้าวที่เคาน์เตอร์หน้า" ชื่อที่ว่างหรือเป็น null จะลบชื่อออก ชื่อจะแสดงในคอนโซล Duress และรายงาน ต้องระบุ incidentId
• add_note: เพิ่มหมายเหตุ เพิ่มหมายเหตุในไทม์ไลน์ของเหตุการณ์ เช่น สิ่งที่ผู้ใช้พบหรือผู้ที่เข้าไปดูแล ใช้ได้กับทุกสถานะ เฉพาะพนักงานเท่านั้นที่เห็นหมายเหตุ และหมายเหตุไม่เปลี่ยนแปลงเหตุการณ์ เขียนตามถ้อยคำของผู้ใช้และยืนยันถ้อยคำกับผู้ใช้ก่อน ต้องระบุ incidentId, note
• keep_footage: เก็บภาพของการแจ้งเตือนภัย เก็บภาพจากกล้องวงจรปิดในช่วงการแจ้งเตือนภัยจริงที่ปิดแล้ว เพื่อไม่ให้ถูกลบไปพร้อมการบันทึกปกติ โดยใช้จำนวนนาทีและกล้องตามแผนการตอบสนอง จะดำเนินการในอีกไม่กี่นาทีเมื่ออัปโหลดเสร็จ ใช้ไม่ได้กับการทดสอบ การแจ้งเตือนภัยที่เปิดอยู่ หรือภาพที่เก็บหรือปล่อยไปแล้ว ต้องระบุ incidentId
• release_footage: ปล่อยภาพที่เก็บไว้ สละภาพที่เก็บไว้สำหรับการแจ้งเตือนภัย คลิปจะกลับไปใช้ระยะเวลาการเก็บรักษาปกติและเฟรมที่เก็บไว้จะถูกลบ จึงดูไม่ได้อีกเมื่อการบันทึกปกติหมดอายุ ต้องมี Duress Configuration ที่สถานที่ ต้องระบุ incidentId จะขอการยืนยัน

ยกเลิกการล็อกดาวน์ของการแจ้งเตือนภัย Duress ประตูที่ถูกล็อกจะให้ผู้คนเข้าได้อีกครั้ง ใช้ได้ไม่ว่าการแจ้งเตือนภัยจะมีสถานะใด

ยืนยันก่อน เรียกโดยไม่ใช้ confirm เพื่อดูการล็อกดาวน์ แจ้งผู้ใช้ แล้วเรียกอีกครั้งด้วย confirm: true เมื่อผู้ใช้ยินยอม

โพสต์ข้อความอัปเดตถึงผู้ที่ตอบสนองต่อการแจ้งเตือนภัย Duress เช่น "ตำรวจกำลังเดินทางมา" หรือ "ปลอดภัยแล้ว บุคคลดังกล่าวออกไปแล้ว" ข้อความจะแสดงบนหน้าการแจ้งเตือนภัยและในแอป Duress และสำหรับการแจ้งเตือนภัยจริง แผนการตอบสนองยังส่ง SMS ถึงทุกคนที่เคยได้รับ SMS เกี่ยวกับการแจ้งเตือนภัยนี้ได้ด้วย โพสต์ข้อความอัปเดตได้จนถึง 24 ชั่วโมงหลังจากปิดการแจ้งเตือนภัย

ยืนยันก่อน เรียกโดยไม่ใช้ confirm เพื่อตรวจสอบเหตุการณ์ แสดงถ้อยคำที่แน่นอนให้ผู้ใช้ดู แล้วเรียกอีกครั้งด้วย confirm: true เมื่อผู้ใช้ยินยอม สำหรับสิ่งที่ควรให้เฉพาะพนักงานเห็น ให้ใช้ duress_incidents_write add_note แทน

แจ้งเตือนภัย Duress จริงที่สถานที่ เหมือนกับมีการกดปุ่ม แผนการตอบสนองจะทำงาน (แจ้งเตือนบุคคล ตามด้วยการยกระดับและการแจ้งเตือนซ้ำ และดำเนินการตอบสนอง) และการแจ้งเตือนภัยจะระบุว่าแจ้งโดยเวิร์กโฟลว์นี้ พร้อมเหตุผล

• reason: สิ่งที่เกิดขึ้น เช่น "ประตูทางออกด้านหลังถูกงัดเปิด" (ไม่เกิน 200 ตัวอักษร)
• deviceSerialNumber: ไม่บังคับ ปุ่มที่จะใช้ตำแหน่ง เฉพาะเมื่อระบุนี้เท่านั้นจึงจะแจ้งศูนย์เฝ้าระวังด้วย พร้อมโซนของปุ่มนั้น

ใช้ได้เฉพาะเป็นขั้นตอนในเวิร์กโฟลว์ ที่สถานที่ซึ่งแผนการตอบสนองอนุญาตให้เวิร์กโฟลว์รับทราบ ปิด และแจ้งเตือนภัยได้ ขณะที่การแจ้งเตือนภัยของเวิร์กโฟลว์นี้ยังเปิดอยู่ จะไม่แจ้งเตือนภัยซ้ำ แต่จะส่งคืนการแจ้งเตือนภัยนั้นแทน

รายงานการปฏิบัติตามข้อกำหนดของ Duress สำหรับสถานที่ แบรนด์ หรือองค์กร ได้แก่ เวลาตอบสนอง (P50/P95) เหตุการณ์ตามผลสรุปและอัตราการแจ้งเตือนผิดพลาด ความครอบคลุมของการทดสอบและสถานที่ที่เลยกำหนด ระยะเวลาการทำงานของปุ่ม ความสำเร็จในการส่งไปยังศูนย์เฝ้าระวัง และการส่งออกแยกรายเหตุการณ์ รวมถึงการแจ้งเตือนที่ส่งไม่ถึงของการแจ้งเตือนภัยล่าสุดที่สถานที่หนึ่ง

วันอิงตามเวลาท้องถิ่นของสถานที่ ช่วงเวลาที่เกิน 400 วันจะถูกตัดให้สั้นลง (range.capped) เหตุการณ์จริงและเหตุการณ์ทดสอบจะนับแยกกัน ระยะเวลาเป็น ms (p50Ms, p95Ms) รายงานระดับแบรนด์จะครอบคลุมเฉพาะสถานที่ที่คุณเข้าถึงได้ เว้นแต่คุณมีสิทธิ์เข้าถึงทั้งองค์กร (scope.restrictedToAccessibleFacilities)

การดำเนินการ:

• overview: ภาพรวมรายงาน Duress ยอดรวม แนวโน้มรายเดือน และตัวชี้วัดแยกตามองค์กร แบรนด์ และสถานที่ (incidents, testCoverage, deviceUptime, deliveries) สถานที่จะแบ่งหน้า
• compliance_summary: สรุปการปฏิบัติตามข้อกำหนดของ Duress สิ่งที่ PDF การปฏิบัติตามข้อกำหนดแสดง: ความครอบคลุมของการทดสอบพร้อมสถานที่ที่เลยกำหนด ระยะเวลาการทำงานของปุ่ม ความสำเร็จในการส่ง การทดสอบล่าสุด (testHistory) และสำหรับแต่ละสถานที่ คือการทดสอบ การซ้อม และการแจ้งเตือนภัยจริงครั้งล่าสุด พร้อมระยะเวลาการทำงานของแต่ละปุ่ม สถานที่จะแบ่งหน้า
• incident_export: ส่งออกเหตุการณ์ Duress หนึ่งแถวต่อหนึ่งเหตุการณ์ เรียงจากเก่าสุด พร้อมคอลัมน์ของการส่งออก CSV ได้แก่ สถานที่ ทดสอบหรือจริง สถานะ ผลสรุป เวลาท้องถิ่น จำนวนวินาทีจนถึงการรับทราบและการปิด ผู้รับทราบและผู้ปิด ปุ่ม และจำนวนการส่ง
• delivery_problems: การแจ้งเตือนภัยที่ส่งไม่ถึง การแจ้งเตือนภัยหรือการทดสอบล่าสุดของสถานที่ (พร้อมช่วงเวลาทดสอบทั้งหมด) และการแจ้งเตือนที่ไม่เคยไปถึง แยกตามช่องทาง problems จะเป็น null เมื่อทุกอย่างส่งถึงแล้ว ต้องมี Duress หรือ Duress Configuration ที่สถานที่นั้น

ปิดเหตุการณ์ Duress โดยปิดการแจ้งเตือนภัย หยุดการยกระดับ และบันทึกผลสรุป ปิดได้ทั้งเหตุการณ์ที่เปิดอยู่และที่รับทราบแล้ว

• disposition: genuine (เหตุฉุกเฉินจริง), false_alarm, test หรือ unknown
• note: สิ่งที่เกิดขึ้น จำเป็นสำหรับการแจ้งเตือนภัยจริง

ยืนยันก่อนเสมอ เรียกโดยไม่ใช้ confirm เพื่อดูเหตุการณ์ แจ้งผู้ใช้ว่ากำลังปิดการแจ้งเตือนภัยใดและผลสรุปคืออะไร แล้วเรียกอีกครั้งด้วย confirm: true หลังจากผู้ใช้ยินยอมแล้วเท่านั้น

ในเวิร์กโฟลว์หรือจาก Agent จะใช้ได้เฉพาะเมื่อแผนการตอบสนองของสถานที่อนุญาตให้เวิร์กโฟลว์รับทราบ ปิด และแจ้งเตือนภัยได้

อ่านการตั้งค่า Duress ได้แก่ แผนการตอบสนอง (ผู้ที่ได้รับการแจ้งเตือน ลำดับ และวิธีการ ที่สถานที่หรือเป็นเทมเพลตของแบรนด์) แผนที่ระบบแจ้งเตือนภัยใช้จริง บุคคลและบทบาทที่เพิ่มได้ การแจ้งเตือนอุปกรณ์ (ปัญหาแบตเตอรี่ การออฟไลน์ ความครอบคลุม และการส่ง) กฎผู้ติดต่อของแบรนด์และสถานะแผน ภาพรวมปุ่มของแบรนด์หรือองค์กร และปลายทางที่การแจ้งเตือนภัยส่งไปยังศูนย์เฝ้าระวัง

สถานที่จะใช้ตามเทมเพลตของแบรนด์ (หรือขององค์กร) ขยายเทมเพลตด้วยผู้ติดต่อเพิ่มเติม (mode extend) หรือแทนที่ด้วยแผนของตัวเอง (mode replace) เปลี่ยนการตั้งค่าได้ด้วย duress_settings_write เวลาเป็นแบบ ISO

การดำเนินการ:

• response_plan: แผนการตอบสนอง แผนที่มีผลบังคับใช้ที่สถานที่ (effective) และสิ่งที่แต่ละระดับมี (sources: facility, brand, organisation) หรือเมื่อระบุเฉพาะ brandId จะเป็นเทมเพลตของแบรนด์ ผู้ติดต่อจะแสดงตามที่บันทึกไว้ พร้อมแก้ไขและบันทึกกลับ
• resolved_plan: แผนที่ใช้จริง ผู้ที่ระบบแจ้งเตือนภัยติดต่อที่สถานที่ทีละระดับ: บทบาทที่ขยายเป็นรายบุคคล ช่องทางที่ติดต่อแต่ละคนได้ ระยะเวลาหน่วง และคำเตือนที่ต้องแก้ไขก่อนเกิดการแจ้งเตือนภัย แสดงเฉพาะชื่อ ไม่มีหมายเลขโทรศัพท์หรืออีเมล
• contact_options: ตัวเลือกผู้ติดต่อ บุคคลและบทบาทที่เพิ่มในแผนของสถานที่ได้ (ต้องมี Duress Configuration ที่สถานที่นั้น) หรือเมื่อระบุเฉพาะ brandId จะเป็นการเพิ่มในเทมเพลตของแบรนด์ หลังจากใช้กฎผู้ติดต่อของแบรนด์แล้ว
• device_alerts: การแจ้งเตือนอุปกรณ์ ผู้ที่ได้รับแจ้งเรื่องแบตเตอรี่ต่ำ ปุ่มออฟไลน์ ความครอบคลุมขาดหาย และการส่งที่ล้มเหลว: กฎในแต่ละระดับและผู้รับที่ใช้จริงของสถานที่ หรือเมื่อระบุเฉพาะ brandId จะเป็นกฎของแบรนด์
• contact_rules: กฎผู้ติดต่อของแบรนด์ บทบาทที่สถานที่ในแบรนด์เพิ่มในแผนได้: allowAllExcept จะซ่อนบทบาทที่ระบุ ส่วน manual จะเสนอเฉพาะบทบาทเหล่านั้น ต้องมีสิทธิ์เดียวกับการแก้ไขแผนของแบรนด์ ต้องระบุ brandId
• plan_status: สถานะแผนของแบรนด์ แต่ละสถานที่ในแบรนด์: ใช้ตามเทมเพลต ขยายเทมเพลต หรือมีแผนของตัวเอง จำนวนผู้ติดต่อที่เพิ่ม และคำเตือนของแผน ต้องระบุ brandId
• buttons_summary: ภาพรวมปุ่ม ทุกสถานที่ในแบรนด์หรือองค์กร: ปุ่ม จำนวนแบตเตอรี่ต่ำและออฟไลน์ การทดสอบครั้งถัดไปและครั้งล่าสุด เป็นข้อมูลของภาพรวม Brands & Customisation และภาพรวมองค์กร
• monitoring: การกำหนดเส้นทางไปยังศูนย์เฝ้าระวัง วิธีที่การแจ้งเตือนภัยออกจากสถานที่: eaAlarmType none, cid (การโทรไปยังศูนย์เฝ้าระวังผ่าน eaAlarmProvider) หรือ relay (แผงควบคุมแบบเดินสายผ่าน eaRelayModel) และผู้ให้บริการที่ใช้ได้

เปลี่ยนการตั้งค่า Duress ได้แก่ แผนการตอบสนอง (ที่สถานที่ หรือเทมเพลตของแบรนด์หรือองค์กร) การแจ้งเตือนอุปกรณ์ กฎผู้ติดต่อของแบรนด์ และปลายทางที่การแจ้งเตือนภัยส่งไปยังศูนย์เฝ้าระวัง ทุกการเปลี่ยนแปลงจะขอการยืนยัน เพราะเปลี่ยนผู้ที่ได้รับการแจ้งเตือน

ระบุ facilityId (ค่าเริ่มต้น: สถานที่ที่เชื่อมต่ออยู่), brandId หรือ organisationId อย่างใดอย่างหนึ่ง แผนของสถานที่ต้องมี Duress Configuration ที่สถานที่นั้น เทมเพลตต้องเป็นผู้ดูแลองค์กรที่มี Duress Configuration หรือสำหรับแบรนด์ ต้องมี Duress Configuration ที่ทุกสถานที่ในแบรนด์ อ่านก่อนด้วย duress_settings_read

การดำเนินการ:

• save_response_plan: บันทึกแผนการตอบสนอง ระดับของผู้ติดต่อที่ได้รับการแจ้งเตือนหลังการกด afterSeconds (เรียงจากน้อยไปมาก ระดับแรกมักเป็น 0) ackRequired, reminders และ responseActions หรือสถานที่สามารถขยายเทมเพลต (mode extend) ด้วยรายการเพิ่มเติมแทนได้ ฟิลด์ที่ไม่ได้ระบุจะคงค่าที่บันทึกไว้ ส่วน responseActions จะรวมตามการดำเนินการ จะขอการยืนยัน
• remove_response_plan: นำแผนการตอบสนองออก ลบแผนที่บันทึกไว้ในระดับนี้ สถานที่จะกลับไปใช้ตามเทมเพลต และแบรนด์จะกลับไปใช้ขององค์กร จะขอการยืนยัน
• save_device_alerts: บันทึกการแจ้งเตือนอุปกรณ์ แทนที่กฎการแจ้งเตือนอุปกรณ์ในระดับนี้: สูงสุด 10 กฎ แต่ละกฎเป็นชุดของเหตุการณ์และผู้ติดต่อ (push, sms หรือ email) คง ID ของกฎที่อ่านจาก duress_settings_read device_alerts ไว้ ต้องระบุ rules จะขอการยืนยัน
• remove_device_alerts: นำการแจ้งเตือนอุปกรณ์ออก ลบกฎการแจ้งเตือนอุปกรณ์ในระดับนี้ เพื่อกลับไปใช้ตามระดับที่สูงกว่าถัดไป จะขอการยืนยัน
• save_contact_rules: บันทึกกฎผู้ติดต่อของแบรนด์ บทบาทที่สถานที่ของแบรนด์เพิ่มในแผนได้: allowAllExcept จะซ่อน roleIds ส่วน manual จะเสนอเฉพาะ roleIds ผู้ติดต่อที่บันทึกไว้แล้วจะยังคงอยู่ และแผนที่ใช้จริงจะรีเฟรช ต้องระบุ brandId, mode, roleIds จะขอการยืนยัน
• save_monitoring: บันทึกการกำหนดเส้นทางไปยังศูนย์เฝ้าระวัง ปลายทางของการแจ้งเตือนภัย: eaAlarmType none, cid (ต้องระบุ eaAlarmProvider ซึ่งเป็นหนึ่งในผู้ให้บริการที่ duress_settings_read monitoring แสดง) หรือ relay (eaRelayModel) ต้องมี Duress Configuration ที่สถานที่ ต้องระบุ eaAlarmType จะขอการยืนยัน

ล็อกดาวน์สถานที่สำหรับการแจ้งเตือนภัย Duress ทุกประตูจะหยุดให้ผู้คนเข้าจนกว่าจะยกเลิกการล็อกดาวน์ (duress_lift_lockdown หรือจากคอนโซล) การแจ้งเตือนภัยหนึ่งครั้งจะล็อกดาวน์ได้เพียงครั้งเดียว

ห้ามใช้กับการแจ้งเตือนภัยที่เป็นการทดสอบหรือปิดแล้ว ต้องมี Door/Gate Access ที่สถานที่

ยืนยันก่อน เรียกโดยไม่ใช้ confirm เพื่อตรวจสอบเหตุการณ์ แจ้งผู้ใช้ว่าทุกประตูจะถูกล็อก แล้วเรียกอีกครั้งด้วย confirm: true เมื่อผู้ใช้ยินยอม

เริ่มการทดสอบ Duress ที่สถานที่ทันที จนกว่าการทดสอบจะสิ้นสุด ทุกการกดจะเป็นการทดสอบ ไม่ใช่การแจ้งเตือนภัยจริง:

• walk: พนักงานกดทีละปุ่ม เฉพาะขั้นตอนแรกของแผนการตอบสนองเท่านั้นที่ได้รับการแจ้งเตือน โดยมีป้ายกำกับ TEST
• drill: แผนการตอบสนองทั้งหมดจะทำงาน โดยมีป้ายกำกับ TEST

ผู้ติดต่อสำหรับการทดสอบของสถานที่จะได้รับแจ้งว่าการทดสอบเริ่มแล้ว และได้รับผลลัพธ์ประมาณ 10 นาทีหลังจากการทดสอบสิ้นสุด ทดสอบได้ครั้งละหนึ่งรายการต่อสถานที่ สิ้นสุดก่อนเวลาได้ด้วย duress_end_test และจองการทดสอบล่วงหน้าได้ด้วย duress_tests_write

ยืนยันก่อน เรียกโดยไม่ใช้ confirm แจ้งผู้ใช้ว่าการกดจะไม่แจ้งเตือนภัยจริงเป็นเวลา durationMinutes แล้วเรียกอีกครั้งด้วย confirm: true เมื่อผู้ใช้ยินยอม ในเวิร์กโฟลว์หรือจาก Agent จะใช้ได้เฉพาะเมื่อแผนการตอบสนองของสถานที่อนุญาตให้เวิร์กโฟลว์รับทราบ ปิด และแจ้งเตือนภัยได้

อ่านการทดสอบปุ่ม Duress ได้แก่ กำหนดการที่จองการทดสอบ (walk, comms หรือ drill ครั้งเดียวหรือซ้ำ สำหรับองค์กร แบรนด์ หรือสถานที่) ช่วงเวลาทดสอบที่กำหนดการสร้างขึ้นในแต่ละสถานที่ (scheduled, active, completed, cancelled รวมถึงการทดสอบเฉพาะกิจ) และผลลัพธ์ของช่วงเวลาทดสอบ (ปุ่มที่ถูกกดหรือพลาด ผู้ที่ได้รับแจ้ง สัญญาณของศูนย์เฝ้าระวัง เวลาการรับทราบ)

ไม่รวมข้อมูลผู้ที่จอง เปลี่ยน หรือยกเลิกการทดสอบ และข้อมูลผู้รับการส่งจะถูกปกปิด เวลาเป็นแบบ ISO ส่วน localDate และ localStartTime อิงตามเขตเวลาของสถานที่ จองหรือเปลี่ยนการทดสอบได้ด้วย duress_tests_write และเริ่มทดสอบทันทีได้ด้วย duress_start_test

การดำเนินการ:

• schedules: กำหนดการทดสอบ scope facility (ค่าเริ่มต้น ทุกกำหนดการที่ครอบคลุมสถานที่ รวมถึงกำหนดการที่ใช้ร่วมกันซึ่งสถานที่ข้ามหรือแทนที่) brand (brandId) หรือ organisation (ค่าเริ่มต้น: องค์กรของสถานที่) เรียงจากการเปลี่ยนแปลงล่าสุด
• windows: ช่วงเวลาทดสอบ ช่วงเวลาทดสอบของสถานที่จาก from ถึง to (ค่าเริ่มต้นประมาณหนึ่งสัปดาห์ก่อนถึงหนึ่งเดือนข้างหน้า) หรือเมื่อระบุเฉพาะ organisationId จะเป็นช่วงเวลาที่กำลังจะมาถึงขององค์กรในทุกสถานที่
• results: ผลการทดสอบ ช่วงเวลาทดสอบและผลลัพธ์: จัดเก็บเมื่อส่งแล้ว คำนวณแบบเรียลไทม์ขณะการทดสอบดำเนินอยู่ (รายการตรวจสอบของ walk-test) และเป็น null สำหรับช่วงเวลาที่ตั้งกำหนดการไว้หรือยกเลิกแล้ว ต้องมี Duress ที่สถานที่ ต้องระบุ startsAtKey

จอง เปลี่ยน และยกเลิกกำหนดการทดสอบ Duress กำหนดว่าสถานที่หนึ่งแห่งจะทำตามกำหนดการที่ใช้ร่วมกันอย่างไร และยกเลิกช่วงเวลาทดสอบที่กำลังจะมาถึงทีละช่วง ทุกการเปลี่ยนแปลงจะจองหรือเขียนช่วงเวลาในอนาคตใหม่และส่งอีเมลถึงผู้เกี่ยวข้อง ดังนั้นทุกการดำเนินการจะขอการยืนยัน

กำหนดการต้องมีสิทธิ์ Duress Configuration ครอบคลุมเป้าหมายทั้งหมด (ต้องเป็นผู้ดูแลระบบองค์กรสำหรับกำหนดการทั่วทั้งองค์กร) เวลาเป็นไปตามเขตเวลาของแต่ละสถานที่ อ่านกำหนดการและช่วงเวลาก่อนด้วย duress_tests_read และเริ่มการทดสอบทันทีด้วย duress_start_test

การดำเนินการ:

• create_schedule: จองกำหนดการทดสอบ จองช่วงเวลาล่วงหน้าได้ประมาณหนึ่งปีที่ทุกสถานที่ใน target และส่งอีเมลยืนยันการจอง ต้องระบุ name, type, target, startDate, localStartTime และ recurrence ต้องระบุ name, type, target, startDate, localStartTime, recurrence ขอการยืนยัน
• update_schedule: เปลี่ยนกำหนดการทดสอบ ฟิลด์ที่ไม่ได้ส่งจะคงค่าเดิม ช่วงเวลาในอนาคตจะถูกเขียนใหม่ (ช่วงเวลาที่เริ่มแล้วจะคงไว้) และผู้เกี่ยวข้องจะได้รับแจ้งการเปลี่ยนแปลง หลังจากนั้นให้ใช้ ownerScope ในผลลัพธ์ ต้องระบุ ownerScope, scheduleId ขอการยืนยัน
• cancel_schedule: ยกเลิกกำหนดการทดสอบ ยกเลิกกำหนดการและช่วงเวลาในอนาคต และส่งอีเมลแจ้งการยกเลิก สถานที่ที่มีสำเนาของตนเองจะยังคงสำเนานั้นไว้ ต้องระบุ ownerScope, scheduleId ขอการยืนยัน
• set_facility_override: เปลี่ยนกำหนดการที่ใช้ร่วมกันสำหรับสถานที่หนึ่งแห่ง mode follow (กลับมาใช้กำหนดการที่ใช้ร่วมกันที่นี่อีกครั้ง), skip (หยุดใช้ที่นี่) หรือ own (แทนที่ที่นี่ด้วยสำเนาที่สร้างจาก schedule) ต้องมีสิทธิ์ Duress Configuration ที่สถานที่นั้นเท่านั้น ต้องระบุ ownerScope, scheduleId, mode ขอการยืนยัน
• cancel_window: ยกเลิกช่วงเวลาทดสอบหนึ่งช่วง ยกเลิกการทดสอบที่กำหนดไว้หนึ่งครั้งที่สถานที่ (กำหนดการยังคงดำเนินต่อ) และส่งอีเมลถึงผู้เกี่ยวข้อง ต้องมีสิทธิ์ Duress ที่สถานที่ การทดสอบที่กำลังดำเนินอยู่ให้สิ้นสุดด้วย duress_end_test แทน ต้องระบุ startsAtKey ขอการยืนยัน

ปลดล็อกประตูสำหรับสัญญาณเตือน Duress เช่น เพื่อให้ตำรวจหรือหน่วยปฐมพยาบาลเข้ามาได้ โดยปลดล็อกประตูที่เชื่อมโยงกับปุ่มที่ถูกกด หรือหากไม่มีจะใช้ประตูในแผนการตอบสนอง ไม่ต้องส่ง doorIds เพื่อปลดล็อกทั้งหมด หรือระบุเฉพาะบางประตู การปลดล็อกแต่ละครั้งจะแสดงในไทม์ไลน์ของเหตุการณ์และในบันทึกการเข้าถึง

ห้ามใช้กับสัญญาณเตือนที่เป็นการทดสอบหรือได้รับการแก้ไขแล้ว ต้องมีสิทธิ์ Door/Gate Access ที่สถานที่

ยืนยันก่อน เรียกใช้โดยไม่มี confirm เพื่อดูว่าประตูใดจะถูกปลดล็อก แจ้งผู้ใช้ แล้วเรียกใช้อีกครั้งด้วย confirm: true เมื่อผู้ใช้ตกลง