Tehdit ve Panik

Temel platform
duress_acknowledge_incidentTehdit ve Panik

Açık bir Duress olayını kullanıcı adına onaylar: kullanıcının müdahale ettiğini kaydeder ve daha fazla eskalasyonu durdurabilir. Yalnızca açık olaylar onaylanabilir.

Her zaman önce onay alın. Olayı almak için confirm olmadan çağırın, kullanıcıya neyi onayladığını söyleyin ve yalnızca kabul ettikten sonra confirm: true ile yeniden çağırın.

Bir iş akışında veya bir Agent'tan çağrıldığında bu yalnızca tesisin müdahale planının iş akışlarının alarmları onaylamasına, çözmesine ve tetiklemesine izin verdiği yerlerde çalışır. Bir olayı kapatmak için duress_resolve_incident kullanın.

Parametreler

AdTürAçıklama
incidentId*stringduress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...).
notestringİsteğe bağlı not, ör. "Resepsiyona gidiyorum"
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_buttons_readTehdit ve PanikDuress ConfigurationAygıt Yönetimi

Bir tesisteki Duress düğmelerini okur: durumları (pil, son duyulma, son test), tam profilleri (etiket, oda, bölge, yerleşim, bağlı kameralar, kapılar ve ekranlar, sessize alınmış uyarılar, denetim sağlığı), neye bağlanabilecekleri, basışlarını ileten ekranlar ve yeni eklenen bir düğmenin kurulum testi.

Pil: low %30 veya altıdır (yakında değiştirin), critical %20 veya altıdır (hemen değiştirin). Pil ve lastSeenAt değerlerinin null olması, düğmeyi henüz hiçbir ekranın duymadığı anlamına gelir. Saatler ISO biçimindedir.

Eylemler:

  • status: Düğme durumu. Her düğme; bölgesi, odası, pili, bir ekranın onu en son ne zaman duyduğu ve en son ne zaman test edildiğiyle. "Duress düğmeleri çalışıyor mu?", "Hangilerinin yeni pile ihtiyacı var?"
  • list: Düğme profilleri. Her düğmenin tam profili: duress_buttons_write update'in değiştirdikleri, ayrıca sinyal, son bir günde onu duyan ekranlar, denetim sağlığı ve bekleyen bir kurulum testi.
  • link_options: Bağlantı seçenekleri. Tesisin bir düğmenin bağlanabileceği kameraları, kapıları, ekranları ve erişim bölgeleri (duress_buttons_write update için kimlikler).
  • receivers: Düğme alıcıları. Tesisteki düğmeleri duyan ve basışları ileten ekranlar ve her birinin çevrimiçi olup olmadığı. Hiçbir şey bir düğmeyi duyamıyorsa ready false olur.
  • setup_test: Kurulum testi. Yeni eklenen bir düğmenin kurulum testi: waiting (ilk basışı yalnızca bir testtir), received, expired, ended veya none ve eklendiğinden beri bir ekranın onu duyup duymadığı. deviceSerialNumber gerektirir.

Parametreler

AdTürAçıklama
action*"status" | "list" | "link_options" | "receivers" | "setup_test"Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır.
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır.
limitintegerSayfa başına öğe (varsayılan 25, en fazla 100) (status, list)
cursorstringÖnceki sayfadan nextCursor (status, list)
deviceSerialNumberstringduress_buttons_read status veya list'ten düğme seri numarası (setup_test)
duress_buttons_writeDuress ConfigurationTehdit ve PanikAygıt Yönetimi

Bir tesisteki Duress düğmelerini değiştirir: yeni bir düğme ekleme, profillerini (etiket, oda, bölge, yerleşim, notlar, bağlı kameralar, kapılar, ekranlar ve erişim bölgesi, sessize alınmış cihaz uyarıları) düzenleme, personelin bulabilmesi için bir düğmeyi öttürme, yeni bir düğmenin kurulum testini bitirerek onu canlıya alma ve bir düğmeyi kaldırma.

update'te belirtilmeyen alanlar değerlerini korur; null bunları temizler. Geçerli profili duress_buttons_read list ile okuyun.

Eylemler:

  • update: Bir düğmeyi günceller. Düğmenin profilini kayıtlı olduğu tesiste kaydeder (orada Duress Configuration gerektirir). zone 001 ile 999 arasındadır ve tesiste benzersizdir. alertsMutedUntil (ISO, en fazla 30 gün ileri) pil ve çevrimdışı uyarılarını sessize alır. deviceSerialNumber gerektirir.
  • locate: Bir düğmeyi öttürür. Personelin bulabilmesi için düğmenin 30 saniye boyunca ötmesini ve yanıp sönmesini sağlar; ör. sürekli düşük pil bildiren bir düğme. Komutu yakınındaki bir ekran gönderir, bu nedenle düğme bir ekranın menzilinde olmalıdır. Açık bir alarmı varken kullanılamaz. deviceSerialNumber gerektirir.
  • go_live: Yeni bir düğmeyi canlıya alır. Yeni eklenen bir düğmenin kurulum testini hemen bitirir, böylece bir sonraki basışı gerçek bir alarm olur. Önce duress_buttons_read setup_test ile kontrol edin. Tesiste Aygıt Yönetimi veya Duress Configuration gerektirir. deviceSerialNumber gerektirir. Onay ister.
  • remove: Bir düğmeyi kaldırır. Düğmenin tesisle eşleştirmesini kaldırır ve profilini siler; bu da bölgesini serbest bırakır. Açık bir alarmı varken kullanılamaz. Tesiste Aygıt Yönetimi gerektirir. deviceSerialNumber gerektirir. Onay ister.
  • add: Bir düğme ekler. Üzerinde basılı seri numarasıyla tesise yeni bir Duress düğmesi kaydeder. Varsayılan olarak sonraki 30 dakika içindeki ilk basışı yalnızca bir testtir (setupTest). Tesiste Duress alarm monitoring açık bir ekran veya bir IoT Gateway olmalıdır. Tesiste Aygıt Yönetimi gerektirir. deviceSerialNumber gerektirir. Onay ister.

Parametreler

AdTürAçıklama
action*"update" | "locate" | "go_live" | "remove" | "add"Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır.
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır.
deviceSerialNumberstringduress_buttons_read status veya list'ten düğme seri numarası
labelstringnullPersonelin düğmeye verdiği ad, ör. "Ön büro" (update)
roomstringnullBulunduğu oda (update, add)
zonestringnullİzleme merkezi bölgesi, 001 ile 999 arası (update)
placement"fixed" | "carried" | "null"fixed (sabitlenmiş) veya carried (kolye tipi) (update)
notesstringnullPersonel için notlar (update)
cameraIdsarraynullDüğmeye bağlı kameralar (duress_buttons_read link_options'tan kimlikler); null veya [] bunları temizler (update)
doorIdsarraynullDüğmeye bağlı kapılar (duress_buttons_read link_options'tan kimlikler); null veya [] bunları temizler (update)
screenIdsarraynullDüğmeye bağlı ekranlar (duress_buttons_read link_options'tan kimlikler); null veya [] bunları temizler (update)
accessZoneIdstringnullDüğmenin bulunduğu erişim bölgesi (update)
alertsMutedUntilstringnullCihaz uyarılarının sessize alınacağı son ISO tarih-saati; null sesi açar (update)
muteReasonstringnullUyarılarının neden sessize alındığı (update)
setupTestbooleanVarsayılan true: ilk basış yalnızca bir testtir (add)
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_end_testTehdit ve Panik

Bir tesiste devam eden Duress testini hemen sona erdirir, böylece bir sonraki basış gerçek bir alarm olur. Sonuçlar, her testte olduğu gibi yaklaşık 10 dakika sonra gelir.

Parametreler

AdTürAçıklama
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır.
duress_incidents_readTehdit ve Panik

Duress alarm olaylarını okur (personel bir Duress düğmesine bastı veya bir iş akışı alarm tetikledi): listeler, tek bir olayın zaman çizelgesi ve gönderimleri, olay sonrası inceleme raporu ve bir alarm çevresindeki güvenlik kamerası kayıtları.

Durumlar: open (henüz kimse onaylamadı), acknowledged (biri müdahale ediyor), resolved (kapatıldı, bir sonuçla: genuine, false_alarm, test veya unknown). active, open veya acknowledged anlamına gelir. Test olayları (isTest) düğme testlerinden gelir; testType 'unplanned', gerçek olarak tetiklenen ve bir müdahale görevlisinin test olarak çözdüğü bir alarmdır.

Gönderim durumu: sent, acknowledged (alıcı onayladı), failed (bkz. error), shadow (deneme çalıştırması, hiçbir şey gönderilmedi). İzleme merkezine yapılan gönderimler ayrıca monitoringCentre altında toplanır. Sonuçlar kişilerin adını verir ancak hiçbir zaman telefon numarası veya e-posta adresi içermez. Saatler ISO biçimindedir.

Eylemler:

  • list: Olayları listeler. En yeni önce. scope: facility (varsayılan; verilen veya bağlı tesis) ya da organisation (görebildiğiniz organizasyondaki her tesis; varsayılan olarak tesisin organizasyonu).
  • get: Bir olayı getirir. Durum, basılan düğmeler, zaman çizelgesi (basışlar, eskalasyonlar, onaylar, notlar) ve her bildirim veya izleme merkezi gönderim denemesi sonucuyla birlikte. incidentId gerektirir.
  • report: Olay raporu. Olay sonrası inceleme için: olay, onaylama ve çözme süresi (saniye), ulaşılan adımlar, her zaman çizelgesi girişi, kanal başına ne gönderildiği ve neyin başarısız olduğu ve kayıtların saklanıp saklanmadığı. İncelemeyi olaya eklemek için duress_incidents_write add_note ile birlikte kullanın. incidentId gerektirir.
  • footage_previews: Alarm kayıtları. Alarm kayıtlarındaki her kamera: durumu, kare ve klip sayıları, yüklenen klipler ve basışa en yakın kare (posterSeconds). cameraId ile yalnızca o kamera ve her karenin Unix saniyesi (frameSeconds). Tesiste güvenlik kamerası gerektirir. incidentId gerektirir.
  • footage_frame: Alarm kaydı karesi. Alarm kayıtlarından bir hızlandırılmış çekim karesi, görüntü olarak döndürülür: kayıtlar saklandıysa saklanan kopya, aksi halde alarm penceresindeki canlı kare. seconds, footage_previews'tan bir posterSeconds veya frameSeconds değeridir. incidentId, cameraId, seconds gerektirir.

Parametreler

AdTürAçıklama
action*"list" | "get" | "report" | "footage_previews" | "footage_frame"Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır.
scope"facility" | "organisation"Varsayılan facility (list)
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. (list)
organisationIdstringscope organisation için. Varsayılan olarak tesisin organizasyonudur. (list)
status"active" | "open" | "acknowledged" | "resolved"active, open veya acknowledged demektir (list)
fromstringISO tarih-saati: bu zamanda veya sonrasında açılan olaylar (list)
tostringISO tarih-saati: bu zamanda veya öncesinde açılan olaylar (list)
limitintegerSayfa başına öğe (varsayılan 25, en fazla 100) (list)
cursorstringÖnceki sayfadan nextCursor (list)
incidentIdstringduress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...). (get, report, footage_previews, footage_frame)
cameraIdstringfootage_previews'tan alarm kayıtlarındaki bir kamera (footage_previews, footage_frame)
secondsintegerstring10 haneli Unix saniyesi olarak kare zamanı (footage_frame)
duress_incidents_writeTehdit ve PanikDuress Configuration

Alarmın kendisine dokunmadan bir Duress olayını değiştirir: olayı adlandırır, personel notları ekler ve çevresindeki güvenlik kamerası kayıtlarını saklar veya serbest bırakır. Kimse uyarılmaz. Onaylamak, çözmek veya müdahale görevlilerini bilgilendirmek için duress_acknowledge_incident, duress_resolve_incident veya duress_post_update kullanın.

Eylemler:

  • rename: Bir olayı adlandırır. Olayın daha sonra kolayca bulunması için ad verir, ör. "Ön tezgâhta saldırgan ziyaretçi". Boş veya null ad, adı kaldırır. Adlar Duress konsolunda ve raporlarda görünür. incidentId gerektirir.
  • add_note: Not ekler. Olayın zaman çizelgesine bir not ekler, ör. kullanıcının ne bulduğu veya kimin müdahale ettiği. Her durumda kullanılabilir; notları yalnızca personel görür ve olayı değiştirmezler. Notu kullanıcının kendi sözleriyle yazın ve ifadeyi önce kullanıcıyla teyit edin. incidentId, note gerektirir.
  • keep_footage: Alarm kayıtlarını saklar. Çözülmüş gerçek bir alarm çevresindeki güvenlik kamerası kayıtlarını, müdahale planının dakikalarını ve kameralarını kullanarak normal kayıtlarla birlikte silinmeyecek şekilde saklar. Kayıtlar yüklendikten birkaç dakika sonra gerçekleşir. Testler, açık alarmlar veya zaten saklanmış ya da serbest bırakılmış kayıtlar için kullanılamaz. incidentId gerektirir.
  • release_footage: Saklanan kayıtları serbest bırakır. Bir alarm için saklanan kayıtlardan vazgeçer: klipler normal saklama süresine döner ve saklanan kareler silinir; böylece normal kayıtların süresi dolduğunda artık görüntülenemez. Tesiste Duress Configuration gerektirir. incidentId gerektirir. Onay ister.

Parametreler

AdTürAçıklama
action*"rename" | "add_note" | "keep_footage" | "release_footage"Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır.
incidentIdstringduress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...).
namestringnullAd; boş veya null adı kaldırır (rename)
notestringNot (add_note)
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_lift_lockdownTehdit ve Panik

Bir Duress alarmının kilitlemesini kaldırır: kilitlediği kapılar yeniden insanların girişine izin verir. Alarmın durumu ne olursa olsun çalışır.

Önce onay alın. Kilitlemeyi görmek için confirm olmadan çağırın, kullanıcıya bildirin ve kabul ettiğinde confirm: true ile yeniden çağırın.

Parametreler

AdTürAçıklama
incidentId*stringduress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...).
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_post_updateTehdit ve Panik

Bir Duress alarmına müdahale eden kişilere bir güncelleme gönderir, ör. "Polis yolda" veya "Tehlike geçti, kişi ayrıldı". Güncelleme alarm sayfalarında ve Duress uygulamasında görünür; gerçek bir alarmda müdahale planı bunu alarm hakkında zaten SMS gönderilmiş herkese SMS olarak da gönderebilir. Güncellemeler, alarm çözüldükten sonraki 24 saate kadar gönderilebilir.

Önce onay alın. Olayı kontrol etmek için confirm olmadan çağırın, kullanıcıya tam ifadeyi gösterin ve kabul ettiğinde confirm: true ile yeniden çağırın. Yalnızca personelin görmesi gereken bir şey için bunun yerine duress_incidents_write add_note kullanın.

Parametreler

AdTürAçıklama
incidentId*stringduress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...).
text*stringGüncellemenin kelimesi kelimesine metni
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_raise_alarmTehdit ve Panik

Tesiste, bir düğmeye basılmış gibi gerçek bir Duress alarmı tetikler: müdahale planı çalışır (kişiler uyarılır, eskalasyon ve hatırlatmalar izler, müdahale eylemleri çalışır) ve alarm, nedeniyle birlikte bu iş akışı tarafından tetiklendiğini belirtir.

  • reason: ne olduğu, ör. "Arka çıkıştaki kapı zorla açıldı" (en fazla 200 karakter).
  • deviceSerialNumber: isteğe bağlı. Konumu kullanılacak bir düğme; yalnızca bu durumda izleme merkezi de o düğmenin bölgesiyle bilgilendirilir.

Yalnızca bir iş akışı adımı olarak, müdahale planı iş akışlarının alarmları onaylamasına, çözmesine ve tetiklemesine izin veren tesislerde kullanılır. Bu iş akışının alarmı açıkken başka bir alarm tetiklemez; bunun yerine o alarmı döndürür.

Parametreler

AdTürAçıklama
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır.
reason*stringNe olduğu
deviceSerialNumberstringTesisteki bir düğme (isteğe bağlı)
duress_reports_readTehdit ve PanikDuress Configuration

Bir tesis, marka veya organizasyon için Duress uyumluluk raporlaması: müdahale süreleri (P50/P95), sonuca göre olaylar ve yanlış alarm oranı, test kapsamı ve testi gecikmiş tesisler, düğme çalışma süresi, izleme merkezi gönderim başarısı ve olay bazında dışa aktarma. Ayrıca tek bir tesisteki son alarmın iletilmeyen uyarıları.

Günler tesisin yerel saatine göredir; 400 günü aşan dönemler kısaltılır (range.capped). Gerçek ve test olayları ayrı sayılır. Süreler ms cinsindendir (p50Ms, p95Ms). Organizasyon genelinde erişiminiz yoksa marka raporları yalnızca erişebildiğiniz tesisleri kapsar (scope.restrictedToAccessibleFacilities).

Eylemler:

  • overview: Duress rapor özeti. Toplamlar, aylık eğilim ve organizasyon, marka ve tesis başına ölçümler (incidents, testCoverage, deviceUptime, deliveries). Tesisler sayfalıdır.
  • compliance_summary: Duress uyumluluk özeti. Uyumluluk PDF'inin gösterdikleri: testi gecikmiş tesislerle test kapsamı, düğme çalışma süresi, gönderim başarısı, son testler (testHistory) ve her tesis için son testi, tatbikatı ve gerçek alarmı ile her düğmenin çalışma süresi. Tesisler sayfalıdır.
  • incident_export: Duress olay dışa aktarımı. CSV dışa aktarımının sütunlarıyla, en eskisi önce olmak üzere olay başına bir satır: tesis, test veya gerçek, durum, sonuç, yerel saatler, onaylama ve çözme süresi (saniye), kimin onayladığı ve çözdüğü, düğmeler ve gönderim sayıları.
  • delivery_problems: İletilmeyen alarm uyarıları. Tesisin son alarmı veya testi (tüm test penceresiyle) ve hiç ulaşmayan uyarılar, kanala göre. Her şey iletildiyse problems null olur. Orada Duress veya Duress Configuration gerektirir.

Parametreler

AdTürAçıklama
action*"overview" | "compliance_summary" | "incident_export" | "delivery_problems"Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır.
scope"facility" | "brand" | "organisation"Varsayılan: verilen en belirli kimlik, yoksa bağlı tesis. (overview, compliance_summary, incident_export)
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır.
brandIdstringBir tesis yerine markanın şablonu için marka kimliği (overview, compliance_summary, incident_export)
organisationIdstringOrganizasyon genelinde Duress erişimi gerektirir (overview, compliance_summary, incident_export)
fromstringİlk gün, tesis yerel saatine göre YYYY-MM-DD (varsayılan to'dan 30 gün önce) (overview, compliance_summary, incident_export)
tostringSon gün, tesis yerel saatine göre YYYY-MM-DD, dahil (varsayılan bugün) (overview, compliance_summary, incident_export)
limitintegerSayfa başına öğe (varsayılan 25, en fazla 100) (overview, compliance_summary, incident_export)
cursorstringÖnceki sayfadan nextCursor (overview, compliance_summary, incident_export)
duress_resolve_incidentTehdit ve Panik

Bir Duress olayını çözer: alarmı kapatır, eskalasyonu durdurur ve sonucu kaydeder. Açık ve onaylanmış olaylar çözülebilir.

  • disposition: genuine (gerçek bir acil durum), false_alarm, test veya unknown.
  • note: ne olduğu. Gerçek bir alarm için zorunludur.

Her zaman önce onay alın. Olayı almak için confirm olmadan çağırın, kullanıcıya hangi alarmı kapattığını ve sonucu söyleyin ve yalnızca kabul ettikten sonra confirm: true ile yeniden çağırın.

Bir iş akışında veya bir Agent'tan çağrıldığında bu yalnızca tesisin müdahale planının iş akışlarının alarmları onaylamasına, çözmesine ve tetiklemesine izin verdiği yerlerde çalışır.

Parametreler

AdTürAçıklama
incidentId*stringduress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...).
disposition*"genuine" | "false_alarm" | "test" | "unknown"Sonuç
notestringNe olduğu. disposition genuine olduğunda zorunludur.
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_settings_readTehdit ve PanikDuress Configuration

Duress ayarlarını okur: müdahale planları (bir tesiste veya marka şablonu olarak kimin, hangi sırayla ve nasıl uyarıldığı), alarm motorunun fiilen kullandığı çözümlenmiş plan, eklenebilecek kişiler ve roller, cihaz uyarıları (pil, çevrimdışı, kapsama ve gönderim sorunları), marka iletişim kuralları ve plan durumu, bir markanın veya organizasyonun düğme özeti ve alarmların izleme merkezine nereden gittiği.

Bir tesis, markasının (yoksa organizasyonunun) şablonunu izler, onu ek kişilerle genişletir (mode extend) veya kendi planıyla değiştirir (mode replace). Ayarları duress_settings_write ile değiştirin. Saatler ISO biçimindedir.

Eylemler:

  • response_plan: Müdahale planı. Bir tesiste geçerli olan plan (effective) ve her düzeyin içeriği (sources: facility, brand, organisation) ya da yalnızca brandId ile markanın şablonu. Kişiler kaydedildiği şekliyle, düzenlenip geri kaydedilmeye hazır olarak döner.
  • resolved_plan: Çözümlenmiş plan. Alarm motorunun tesiste kademe kademe kimlerle iletişime geçtiği: kişilere açılmış roller, her birine ulaşılabilecek kanallar, gecikmeler ve bir alarmdan önce düzeltilmesi gereken uyarılar. Yalnızca adlar; telefon numarası veya e-posta yok.
  • contact_options: İletişim seçenekleri. Markanın iletişim kuralları uygulandıktan sonra tesisin planına (orada Duress Configuration gerektirir) ya da yalnızca brandId ile markanın şablonuna eklenebilecek kişiler ve roller.
  • device_alerts: Cihaz uyarıları. Düşük piller, çevrimdışı düğmeler, kaybedilen kapsama ve başarısız gönderimler hakkında kimin bilgilendirildiği: her düzeydeki kurallar ve tesisin çözümlenmiş alıcıları ya da yalnızca brandId ile markanın kuralları.
  • contact_rules: Marka iletişim kuralları. Markadaki tesislerin planlara hangi rolleri ekleyebileceği: allowAllExcept listelenen rolleri gizler, manual yalnızca bunları sunar. Marka planını düzenlemenin gerektirdiği izinleri gerektirir. brandId gerektirir.
  • plan_status: Marka plan durumu. Markadaki her tesis: şablonu izleyip izlemediği, genişletip genişletmediği veya kendi planı olup olmadığı, kaç kişi eklediği ve planının uyarıları. brandId gerektirir.
  • buttons_summary: Düğme özeti. Bir marka veya organizasyondaki her tesis: düğmeler, pil ve çevrimdışı sayıları, sonraki ve son test. Brands & Customisation ve organizasyon özetlerinin verileri.
  • monitoring: İzleme merkezi yönlendirmesi. Alarmların tesisten nasıl çıktığı: eaAlarmType none, cid (eaAlarmProvider üzerinden bir izleme merkezi araması) veya relay (eaRelayModel üzerinden kablolu bir panel) ve kullanabileceği sağlayıcılar.

Parametreler

AdTürAçıklama
action*"response_plan" | "resolved_plan" | "contact_options" | "device_alerts" | "contact_rules" | "plan_status" | "buttons_summary" | "monitoring"Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır.
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. (response_plan, resolved_plan, contact_options, device_alerts, monitoring)
brandIdstringBir tesis yerine markanın şablonu için marka kimliği (response_plan, contact_options, device_alerts, contact_rules, plan_status, buttons_summary)
organisationIdstringOrganizasyon kimliği (buttons_summary)
duress_settings_writeDuress Configuration

Duress ayarlarını değiştirir: müdahale planları (bir tesiste ya da bir markanın veya organizasyonun şablonunda), cihaz uyarıları, marka iletişim kuralları ve alarmların izleme merkezine nereden gittiği. Kimin uyarılacağını değiştirdiği için her değişiklik onay ister.

facilityId (varsayılan: bağlı tesis), brandId veya organisationId'den birini iletin. Tesis planları orada Duress Configuration gerektirir; şablonlar Duress Configuration'a sahip bir organizasyon yöneticisi ya da bir marka için markadaki her tesiste Duress Configuration gerektirir. Önce duress_settings_read ile okuyun.

Eylemler:

  • save_response_plan: Bir müdahale planını kaydeder. Basıştan afterSeconds sonra uyarılan kişi kademeleri (artan sırada, ilki genellikle 0), ackRequired, hatırlatmalar ve responseActions. Bir tesis bunun yerine şablonunu eklemelerle genişletebilir (mode extend). Belirtilmeyen alanlar kayıtlı değerlerini korur; responseActions eyleme göre birleştirilir. Onay ister.
  • remove_response_plan: Bir müdahale planını kaldırır. Bu düzeyde kaydedilen planı siler; böylece tesis yeniden şablonunu izler, marka ise organizasyonun planına geri döner. Onay ister.
  • save_device_alerts: Cihaz uyarılarını kaydeder. Bu düzeydeki cihaz uyarısı kurallarının yerini alır: her biri bir olay ve kişi kümesi (push, sms veya email) olan en fazla 10 kural. duress_settings_read device_alerts'ten okunan kural kimliklerini koruyun. rules gerektirir. Onay ister.
  • remove_device_alerts: Cihaz uyarılarını kaldırır. Bu düzeydeki cihaz uyarısı kurallarını siler; böylece yeniden bir üst düzeyi izler. Onay ister.
  • save_contact_rules: Marka iletişim kurallarını kaydeder. Markanın tesislerinin planlara hangi rolleri ekleyebileceği: allowAllExcept roleIds'i gizler, manual yalnızca roleIds'i sunar. Zaten kaydedilmiş kişiler kalır; çözümlenmiş planlar yenilenir. brandId, mode, roleIds gerektirir. Onay ister.
  • save_monitoring: İzleme merkezi yönlendirmesini kaydeder. Alarmların nereye gittiği: eaAlarmType none, cid (eaAlarmProvider gerektirir; duress_settings_read monitoring'in listelediği sağlayıcılardan biri) veya relay (eaRelayModel). Tesiste Duress Configuration gerektirir. eaAlarmType gerektirir. Onay ister.

Parametreler

AdTürAçıklama
action*"save_response_plan" | "remove_response_plan" | "save_device_alerts" | "remove_device_alerts" | "save_contact_rules" | "save_monitoring"Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır.
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_monitoring)
brandIdstringBir tesis yerine markanın şablonu için marka kimliği (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_contact_rules)
organisationIdstringOrganizasyonun şablonu için organizasyon kimliği (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts)
mode"replace" | "extend"Yalnızca tesis planları: replace (kendi kademeleri) veya extend (şablona eklemeler) (save_response_plan, save_contact_rules)
tiersarrayPlanın kademeleri (mode replace ve şablonlar) (save_response_plan)
additionsarrayMode extend: şablon kademesi başına ek kişiler (tierId ve oradan afterSeconds) (save_response_plan)
ackRequiredbooleanBiri onaylayana kadar eskalasyonun devam edip etmediği (save_response_plan)
remindersobjectnullUyarıları stopAfterSeconds'a kadar her everySeconds'ta bir tekrarlar (0 kapatır) (save_response_plan)
responseActionsobjectAda göre eylemler, her biri { enabled, ... }: unlockOnAcknowledge (doorIds), lockdown, staffScreenAlerts, buttonAcknowledge, dashboardCctv, dashboardDoorControls, dashboardResolve, updateTexts, aiSummary, workflowControl, retainFootage (minutesBefore, minutesAfter, cameras) (save_response_plan)
rulesarrayKurallar; boş liste hiçbir kural kaydetmez (bu düzeyde kimse uyarılmaz) (save_device_alerts)
roleIdsarraymode'un uygulandığı rol kimlikleri (save_contact_rules)
eaAlarmType"none" | "cid" | "relay"none, cid veya relay (save_monitoring)
eaAlarmProviderstringnullcid için: sağlayıcı kodu (save_monitoring)
eaRelayModel"none" | "numato-rl80001"relay için: röle kartı (save_monitoring)
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_start_lockdownTehdit ve Panik

Bir Duress alarmı için tesisi kilitler: kilitleme kaldırılana kadar (duress_lift_lockdown ile veya konsoldan) hiçbir kapı insanların girişine izin vermez. Bir alarm yalnızca bir kez kilitleme alabilir.

Test veya çözülmüş alarmlar için asla kullanılmaz. Tesiste Door/Gate Access gerektirir.

Önce onay alın. Olayı kontrol etmek için confirm olmadan çağırın, kullanıcıya tüm kapıların kilitleneceğini söyleyin ve kabul ettiğinde confirm: true ile yeniden çağırın.

Parametreler

AdTürAçıklama
incidentId*stringduress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...).
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_start_testTehdit ve Panik

Bir tesiste hemen bir Duress testi başlatır. Test bitene kadar her basış gerçek bir alarm değil, bir testtir:

  • walk: personel her düğmeye basar; müdahale planının yalnızca ilk adımı TEST etiketiyle uyarılır.
  • drill: müdahale planının tamamı TEST etiketiyle çalışır.

Tesisin test kişilerine testin başladığı bildirilir ve test bittikten yaklaşık 10 dakika sonra sonuçları alırlar. Her tesiste aynı anda tek bir test yapılabilir. Erken bitirmek için duress_end_test kullanın; testleri önceden planlamak için duress_tests_write kullanın.

Önce onay alın. confirm olmadan çağırın, kullanıcıya durationMinutes boyunca basışların gerçek alarm tetiklemeyeceğini söyleyin ve kabul ettiğinde confirm: true ile yeniden çağırın. Bir iş akışında veya bir Agent'tan çağrıldığında bu yalnızca tesisin müdahale planının iş akışlarının alarmları onaylamasına, çözmesine ve tetiklemesine izin verdiği yerlerde çalışır.

Parametreler

AdTürAçıklama
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır.
type"walk" | "drill"walk (varsayılan) veya drill
durationMinutesintegerBasışların ne kadar süre test sayılacağı (varsayılan 60)
monitoringCentreMode"test-codes" | "none"`test-codes` izleme merkezine test sinyalleri gönderir; `none` hiçbir şey göndermez
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_tests_readTehdit ve PanikDuress Configuration

Duress düğme testlerini okur: testleri planlayan programlar (walk, comms veya drill; tek seferlik veya yinelenen; bir organizasyon, markalar veya tesisler için), her tesiste oluşturdukları test pencereleri (scheduled, active, completed, cancelled ve plansız testler) ve bir pencerenin sonuçları (hangi düğmelere basıldığı veya hangilerinin atlandığı, kimin bilgilendirildiği, izleme merkezi sinyalleri, onay süreleri).

Testi kimin planladığı, değiştirdiği veya iptal ettiği dahil edilmez; gönderim alıcıları gizlenir. Saatler ISO biçimindedir; localDate ve localStartTime tesisin saat dilimindedir. Testleri duress_tests_write ile planlayın veya değiştirin; hemen bir test başlatmak için duress_start_test kullanın.

Eylemler:

  • schedules: Test programları. scope facility (varsayılan; atladığı veya yerine geçtiği paylaşılanlar dahil, onu kapsayan her program), brand (brandId) veya organisation (varsayılan: tesisin organizasyonu). En yeni değişiklik önce.
  • windows: Test pencereleri. Bir tesisin from ile to arasındaki test pencereleri (varsayılan yaklaşık bir hafta öncesinden bir ay sonrasına kadar) ya da yalnızca organisationId ile organizasyonun tüm tesislerindeki yaklaşan pencereler.
  • results: Test sonuçları. Bir pencere ve sonuçları: gönderildikten sonra saklanır, test sürerken canlı hesaplanır (walk testi kontrol listesi), planlanmış veya iptal edilmiş pencereler için null'dur. Tesiste Duress gerektirir. startsAtKey gerektirir.

Parametreler

AdTürAçıklama
action*"schedules" | "windows" | "results"Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır.
scope"facility" | "brand" | "organisation"Varsayılan facility (schedules)
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır.
brandIdstringBir tesis yerine markanın şablonu için marka kimliği (schedules)
organisationIdstringscope organisation için (schedules, windows)
includeCancelledbooleanİptal edilenleri dahil et (schedules, windows)
limitintegerSayfa başına öğe (varsayılan 25, en fazla 100) (schedules, windows)
cursorstringÖnceki sayfadan nextCursor (schedules, windows)
fromstringISO tarih-saati (windows)
tostringISO tarih-saati (windows)
startsAtKeystringduress_tests_read windows'tan test penceresi (startsAtKey) (results)
duress_tests_writeDuress ConfigurationTehdit ve Panik

Duress test programlarını oluşturur, değiştirir ve iptal eder; bir tesisin paylaşılan bir programı nasıl izleyeceğini belirler ve yaklaşan tek bir test penceresini iptal eder. Her değişiklik gelecekteki pencereleri oluşturur veya yeniden yazar ve paydaşlara e-posta gönderir; bu nedenle her biri onay ister.

Programlar, hedeflerinin tamamında Duress Configuration yetkisi gerektirir (organizasyon genelindeki programlar için bir organizasyon yöneticisi). Saatler her tesisin saat dilimindedir. Programları ve pencereleri önce duress_tests_read ile okuyun; hemen bir test başlatmak için duress_start_test kullanın.

Eylemler:

  • create_schedule: Test programı oluşturun. target içindeki her tesiste yaklaşık bir yıl ilerisine kadar pencereler oluşturur ve rezervasyon onayı e-postası gönderir. Gerekli: name, type, target, startDate, localStartTime ve recurrence. Gerekli: name, type, target, startDate, localStartTime, recurrence. Onay ister.
  • update_schedule: Bir test programını değiştirin. Gönderilmeyen alanlar değerlerini korur. Gelecekteki pencereler yeniden yazılır (başlamış olanlara dokunulmaz) ve paydaşlara değişiklik bildirimi gider. Sonrasında sonuçtaki ownerScope değerini kullanın. Gerekli: ownerScope, scheduleId. Onay ister.
  • cancel_schedule: Bir test programını iptal edin. Programı ve gelecekteki pencerelerini iptal eder ve iptal e-postası gönderir. Kendi kopyası olan tesisler kopyalarını korur. Gerekli: ownerScope, scheduleId. Onay ister.
  • set_facility_override: Paylaşılan bir programı tek bir tesis için değiştirin. mode follow (paylaşılan programı burada yeniden uygula), skip (burada durdur) veya own (burada schedule değerinden oluşturulan bir kopyayla değiştir). Yalnızca o tesiste Duress Configuration gerektirir. Gerekli: ownerScope, scheduleId, mode. Onay ister.
  • cancel_window: Tek bir test penceresini iptal edin. Bir tesisteki planlanmış tek bir testi iptal eder (program devam eder) ve paydaşlarına e-posta gönderir. Tesiste Duress yetkisi gerektirir; etkin bir test bunun yerine duress_end_test ile sonlandırılır. Gerekli: startsAtKey. Onay ister.

Parametreler

AdTürAçıklama
action*"create_schedule" | "update_schedule" | "cancel_schedule" | "set_facility_override" | "cancel_window"Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır.
namestringE-postalarda ve takvimde gösterilir (create_schedule, update_schedule)
type"walk" | "comms" | "drill"walk (her butona basılır), comms (izleme yolu başına bir basış) veya drill (prova edilmiş bir müdahale) (create_schedule, update_schedule)
targetobjectHangi tesisler: tüm organizasyon, brandIds veya facilityIds (create_schedule, update_schedule)
startDatestringİlk tekrar, her tesisin saat diliminde YYYY-MM-DD (create_schedule, update_schedule)
localStartTimestringHer tesisin saat diliminde HH:mm (create_schedule, update_schedule)
durationMinutesintegerVarsayılan 60 (create_schedule, update_schedule)
recurrence"once" | "monthly" | "quarterly" | "twice-yearly" | "yearly"once, monthly, quarterly, twice-yearly veya yearly (create_schedule, update_schedule)
repeatOnobjectnullAynı tarih yerine ayın n'inci hafta gününde tekrarlar; null temizler (create_schedule, update_schedule)
monitoringCentreMode"test-codes" | "none"test-codes sinyalleri test olarak gönderir; none izleme merkezini sürecin dışında tutar (create_schedule, update_schedule)
extraEmailsarrayRezervasyon, hatırlatmalar ve sonuçlar bu kişilere de e-postayla gönderilir (create_schedule, update_schedule)
organisationIdstringVarsayılan: bağlı tesisin organizasyonu (create_schedule, update_schedule, cancel_schedule, set_facility_override)
ownerScopestringduress_tests_read schedules sonucundan, ör. brand#b-123; hedef değiştiğinde değişebilir (update_schedule, cancel_schedule, set_facility_override)
scheduleIdstringduress_tests_read schedules sonucundan (update_schedule, cancel_schedule, set_facility_override)
facilityIdstringTesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. (set_facility_override, cancel_window)
mode"follow" | "skip" | "own"follow, skip veya own (set_facility_override)
scheduleobjectmode own: kopyanın alanları (target her zaman bu tesistir); gönderilmeyen alanlar paylaşılan programdan alınır (set_facility_override)
startsAtKeystringduress_tests_read windows sonucundaki test penceresi (startsAtKey) (cancel_window)
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın
duress_unlock_doorsTehdit ve Panik

Bir duress alarmı için kapıların kilidini açar, ör. polisin veya ilk yardım ekibinin içeri girmesi için: basılan butona bağlı kapılar, yoksa müdahale planının kapıları. Tümü için doorIds alanını göndermeyin veya bazılarını listeleyin. Her kilit açma, olay zaman çizelgesinde ve Erişim Kayıtları'nda yer alır.

Test veya çözülmüş alarmlar için asla kullanılmaz. Tesiste Door/Gate Access gerektirir.

Önce onaylayın. Hangi kapıların açılacağını görmek için confirm olmadan çağırın, kullanıcıya bildirin ve kullanıcı kabul ettiğinde confirm: true ile yeniden çağırın.

Parametreler

AdTürAçıklama
incidentId*stringduress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...).
doorIdsarrayconfirm olmadan listelenen kapılardan bazıları. Tümü için göndermeyin.
confirmbooleanYalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın