Paksaan

Platform Inti
duress_acknowledge_incidentPaksaan

Mengonfirmasi 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

NamaJenisDeskripsi
incidentId*stringID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress.
notestringCatatan opsional, misalnya "Sedang menuju resepsionis"
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_buttons_readPaksaanDuress ConfigurationManajemen Perangkat

Membaca tombol duress di fasilitas: statusnya (baterai, terakhir terdeteksi, terakhir diuji), profil lengkap (label, ruangan, zona, penempatan, kamera, pintu, dan layar yang ditautkan, peringatan yang dibisukan, kesehatan supervisi), apa saja yang dapat ditautkan, layar yang meneruskan tekanan tombol, dan uji penyiapan tombol yang baru ditambahkan.

Baterai: low berarti 30% atau kurang (segera ganti), critical 20% atau kurang (ganti sekarang). Baterai dan lastSeenAt yang null berarti belum ada layar yang mendeteksi tombol tersebut. Waktu dalam format ISO.

Tindakan:

  • status: Status tombol. Setiap tombol dengan zona, ruangan, baterai, kapan terakhir terdeteksi oleh layar, dan kapan terakhir diuji. "Apakah tombol duress berfungsi?", "Tombol mana yang perlu baterai baru?"
  • list: Profil tombol. Profil lengkap setiap tombol: apa yang diubah oleh duress_buttons_write update, ditambah sinyal, layar yang mendeteksinya dalam sehari terakhir, kesehatan supervisi, dan uji penyiapan yang menunggu.
  • link_options: Opsi tautan. Kamera, pintu, layar, dan zona akses fasilitas yang dapat ditautkan ke tombol (id untuk duress_buttons_write update).
  • receivers: Penerima tombol. Layar tampilan di fasilitas yang mendeteksi tombol dan meneruskan tekanan, serta apakah masing-masing online. ready bernilai false jika tidak ada yang dapat mendeteksi tombol.
  • setup_test: Uji penyiapan. Uji penyiapan tombol yang baru ditambahkan: waiting (tekanan pertamanya hanya uji), received, expired, ended, atau none, serta apakah layar telah mendeteksinya sejak ditambahkan. Memerlukan deviceSerialNumber.

Parameter

NamaJenisDeskripsi
action*"status" | "list" | "link_options" | "receivers" | "setup_test"Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat.
facilityIdstringID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud.
limitintegerItem per halaman (default 25, maksimal 100) (status, list)
cursorstringnextCursor dari halaman sebelumnya (status, list)
deviceSerialNumberstringNomor seri tombol, dari duress_buttons_read status atau list (setup_test)
duress_buttons_writeDuress ConfigurationPaksaanManajemen Perangkat

Mengubah tombol duress di fasilitas: menambahkan tombol baru, profilnya (label, ruangan, zona, penempatan, catatan, kamera, pintu, layar, dan zona akses yang ditautkan, peringatan perangkat yang dibisukan), membuat tombol berbunyi agar staf dapat menemukannya, mengakhiri uji penyiapan tombol baru agar aktif, dan menghapus tombol.

Kolom yang tidak diisi pada update mempertahankan nilainya; null menghapusnya. Baca profil saat ini dengan duress_buttons_read list.

Tindakan:

  • update: Perbarui tombol. Menyimpan profil tombol di fasilitas tempat tombol terdaftar (memerlukan Duress Configuration di sana). zone bernilai 001 hingga 999 dan unik di fasilitas. alertsMutedUntil (ISO, paling lama 30 hari ke depan) membisukan peringatan baterai dan offline-nya. Memerlukan deviceSerialNumber.
  • locate: Bunyikan tombol. Membuat tombol berbunyi dan berkedip selama 30 detik agar staf dapat menemukannya, misalnya tombol yang terus melaporkan baterai lemah. Layar di dekatnya yang mengirim perintah, jadi tombol harus berada dalam jangkauan layar. Tidak dapat dilakukan selama tombol memiliki alarm terbuka. Memerlukan deviceSerialNumber.
  • go_live: Aktifkan tombol baru. Mengakhiri uji penyiapan tombol yang baru ditambahkan sekarang, sehingga tekanan berikutnya adalah alarm sungguhan. Periksa terlebih dahulu dengan duress_buttons_read setup_test. Memerlukan Manajemen Perangkat atau Duress Configuration di fasilitas. Memerlukan deviceSerialNumber. Meminta konfirmasi.
  • remove: Hapus tombol. Memutus pemasangan tombol dari fasilitas dan menghapus profilnya, sehingga zonanya kosong kembali. Tidak dapat dilakukan selama tombol memiliki alarm terbuka. Memerlukan Manajemen Perangkat di fasilitas. Memerlukan deviceSerialNumber. Meminta konfirmasi.
  • add: Tambahkan tombol. Mendaftarkan tombol duress baru di fasilitas dengan nomor seri yang tercetak padanya. Secara default, tekanan pertamanya dalam 30 menit berikutnya hanya uji (setupTest). Fasilitas memerlukan layar dengan Duress alarm monitoring aktif atau IoT Gateway. Memerlukan Manajemen Perangkat di fasilitas. Memerlukan deviceSerialNumber. Meminta konfirmasi.

Parameter

NamaJenisDeskripsi
action*"update" | "locate" | "go_live" | "remove" | "add"Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat.
facilityIdstringID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud.
deviceSerialNumberstringNomor seri tombol, dari duress_buttons_read status atau list
labelstringnullSebutan staf untuk tombol tersebut, misalnya "Meja depan" (update)
roomstringnullRuangan tempat tombol berada (update, add)
zonestringnullZona pusat pemantauan, 001 hingga 999 (update)
placement"fixed" | "carried" | "null"fixed (terpasang) atau carried (liontin yang dibawa) (update)
notesstringnullCatatan untuk staf (update)
cameraIdsarraynullKamera yang ditautkan ke tombol (id dari duress_buttons_read link_options); null atau [] menghapusnya (update)
doorIdsarraynullPintu yang ditautkan ke tombol (id dari duress_buttons_read link_options); null atau [] menghapusnya (update)
screenIdsarraynullLayar yang ditautkan ke tombol (id dari duress_buttons_read link_options); null atau [] menghapusnya (update)
accessZoneIdstringnullZona akses tempat tombol berada (update)
alertsMutedUntilstringnullTanggal-waktu ISO batas pembisuan peringatan perangkatnya; null membatalkan pembisuan (update)
muteReasonstringnullAlasan peringatannya dibisukan (update)
setupTestbooleanDefault true: tekanan pertama hanya uji (add)
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_end_testPaksaan

Mengakhiri 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

NamaJenisDeskripsi
facilityIdstringID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud.
duress_incidents_readPaksaan

Membaca 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

NamaJenisDeskripsi
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)
facilityIdstringID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. (list)
organisationIdstringUntuk scope organisation. Default ke organisasi fasilitas. (list)
status"active" | "open" | "acknowledged" | "resolved"active berarti open atau acknowledged (list)
fromstringTanggal-waktu ISO: insiden yang dibuka pada atau setelah waktu ini (list)
tostringTanggal-waktu ISO: insiden yang dibuka pada atau sebelum waktu ini (list)
limitintegerItem per halaman (default 25, maksimal 100) (list)
cursorstringnextCursor dari halaman sebelumnya (list)
incidentIdstringID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress. (get, report, footage_previews, footage_frame)
cameraIdstringKamera dalam rekaman alarm, dari footage_previews (footage_previews, footage_frame)
secondsintegerstringWaktu frame dalam detik Unix 10 digit (footage_frame)
duress_incidents_writePaksaanDuress Configuration

Mengubah 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

NamaJenisDeskripsi
action*"rename" | "add_note" | "keep_footage" | "release_footage"Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat.
incidentIdstringID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress.
namestringnullNama; kosong atau null menghapusnya (rename)
notestringCatatan (add_note)
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_lift_lockdownPaksaan

Mencabut 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

NamaJenisDeskripsi
incidentId*stringID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress.
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_post_updatePaksaan

Mengirim 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

NamaJenisDeskripsi
incidentId*stringID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress.
text*stringPembaruan, kata demi kata
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_raise_alarmPaksaan

Memicu 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

NamaJenisDeskripsi
facilityIdstringID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud.
reason*stringApa yang terjadi
deviceSerialNumberstringTombol di fasilitas (opsional)
duress_reports_readPaksaanDuress Configuration

Pelaporan 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

NamaJenisDeskripsi
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)
facilityIdstringID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud.
brandIdstringID merek, untuk templat merek, bukan fasilitas (overview, compliance_summary, incident_export)
organisationIdstringMemerlukan akses Duress di seluruh organisasi (overview, compliance_summary, incident_export)
fromstringHari pertama, YYYY-MM-DD waktu lokal fasilitas (default 30 hari sebelum to) (overview, compliance_summary, incident_export)
tostringHari terakhir, YYYY-MM-DD waktu lokal fasilitas, inklusif (default hari ini) (overview, compliance_summary, incident_export)
limitintegerItem per halaman (default 25, maksimal 100) (overview, compliance_summary, incident_export)
cursorstringnextCursor dari halaman sebelumnya (overview, compliance_summary, incident_export)
duress_resolve_incidentPaksaan

Menyelesaikan 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, atau unknown.
  • 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

NamaJenisDeskripsi
incidentId*stringID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress.
disposition*"genuine" | "false_alarm" | "test" | "unknown"Hasilnya
notestringApa yang terjadi. Wajib jika disposisinya genuine.
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_settings_readPaksaanDuress Configuration

Membaca 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

NamaJenisDeskripsi
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.
facilityIdstringID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud. (response_plan, resolved_plan, contact_options, device_alerts, monitoring)
brandIdstringID merek, untuk templat merek, bukan fasilitas (response_plan, contact_options, device_alerts, contact_rules, plan_status, buttons_summary)
organisationIdstringID organisasi (buttons_summary)
duress_settings_writeDuress Configuration

Mengubah 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

NamaJenisDeskripsi
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.
facilityIdstringID 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)
brandIdstringID merek, untuk templat merek, bukan fasilitas (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_contact_rules)
organisationIdstringID 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)
tiersarrayTingkat rencana (mode replace dan templat) (save_response_plan)
additionsarrayMode extend: kontak tambahan per tingkat templat (tierId dan afterSeconds dari tingkat tersebut) (save_response_plan)
ackRequiredbooleanApakah eskalasi berlanjut hingga seseorang mengonfirmasi (save_response_plan)
remindersobjectnullUlangi peringatan setiap everySeconds (0 menonaktifkannya) hingga stopAfterSeconds (save_response_plan)
responseActionsobjectTindakan menurut nama, masing-masing { enabled, ... }: unlockOnAcknowledge (doorIds), lockdown, staffScreenAlerts, buttonAcknowledge, dashboardCctv, dashboardDoorControls, dashboardResolve, updateTexts, aiSummary, workflowControl, retainFootage (minutesBefore, minutesAfter, cameras) (save_response_plan)
rulesarrayAturan; daftar kosong tidak menyimpan aturan apa pun (tidak ada yang diberi peringatan di tingkat ini) (save_device_alerts)
roleIdsarrayId peran yang dikenai mode tersebut (save_contact_rules)
eaAlarmType"none" | "cid" | "relay"none, cid, atau relay (save_monitoring)
eaAlarmProviderstringnullUntuk cid: kode penyedia (save_monitoring)
eaRelayModel"none" | "numato-rl80001"Untuk relay: papan relay (save_monitoring)
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_start_lockdownPaksaan

Memberlakukan 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

NamaJenisDeskripsi
incidentId*stringID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress.
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_start_testPaksaan

Memulai 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

NamaJenisDeskripsi
facilityIdstringID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud.
type"walk" | "drill"walk (default) atau drill
durationMinutesintegerBerapa lama tekanan dianggap uji (default 60)
monitoringCentreMode"test-codes" | "none"`test-codes` mengirim sinyal uji ke pusat pemantauan; `none` tidak mengirim apa pun
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_tests_readPaksaanDuress Configuration

Membaca 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 from hingga to (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

NamaJenisDeskripsi
action*"schedules" | "windows" | "results"Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat.
scope"facility" | "brand" | "organisation"Nilai default: facility (schedules)
facilityIdstringID fasilitas. Opsional jika fasilitas yang terhubung adalah fasilitas yang Anda maksud.
brandIdstringID merek, untuk templat merek, bukan fasilitas (schedules)
organisationIdstringUntuk scope organisation (schedules, windows)
includeCancelledbooleanSertakan yang dibatalkan (schedules, windows)
limitintegerItem per halaman (default 25, maksimal 100) (schedules, windows)
cursorstringnextCursor dari halaman sebelumnya (schedules, windows)
fromstringTanggal-waktu ISO (windows)
tostringTanggal-waktu ISO (windows)
startsAtKeystringJendela uji (startsAtKey), dari duress_tests_read windows (results)
duress_tests_writeDuress ConfigurationPaksaan

Membuat, 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

NamaJenisDeskripsi
action*"create_schedule" | "update_schedule" | "cancel_schedule" | "set_facility_override" | "cancel_window"Tindakan yang akan dilakukan; setiap tindakan dijelaskan dalam deskripsi alat.
namestringDitampilkan 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)
targetobjectFasilitas mana: seluruh organisasi, brandIds, atau facilityIds (create_schedule, update_schedule)
startDatestringKejadian pertama, YYYY-MM-DD dalam zona waktu masing-masing fasilitas (create_schedule, update_schedule)
localStartTimestringHH:mm dalam zona waktu masing-masing fasilitas (create_schedule, update_schedule)
durationMinutesintegerBawaan 60 (create_schedule, update_schedule)
recurrence"once" | "monthly" | "quarterly" | "twice-yearly" | "yearly"once, monthly, quarterly, twice-yearly atau yearly (create_schedule, update_schedule)
repeatOnobjectnullUlangi 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)
extraEmailsarrayJuga menerima email pemesanan, pengingat, dan hasil (create_schedule, update_schedule)
organisationIdstringDefault: organisasi dari fasilitas yang terhubung (create_schedule, update_schedule, cancel_schedule, set_facility_override)
ownerScopestringDari jadwal duress_tests_read, mis. brand#b-123; dapat berubah saat target berubah (update_schedule, cancel_schedule, set_facility_override)
scheduleIdstringDari jadwal duress_tests_read (update_schedule, cancel_schedule, set_facility_override)
facilityIdstringID 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)
scheduleobjectmode own: kolom salinan (target selalu fasilitas ini); kolom yang tidak disertakan diambil dari jadwal bersama (set_facility_override)
startsAtKeystringJendela uji (startsAtKey), dari jendela duress_tests_read (cancel_window)
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama
duress_unlock_doorsPaksaan

Membuka 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

NamaJenisDeskripsi
incidentId*stringID insiden (inc_...), dari duress_incidents_read list atau pemicu workflow Duress.
doorIdsarrayBeberapa pintu yang dicantumkan tanpa confirm. Jangan sertakan untuk semua pintu.
confirmbooleanAtur hanya setelah pengguna mengonfirmasi pratinjau yang dikembalikan oleh panggilan pertama