Paksaan
Platform Intiduress_acknowledge_incidentPaksaanMengonfirmasi penerimaan insiden duress yang terbuka atas nama pengguna: mencatat bahwa pengguna sedang merespons dan dapat menghentikan eskalasi lebih lanjut. Hanya insiden terbuka yang dapat dikonfirmasi.
Selalu konfirmasi terlebih dahulu. Panggil tanpa confirm untuk mendapatkan insiden, beri tahu pengguna apa yang akan mereka konfirmasi, lalu panggil lagi dengan confirm: true hanya setelah mereka setuju.
Dalam workflow, atau dari Agent, ini hanya berfungsi jika rencana respons fasilitas mengizinkan workflow mengonfirmasi, menyelesaikan, dan memicu alarm. Untuk menutup insiden, gunakan duress_resolve_incident.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
incidentId* | string | ID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress. |
note | string | Catatan opsional, misalnya "Sedang menuju resepsionis" |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
duress_end_testPaksaanMengakhiri uji duress yang sedang berjalan di fasilitas sekarang, sehingga tekanan berikutnya adalah alarm sungguhan. Hasil menyusul sekitar 10 menit kemudian, seperti pada setiap uji.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. |
duress_incidents_readPaksaanMembaca insiden alarm duress (staf menekan tombol duress, atau workflow memicunya): daftar, linimasa dan pengiriman satu insiden, laporan postmortem, dan rekaman CCTV di sekitar alarm.
Status: open (belum ada yang mengonfirmasi), acknowledged (seseorang sedang merespons), resolved (ditutup, dengan disposisi: genuine, false_alarm, test, atau unknown). active berarti open atau acknowledged. Insiden uji (isTest) berasal dari uji tombol; testType 'unplanned' adalah alarm yang dipicu sebagai alarm sungguhan tetapi diselesaikan oleh responden sebagai uji.
Status pengiriman: sent, acknowledged (penerima mengonfirmasi), failed (lihat error), shadow (uji coba, tidak ada yang dikirim). Pengiriman ke pusat pemantauan juga dijumlahkan di monitoringCentre. Hasil menyebutkan nama orang tetapi tidak pernah menyertakan nomor telepon atau alamat email. Waktu dalam format ISO.
Tindakan:
- list: Cantumkan insiden. Terbaru lebih dulu. scope: facility (default; fasilitas yang diberikan atau terhubung) atau organisation (setiap fasilitas di dalamnya yang dapat Anda lihat; default ke organisasi fasilitas).
- get: Dapatkan insiden. Status, tombol yang ditekan, linimasa (tekanan, eskalasi, konfirmasi, catatan), dan setiap upaya pengiriman notifikasi atau ke pusat pemantauan beserta hasilnya. Memerlukan incidentId.
- report: Laporan insiden. Untuk postmortem: insiden, detik hingga dikonfirmasi dan diselesaikan, langkah yang dicapai, setiap entri linimasa, apa yang dikirim per saluran dan apa yang gagal, serta apakah rekaman disimpan. Gunakan bersama duress_incidents_write add_note untuk mencantumkan postmortem pada insiden. Memerlukan incidentId.
- footage_previews: Rekaman alarm. Setiap kamera dalam rekaman alarm: statusnya, jumlah frame dan klip, klip yang diunggah, dan frame yang paling dekat dengan tekanan (posterSeconds). Dengan cameraId, hanya kamera tersebut ditambah detik Unix setiap frame (frameSeconds). Memerlukan CCTV di fasilitas. Memerlukan incidentId.
- footage_frame: Frame rekaman alarm. Satu frame timelapse dari rekaman alarm, dikembalikan sebagai gambar: salinan yang disimpan setelah rekaman disimpan, jika tidak, frame langsung di dalam jendela alarm. seconds adalah nilai posterSeconds atau frameSeconds dari footage_previews. Memerlukan incidentId, cameraId, seconds.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "list" | "get" | "report" | "footage_previews" | "footage_frame" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
scope | "facility" | "organisation" | Nilai default: facility (list) |
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. (list) |
organisationId | string | Untuk scope organisation. Default ke organisasi fasilitas. (list) |
status | "active" | "open" | "acknowledged" | "resolved" | active berarti open atau acknowledged (list) |
from | string | Tanggal-waktu ISO: insiden yang dibuka pada atau setelah waktu ini (list) |
to | string | Tanggal-waktu ISO: insiden yang dibuka pada atau sebelum waktu ini (list) |
limit | integer | Item per halaman (default 25, maksimal 100) (list) |
cursor | string | nextCursor dari halaman sebelumnya (list) |
incidentId | string | ID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress. (get, report, footage_previews, footage_frame) |
cameraId | string | Kamera dalam rekaman alarm, dari footage_previews (footage_previews, footage_frame) |
seconds | integerstring | Waktu frame dalam detik Unix 10 digit (footage_frame) |
duress_incidents_writePaksaanDuress ConfigurationMengubah insiden duress tanpa memengaruhi alarmnya: memberinya nama, menambahkan catatan staf, dan menyimpan atau melepaskan rekaman CCTV di sekitarnya. Tidak ada yang diberi peringatan. Untuk mengonfirmasi, menyelesaikan, atau memberi tahu responden, gunakan duress_acknowledge_incident, duress_resolve_incident, atau duress_post_update.
Tindakan:
- rename: Beri nama insiden. Memberi nama insiden agar mudah ditemukan nanti, misalnya "Pengunjung agresif di konter depan". Nama kosong atau null menghapusnya. Nama ditampilkan di konsol Duress dan laporan. Memerlukan incidentId.
- add_note: Tambahkan catatan. Menambahkan catatan ke linimasa insiden, misalnya apa yang ditemukan pengguna atau siapa yang hadir. Status apa pun; hanya staf yang melihat catatan dan catatan tidak mengubah insiden. Tulis dengan kata-kata pengguna dan konfirmasikan susunan katanya kepada mereka terlebih dahulu. Memerlukan incidentId, note.
- keep_footage: Simpan rekaman alarm. Menyimpan rekaman CCTV di sekitar alarm sungguhan yang telah diselesaikan agar tidak terhapus bersama rekaman biasa, menggunakan menit dan kamera dari rencana respons. Terjadi beberapa menit kemudian, setelah diunggah. Tidak untuk uji, alarm terbuka, atau rekaman yang sudah disimpan atau dilepaskan. Memerlukan incidentId.
- release_footage: Lepaskan rekaman yang disimpan. Melepaskan rekaman yang disimpan untuk suatu alarm: klip kembali ke retensi normal dan frame yang disimpan dihapus, sehingga tidak dapat dilihat lagi setelah rekaman biasa kedaluwarsa. Memerlukan Duress Configuration di fasilitas. Memerlukan incidentId. Meminta konfirmasi.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "rename" | "add_note" | "keep_footage" | "release_footage" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
incidentId | string | ID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress. |
name | stringnull | Nama; kosong atau null menghapusnya (rename) |
note | string | Catatan (add_note) |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
duress_lift_lockdownPaksaanMencabut lockdown alarm duress: pintu yang dikuncinya kembali mengizinkan orang masuk. Berfungsi apa pun status alarmnya.
Konfirmasi terlebih dahulu. Panggil tanpa confirm untuk melihat lockdown, beri tahu pengguna, lalu panggil lagi dengan confirm: true setelah mereka setuju.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
incidentId* | string | ID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress. |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
duress_post_updatePaksaanMengirim pembaruan kepada orang-orang yang merespons alarm duress, misalnya "Polisi sedang dalam perjalanan" atau "Situasi aman, orang tersebut sudah pergi". Pembaruan muncul di halaman alarm mereka dan di aplikasi Duress, dan pada alarm sungguhan, rencana respons juga dapat mengirimkannya melalui SMS kepada semua orang yang sudah menerima SMS tentang alarm tersebut. Pembaruan dapat dikirim hingga 24 jam setelah alarm diselesaikan.
Konfirmasi terlebih dahulu. Panggil tanpa confirm untuk memeriksa insiden, tunjukkan susunan kata yang tepat kepada pengguna, lalu panggil lagi dengan confirm: true setelah mereka setuju. Untuk informasi yang hanya boleh dilihat staf, gunakan duress_incidents_write add_note.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
incidentId* | string | ID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress. |
text* | string | Pembaruan, kata demi kata |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
duress_raise_alarmPaksaanMemicu alarm duress sungguhan di fasilitas, seolah-olah tombol ditekan: rencana respons berjalan (orang-orang diberi peringatan, eskalasi dan pengingat menyusul, tindakan respons dijalankan) dan alarm menyatakan bahwa alarm dipicu oleh workflow ini, beserta alasannya.
- reason: apa yang terjadi, misalnya "Pintu dibuka paksa di pintu keluar belakang" (hingga 200 karakter).
- deviceSerialNumber: opsional. Tombol yang lokasinya akan digunakan; hanya dengan ini pusat pemantauan juga diberi tahu, dengan zona tombol tersebut.
Hanya sebagai langkah workflow, di fasilitas yang rencana responsnya mengizinkan workflow mengonfirmasi, menyelesaikan, dan memicu alarm. Selama alarm workflow ini masih terbuka, alat ini tidak akan memicu alarm lain; alat ini mengembalikan alarm tersebut.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. |
reason* | string | Apa yang terjadi |
deviceSerialNumber | string | Tombol di fasilitas (opsional) |
duress_reports_readPaksaanDuress ConfigurationPelaporan kepatuhan Duress untuk fasilitas, merek, atau organisasi: waktu respons (P50/P95), insiden menurut disposisi dan tingkat alarm palsu, cakupan uji dan fasilitas yang terlambat diuji, uptime tombol, keberhasilan pengiriman ke pusat pemantauan, dan ekspor per insiden. Ditambah peringatan alarm terbaru yang tidak terkirim di satu fasilitas.
Hari dihitung menurut waktu lokal fasilitas; periode lebih dari 400 hari dipersingkat (range.capped). Insiden sungguhan dan uji dihitung terpisah. Durasi dalam ms (p50Ms, p95Ms). Laporan merek hanya mencakup fasilitas yang dapat Anda akses, kecuali Anda memiliki akses di seluruh organisasi (scope.restrictedToAccessibleFacilities).
Tindakan:
- overview: Ikhtisar laporan Duress. Total, tren bulanan, dan metrik per organisasi, per merek, dan per fasilitas (incidents, testCoverage, deviceUptime, deliveries). Fasilitas ditampilkan berhalaman.
- compliance_summary: Ringkasan kepatuhan Duress. Isi PDF kepatuhan: cakupan uji dengan fasilitas yang terlambat diuji, uptime tombol, keberhasilan pengiriman, uji terbaru (testHistory), dan untuk setiap fasilitas, uji, latihan (drill), dan alarm sungguhan terakhirnya beserta uptime setiap tombol. Fasilitas ditampilkan berhalaman.
- incident_export: Ekspor insiden Duress. Satu baris per insiden, terlama lebih dulu, dengan kolom ekspor CSV: fasilitas, uji atau sungguhan, status, disposisi, waktu lokal, detik hingga dikonfirmasi dan diselesaikan, siapa yang mengonfirmasi dan menyelesaikan, jumlah tombol dan pengiriman.
- delivery_problems: Peringatan alarm yang tidak terkirim. Alarm atau uji terbaru fasilitas (dengan seluruh jendela ujinya) dan peringatan yang tidak pernah sampai, menurut saluran. problems bernilai null jika semuanya terkirim. Memerlukan Duress atau Duress Configuration di sana.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "overview" | "compliance_summary" | "incident_export" | "delivery_problems" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
scope | "facility" | "brand" | "organisation" | Default: id paling spesifik yang diberikan, jika tidak ada maka fasilitas yang terhubung. (overview, compliance_summary, incident_export) |
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. |
brandId | string | ID merek, untuk templat merek, bukan fasilitas (overview, compliance_summary, incident_export) |
organisationId | string | Memerlukan akses Duress di seluruh organisasi (overview, compliance_summary, incident_export) |
from | string | Hari pertama, YYYY-MM-DD waktu lokal fasilitas (default 30 hari sebelum to) (overview, compliance_summary, incident_export) |
to | string | Hari terakhir, YYYY-MM-DD waktu lokal fasilitas, inklusif (default hari ini) (overview, compliance_summary, incident_export) |
limit | integer | Item per halaman (default 25, maksimal 100) (overview, compliance_summary, incident_export) |
cursor | string | nextCursor dari halaman sebelumnya (overview, compliance_summary, incident_export) |
duress_resolve_incidentPaksaanMenyelesaikan insiden duress: menutup alarm, menghentikan eskalasi, dan mencatat hasilnya. Insiden yang terbuka dan yang sudah dikonfirmasi dapat diselesaikan.
- disposition:
genuine(keadaan darurat sungguhan),false_alarm,test, atauunknown. - note: apa yang terjadi. Wajib untuk alarm sungguhan.
Selalu konfirmasi terlebih dahulu. Panggil tanpa confirm untuk mendapatkan insiden, beri tahu pengguna alarm mana yang akan mereka tutup beserta hasilnya, lalu panggil lagi dengan confirm: true hanya setelah mereka setuju.
Dalam workflow, atau dari Agent, ini hanya berfungsi jika rencana respons fasilitas mengizinkan workflow mengonfirmasi, menyelesaikan, dan memicu alarm.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
incidentId* | string | ID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress. |
disposition* | "genuine" | "false_alarm" | "test" | "unknown" | Hasilnya |
note | string | Apa yang terjadi. Wajib jika disposisinya genuine. |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
duress_settings_readPaksaanDuress ConfigurationMembaca pengaturan Duress: rencana respons (siapa yang diberi peringatan, dalam urutan apa dan bagaimana, di fasilitas atau sebagai templat merek), rencana terselesaikan yang benar-benar digunakan mesin alarm, orang dan peran yang dapat ditambahkan, peringatan perangkat (baterai, offline, cakupan, dan masalah pengiriman), aturan kontak merek dan status rencana, ikhtisar tombol merek atau organisasi, serta tujuan alarm ke pusat pemantauan.
Fasilitas mengikuti templat mereknya (jika tidak ada, templat organisasinya), memperluasnya dengan kontak tambahan (mode extend), atau menggantinya dengan rencananya sendiri (mode replace). Ubah pengaturan dengan duress_settings_write. Waktu dalam format ISO.
Tindakan:
- response_plan: Rencana respons. Rencana yang berlaku di fasilitas (effective) dan isi setiap tingkat (sources: facility, brand, organisation), atau dengan hanya brandId, templat merek. Kontak ditampilkan sebagaimana disimpan, siap diedit dan disimpan kembali.
- resolved_plan: Rencana terselesaikan. Siapa yang dihubungi mesin alarm di fasilitas, tingkat demi tingkat: peran yang dijabarkan menjadi orang, saluran yang dapat digunakan untuk menghubungi masing-masing, penundaan, dan peringatan yang perlu diperbaiki sebelum alarm terjadi. Hanya nama, tanpa nomor telepon atau email.
- contact_options: Opsi kontak. Orang dan peran yang dapat ditambahkan ke rencana fasilitas (memerlukan Duress Configuration di sana), atau dengan hanya brandId, ke templat merek, setelah aturan kontak merek diterapkan.
- device_alerts: Peringatan perangkat. Siapa yang diberi tahu tentang baterai lemah, tombol offline, cakupan yang hilang, dan pengiriman yang gagal: aturan di setiap tingkat dan penerima terselesaikan fasilitas, atau dengan hanya brandId, aturan merek.
- contact_rules: Aturan kontak merek. Peran mana yang boleh ditambahkan fasilitas dalam merek ke rencana: allowAllExcept menyembunyikan peran yang dicantumkan, manual hanya menawarkan peran tersebut. Memerlukan izin yang sama dengan mengedit rencana merek. Memerlukan brandId.
- plan_status: Status rencana merek. Setiap fasilitas dalam merek: apakah mengikuti templat, memperluasnya, atau memiliki rencananya sendiri, berapa kontak yang ditambahkannya, dan peringatan rencananya. Memerlukan brandId.
- buttons_summary: Ikhtisar tombol. Setiap fasilitas dalam merek atau organisasi: jumlah tombol, baterai, dan offline, serta uji berikutnya dan terakhir. Data untuk ikhtisar Brands & Customisation dan organisasi.
- monitoring: Perutean pusat pemantauan. Cara alarm dikirim dari fasilitas: eaAlarmType none, cid (panggilan pusat pemantauan melalui eaAlarmProvider) atau relay (panel berkabel melalui eaRelayModel), serta penyedia yang dapat digunakan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "response_plan" | "resolved_plan" | "contact_options" | "device_alerts" | "contact_rules" | "plan_status" | "buttons_summary" | "monitoring" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. (response_plan, resolved_plan, contact_options, device_alerts, monitoring) |
brandId | string | ID merek, untuk templat merek, bukan fasilitas (response_plan, contact_options, device_alerts, contact_rules, plan_status, buttons_summary) |
organisationId | string | ID organisasi (buttons_summary) |
duress_settings_writeDuress ConfigurationMengubah pengaturan Duress: rencana respons (di fasilitas, atau templat merek atau organisasi), peringatan perangkat, aturan kontak merek, dan tujuan alarm ke pusat pemantauan. Setiap perubahan meminta konfirmasi karena mengubah siapa yang diberi peringatan.
Berikan salah satu dari facilityId (default: fasilitas yang terhubung), brandId, atau organisationId. Rencana fasilitas memerlukan Duress Configuration di sana; templat memerlukan admin organisasi dengan Duress Configuration, atau untuk merek, Duress Configuration di setiap fasilitas di dalamnya. Baca terlebih dahulu dengan duress_settings_read.
Tindakan:
- save_response_plan: Simpan rencana respons. Tingkat kontak yang diberi peringatan afterSeconds setelah tekanan (menaik, yang pertama biasanya 0), ackRequired, reminders, dan responseActions. Sebagai gantinya, fasilitas dapat memperluas templatnya (mode extend) dengan tambahan. Kolom yang tidak diisi mempertahankan nilai yang disimpan; responseActions digabungkan per tindakan. Meminta konfirmasi.
- remove_response_plan: Hapus rencana respons. Menghapus rencana yang disimpan di tingkat ini, sehingga fasilitas kembali mengikuti templatnya dan merek kembali ke templat organisasi. Meminta konfirmasi.
- save_device_alerts: Simpan peringatan perangkat. Menggantikan aturan peringatan perangkat di tingkat ini: hingga 10 aturan, masing-masing berupa sekumpulan peristiwa dan kontak (push, sms, atau email). Pertahankan id aturan yang dibaca dari duress_settings_read device_alerts. Memerlukan rules. Meminta konfirmasi.
- remove_device_alerts: Hapus peringatan perangkat. Menghapus aturan peringatan perangkat di tingkat ini, sehingga kembali mengikuti tingkat di atasnya. Meminta konfirmasi.
- save_contact_rules: Simpan aturan kontak merek. Peran mana yang dapat ditambahkan fasilitas merek ke rencana: allowAllExcept menyembunyikan roleIds, manual hanya menawarkan roleIds. Kontak yang sudah disimpan tetap ada; rencana terselesaikan diperbarui. Memerlukan brandId, mode, roleIds. Meminta konfirmasi.
- save_monitoring: Simpan perutean pusat pemantauan. Tujuan alarm: eaAlarmType none, cid (memerlukan eaAlarmProvider, salah satu penyedia yang dicantumkan duress_settings_read monitoring) atau relay (eaRelayModel). Memerlukan Duress Configuration di fasilitas. Memerlukan eaAlarmType. Meminta konfirmasi.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "save_response_plan" | "remove_response_plan" | "save_device_alerts" | "remove_device_alerts" | "save_contact_rules" | "save_monitoring" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_monitoring) |
brandId | string | ID merek, untuk templat merek, bukan fasilitas (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_contact_rules) |
organisationId | string | ID organisasi, untuk templat organisasi (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts) |
mode | "replace" | "extend" | Hanya rencana fasilitas: replace (tingkatnya sendiri) atau extend (tambahan pada templat) (save_response_plan, save_contact_rules) |
tiers | array | Tingkat rencana (mode replace dan templat) (save_response_plan) |
additions | array | Mode extend: kontak tambahan per tingkat templat (tierId dan afterSeconds dari tingkat tersebut) (save_response_plan) |
ackRequired | boolean | Apakah eskalasi berlanjut hingga seseorang mengonfirmasi (save_response_plan) |
reminders | objectnull | Ulangi peringatan setiap everySeconds (0 menonaktifkannya) hingga stopAfterSeconds (save_response_plan) |
responseActions | object | Tindakan menurut nama, masing-masing { enabled, ... }: unlockOnAcknowledge (doorIds), lockdown, staffScreenAlerts, buttonAcknowledge, dashboardCctv, dashboardDoorControls, dashboardResolve, updateTexts, aiSummary, workflowControl, retainFootage (minutesBefore, minutesAfter, cameras) (save_response_plan) |
rules | array | Aturan; daftar kosong tidak menyimpan aturan apa pun (tidak ada yang diberi peringatan di tingkat ini) (save_device_alerts) |
roleIds | array | Id peran yang dikenai mode tersebut (save_contact_rules) |
eaAlarmType | "none" | "cid" | "relay" | none, cid, atau relay (save_monitoring) |
eaAlarmProvider | stringnull | Untuk cid: kode penyedia (save_monitoring) |
eaRelayModel | "none" | "numato-rl80001" | Untuk relay: papan relay (save_monitoring) |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
duress_start_lockdownPaksaanMemberlakukan lockdown di fasilitas untuk alarm duress: setiap pintu berhenti mengizinkan orang masuk hingga lockdown dicabut (duress_lift_lockdown, atau dari konsol). Satu alarm hanya dapat memiliki satu lockdown.
Jangan pernah untuk alarm uji atau yang sudah diselesaikan. Memerlukan Door/Gate Access di fasilitas.
Konfirmasi terlebih dahulu. Panggil tanpa confirm untuk memeriksa insiden, beri tahu pengguna bahwa setiap pintu akan terkunci, lalu panggil lagi dengan confirm: true setelah mereka setuju.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
incidentId* | string | ID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress. |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
duress_start_testPaksaanMemulai uji duress di fasilitas sekarang. Hingga uji berakhir, setiap tekanan adalah uji, bukan alarm sungguhan:
walk: staf menekan setiap tombol; hanya langkah pertama rencana respons yang diberi peringatan, berlabel TEST.drill: seluruh rencana respons berjalan, berlabel TEST.
Kontak uji fasilitas diberi tahu bahwa uji telah dimulai dan menerima hasil sekitar 10 menit setelah uji berakhir. Satu uji dalam satu waktu per fasilitas. Akhiri lebih awal dengan duress_end_test; pesan uji di muka dengan duress_tests_write.
Konfirmasi terlebih dahulu. Panggil tanpa confirm, beri tahu pengguna bahwa tekanan tidak akan memicu alarm sungguhan selama durationMinutes, lalu panggil lagi dengan confirm: true setelah mereka setuju. Dalam workflow, atau dari Agent, ini hanya berfungsi jika rencana respons fasilitas mengizinkan workflow mengonfirmasi, menyelesaikan, dan memicu alarm.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. |
type | "walk" | "drill" | walk (default) atau drill |
durationMinutes | integer | Berapa lama tekanan dianggap uji (default 60) |
monitoringCentreMode | "test-codes" | "none" | `test-codes` mengirim sinyal uji ke pusat pemantauan; `none` tidak mengirim apa pun |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
duress_tests_readPaksaanDuress ConfigurationMembaca uji tombol duress: jadwal yang memesannya (walk, comms, atau drill, sekali atau berulang, untuk organisasi, merek, atau fasilitas), jendela uji yang dibuatnya di setiap fasilitas (terjadwal, aktif, selesai, dibatalkan, ditambah uji ad-hoc), dan hasil suatu jendela (tombol mana yang ditekan atau terlewat, siapa yang diberi tahu, sinyal pusat pemantauan, waktu konfirmasi).
Siapa yang memesan, mengubah, atau membatalkan uji tidak disertakan; penerima pengiriman disamarkan. Waktu dalam format ISO; localDate dan localStartTime dalam zona waktu fasilitas. Pesan atau ubah uji dengan duress_tests_write; mulai uji sekarang dengan duress_start_test.
Tindakan:
- schedules: Jadwal uji. scope facility (default; setiap jadwal yang mencakupnya, termasuk jadwal bersama yang dilewati atau digantikannya), brand (brandId) atau organisation (default: organisasi fasilitas). Perubahan terbaru lebih dulu.
- windows: Jendela uji. Jendela uji fasilitas dari
fromhinggato(default sekitar seminggu ke belakang hingga sebulan ke depan), atau dengan hanya organisationId, jendela mendatang organisasi di seluruh fasilitasnya. - results: Hasil uji. Suatu jendela dan hasilnya: disimpan setelah dikirim, dihitung secara langsung selama uji berjalan (daftar periksa uji walk), null untuk jendela yang terjadwal atau dibatalkan. Memerlukan Duress di fasilitas. Memerlukan startsAtKey.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "schedules" | "windows" | "results" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
scope | "facility" | "brand" | "organisation" | Nilai default: facility (schedules) |
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. |
brandId | string | ID merek, untuk templat merek, bukan fasilitas (schedules) |
organisationId | string | Untuk scope organisation (schedules, windows) |
includeCancelled | boolean | Sertakan yang dibatalkan (schedules, windows) |
limit | integer | Item per halaman (default 25, maksimal 100) (schedules, windows) |
cursor | string | nextCursor dari halaman sebelumnya (schedules, windows) |
from | string | Tanggal-waktu ISO (windows) |
to | string | Tanggal-waktu ISO (windows) |
startsAtKey | string | Jendela uji (startsAtKey), dari duress_tests_read windows (results) |
duress_tests_writeDuress ConfigurationPaksaanMembuat, mengubah, dan membatalkan jadwal uji duress, mengatur cara satu fasilitas mengikuti jadwal bersama, dan membatalkan satu jendela uji mendatang. Setiap perubahan membuat atau menulis ulang jendela mendatang dan mengirim email ke para pemangku kepentingan, sehingga setiap aksi meminta konfirmasi.
Jadwal memerlukan Duress Configuration di seluruh targetnya (admin organisasi untuk jadwal tingkat organisasi). Waktu mengikuti zona waktu masing-masing fasilitas. Baca jadwal dan jendela terlebih dahulu dengan duress_tests_read; mulai uji sekarang dengan duress_start_test.
Aksi:
- create_schedule: Membuat jadwal uji. Membuat jendela hingga sekitar satu tahun ke depan di setiap fasilitas dalam target dan mengirim email konfirmasi pemesanan. Memerlukan name, type, target, startDate, localStartTime, dan recurrence. Memerlukan name, type, target, startDate, localStartTime, recurrence. Meminta konfirmasi.
- update_schedule: Mengubah jadwal uji. Kolom yang tidak disertakan mempertahankan nilainya. Jendela mendatang ditulis ulang (yang sudah dimulai dibiarkan) dan pemangku kepentingan menerima pemberitahuan perubahan. Gunakan ownerScope dalam hasil setelahnya. Memerlukan ownerScope, scheduleId. Meminta konfirmasi.
- cancel_schedule: Membatalkan jadwal uji. Membatalkan jadwal dan jendela mendatangnya, lalu mengirim email pembatalan. Fasilitas yang memiliki salinan sendiri tetap menyimpannya. Memerlukan ownerScope, scheduleId. Meminta konfirmasi.
- set_facility_override: Mengubah jadwal bersama untuk satu fasilitas. mode follow (jalankan lagi jadwal bersama di sini), skip (hentikan di sini) atau own (ganti di sini dengan salinan yang dibuat dari schedule). Hanya memerlukan Duress Configuration di fasilitas tersebut. Memerlukan ownerScope, scheduleId, mode. Meminta konfirmasi.
- cancel_window: Membatalkan satu jendela uji. Membatalkan satu uji terjadwal di fasilitas (jadwal tetap berjalan) dan mengirim email ke pemangku kepentingannya. Memerlukan Duress di fasilitas; uji yang sedang aktif diakhiri dengan duress_end_test. Memerlukan startsAtKey. Meminta konfirmasi.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
action* | "create_schedule" | "update_schedule" | "cancel_schedule" | "set_facility_override" | "cancel_window" | Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat. |
name | string | Ditampilkan dalam email dan kalender (create_schedule, update_schedule) |
type | "walk" | "comms" | "drill" | walk (tekan setiap tombol), comms (satu tekanan per jalur pemantauan) atau drill (respons yang dilatih) (create_schedule, update_schedule) |
target | object | Fasilitas mana: seluruh organisasi, brandIds, atau facilityIds (create_schedule, update_schedule) |
startDate | string | Kejadian pertama, YYYY-MM-DD dalam zona waktu masing-masing fasilitas (create_schedule, update_schedule) |
localStartTime | string | HH:mm dalam zona waktu masing-masing fasilitas (create_schedule, update_schedule) |
durationMinutes | integer | Bawaan 60 (create_schedule, update_schedule) |
recurrence | "once" | "monthly" | "quarterly" | "twice-yearly" | "yearly" | once, monthly, quarterly, twice-yearly atau yearly (create_schedule, update_schedule) |
repeatOn | objectnull | Ulangi pada hari kerja ke-n dalam bulan, bukan pada tanggal yang sama; null menghapusnya (create_schedule, update_schedule) |
monitoringCentreMode | "test-codes" | "none" | test-codes mengirim sinyal sebagai uji; none tidak melibatkan pusat pemantauan (create_schedule, update_schedule) |
extraEmails | array | Juga menerima email pemesanan, pengingat, dan hasil (create_schedule, update_schedule) |
organisationId | string | Default: organisasi dari fasilitas yang terhubung (create_schedule, update_schedule, cancel_schedule, set_facility_override) |
ownerScope | string | Dari jadwal duress_tests_read, mis. brand#b-123; dapat berubah saat target berubah (update_schedule, cancel_schedule, set_facility_override) |
scheduleId | string | Dari jadwal duress_tests_read (update_schedule, cancel_schedule, set_facility_override) |
facilityId | string | ID fasilitas. Opsional jika fasilitas yang terhubung adalah yang Anda maksud. (set_facility_override, cancel_window) |
mode | "follow" | "skip" | "own" | follow, skip atau own (set_facility_override) |
schedule | object | mode own: kolom salinan (target selalu fasilitas ini); kolom yang tidak disertakan diambil dari jadwal bersama (set_facility_override) |
startsAtKey | string | Jendela uji (startsAtKey), dari jendela duress_tests_read (cancel_window) |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |
duress_unlock_doorsPaksaanMembuka kunci pintu untuk alarm duress, mis. agar polisi atau petugas pertolongan pertama dapat masuk: pintu yang tertaut ke tombol yang ditekan, atau jika tidak ada, pintu dalam rencana respons. Jangan sertakan doorIds untuk semua pintu, atau cantumkan beberapa di antaranya. Setiap pembukaan kunci dicatat di linimasa insiden dan di Access Logs.
Jangan pernah digunakan untuk alarm uji atau alarm yang sudah diselesaikan. Memerlukan Door/Gate Access di fasilitas.
Konfirmasi terlebih dahulu. Panggil tanpa confirm untuk melihat pintu mana yang akan dibuka kuncinya, beri tahu pengguna, lalu panggil lagi dengan confirm: true setelah mereka setuju.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
incidentId* | string | ID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress. |
doorIds | array | Beberapa pintu yang dicantumkan tanpa confirm. Jangan sertakan untuk semua pintu. |
confirm | boolean | Atur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama |