Alarm entegrasyonları

Bir tesisi bir izleme ortağının şablonuna bağlar ve bu bağlantıyı yönetir: kaydetme (şablon, hesap numarası, bölge eşlemesi, olaylar, tesis alanları), kaldırma, onay isteme, test sinyali gönderme, başarılı bir testten sonra etkinleştirme ve hazırlanan bir değişikliği atma.

Canlı bir bağlantı (active veya failing) yalnızca applyMode ile değişir: staged, hazırlanan bir test başarılı olup siz etkinleştirene kadar alarmları canlı ayarlarda tutar; immediate hemen uygular. Gizli alanlar kabul edilir ancak asla döndürülmez. Tesiste External Integrations gerektirir. Önce alarm_integrations_read connections ile okuyun.

Eylemler:

• save: Bağlantıyı kaydedin. Yeni bir bağlantı için templateId gerekir. fields, tesis alanlarını anahtara göre ayarlar (null birini temizler; gizli değerler mühürlenir). Canlı bir bağlantıda applyMode gönderin, aksi halde çağrı apply-mode-required ile başarısız olur. Gerekli: partnerId. Onay ister.
• remove: Bağlantıyı kaldırın. Tesisin ortakla bağlantısını, hazırlanan değişikliklerle birlikte kaldırır; alarmlar artık buradan o izleme merkezine gitmez. Gerekli: partnerId. Onay ister.
• request_approval: Onay isteyin. İzleme merkezinden bağlantıyı onaylamasını veya bir hesap numarası atamasını ister (ortak onaylı şablonlar). Gerekli: partnerId.
• send_test_signal: Test sinyali gönderin. İzleme merkezine gerçek bir test sinyalini kuyruğa alır; test_signal_status ile durumu sorgulayın. staged: true, canlı ayarlar yerine hazırlanan değişikliği test eder. Gerekli: partnerId. Onay ister.
• activate: Bir bağlantıyı veya değişikliği etkinleştirin. Bekleyen bir bağlantıyı canlıya alır, hazırlanan bir değişikliği canlıya taşır veya test edilmemiş bir değişikliği onaylar. Etkinleştirme, son değişiklikten sonra başarılı olan bir testin requestId değerini gerektirir: hazırlanan bir test (staged: true) hazırlanan değişikliği canlıya taşır, canlı bir test ise test edilmemiş bir değişikliği onaylar. Gerekli: partnerId, requestId. Onay ister.
• discard_pending_change: Hazırlanan değişikliği atın. Hazırlanan değişikliği bırakır; canlı ayarlara dokunulmaz. Hazırlanmış bir şey yoksa discarded false olur. Gerekli: partnerId. Onay ister.

Özel alarm hedeflerini ekler, değiştirir, siler ve test amaçlı tetikler: kendi izleme alıcınız, bir röle kartı, SMS, sesli arama, e-posta, webhook'lar, ekip sohbeti veya bir nöbet çağrı hizmeti (kanal listesi); tesis (varsayılan), marka veya organizasyon düzeyinde.

Gizli olmayan ayarlar config içine girer; gizli değerler (parolalar, webhook URL'leri, anahtarlar) ayar yoluna göre fields içine girer, mühürlenir ve asla döndürülmez. Etkin hedefler eksiksiz bir config gerektirir. Tesis hedefleri orada External Integrations veya Duress Configuration gerektirir; marka ve organizasyon hedefleri organizasyon genelinde erişim gerektirir. Önce alarm_integrations_read destinations ile okuyun.

Eylemler:

• save: Hedefi kaydedin. connectionId olmadan bir hedef ekler (channel ve name gerekir); connectionId ile bir hedefi değiştirir (kanal aynı kalır). config gönderildiğinde gizli olmayan ayarların yerini alır; fields içinde gönderilmeyen gizli değerler korunur. Onay ister.
• remove: Hedefi silin. Hedefi siler; bir tesis rölesi de alarm rölesini sürmeyi bırakır. Gerekli: connectionId. Onay ister.
• send_test_signal: Bir hedefe test gönderin. Hedefe gerçek bir test mesajını kuyruğa alır; tesisle birlikte alarm_integrations_read test_signal_status ile durumu sorgulayın. Marka ve organizasyon hedefleri facilityId üzerinden test edilir. Gerekli: connectionId. Onay ister.

Bir tesisin duress alarmlarının Performance Hub dışında nereye gittiğini okur: izleme merkezi bağlantıları (ortak, şablon, hesap numarası, bölge eşlemesi, durum, hazır olma eksikleri, hazırlanan değişiklikler), tesisteki, markasındaki ve organizasyonundaki özel hedefler (izleme alıcıları, röleler, SMS, sesli arama, e-posta, webhook'lar, sohbet, çağrı), bir yönlendirme önizlemesi, teslim günlüğü ve test sinyali sonuçları.

Tesiste External Integrations veya Duress Configuration gerektirir. Gizli ve mühürlü değerler asla gösterilmez, yalnızca { key, secret, hasValue } gösterilir; kişilerin numaraları ve adresleri yönlendirme ve teslim bilgilerinden çıkarılır. Saatler ISO biçimindedir. Bunları alarm_integrations_connections_write ve alarm_integrations_destinations_write ile değiştirin.

Eylemler:

• connections: İzleme merkezi bağlantıları. Tesisin ortak bağlantıları: şablon, hesap numarası (linkingIdentifier), bölge eşlemesi, olaylar, connectionStatus, missing (canlıya geçişi engelleyenler), pendingChange (hazırlanmış, henüz canlı değil) ve untestedChange. canEdit: burada External Integrations.
• destinations: Özel hedefler. Tesis için tetiklenebilen hedefler (kendi hedefleri, markasının ve organizasyonunun hedefleri, her biri canEdit ile) veya ownerScope ile tek bir kapsamın hedefleri. Ayarlar config içindedir; gizli değerler fields { key, secret, hasValue } olarak gösterilir.
• routing: Yönlendirme önizlemesi. Bir alarmın şu anda nereye gideceği (yalnızca canlı ayarlar), universal-api'nin çözümlediği şekliyle: lane, olaylar ve gizli değerler hariç config ile hedefler, dışarıda kalan her şeyi açıklayan problems ve henüz yönlendirilmeyen pendingChanges. eventType yalnızca o olayı alanları tutar.
• deliveries: Teslim günlüğü. En yeniden eskiye alarm teslimleri (durum, kanal, alıcı, gecikme, herkese açık hata metni). Filtrelenmiş bir sayfa kısa olabilir ve yine de nextCursor içerebilir. Cihaz uyarıları kind alert olarak görünür.
• test_signal_status: Test sinyali sonucu. universal-api bir deneme kaydedene kadar queued, ardından teslim satırlarıyla birlikte succeeded (bir alıcı onayladı veya gönderildi) ya da failed. Testin gönderildiği tesisi kullanın. Gerekli: requestId.