경보 연동

시설을 모니터링 파트너의 템플릿에 연결하고 해당 연결을 관리합니다. 저장(템플릿, 계좌 번호, 구역 매핑, 이벤트, 시설 필드), 제거, 승인 요청, 테스트 신호 전송, 테스트 성공 후 활성화, 스테이징된 변경 취소를 지원합니다.

라이브 연결(active 또는 failing)은 applyMode를 지정해야만 변경됩니다. staged는 스테이징된 테스트가 성공하고 활성화할 때까지 경보에 라이브 설정을 유지하며, immediate는 즉시 적용합니다. 비밀 필드는 입력할 수 있지만 반환되지 않습니다. 해당 시설에 대한 External Integrations 권한이 필요합니다. 먼저 alarm_integrations_read connections로 확인하십시오.

작업:

• save: 연결을 저장합니다. 새 연결에는 templateId가 필요합니다. fields는 키별로 시설 필드를 설정합니다(null이면 해제, 비밀 값은 봉인됨). 라이브 연결에서는 applyMode를 전달해야 하며, 그렇지 않으면 apply-mode-required로 호출이 실패합니다. 필요한 값: partnerId. 확인을 요청합니다.
• remove: 연결을 제거합니다. 스테이징된 변경을 포함하여 시설과 파트너의 연결을 제거하며, 이후 이 시설의 경보는 해당 관제 센터로 전송되지 않습니다. 필요한 값: partnerId. 확인을 요청합니다.
• request_approval: 승인을 요청합니다. 관제 센터에 연결 승인 또는 계좌 번호 할당을 요청합니다(partner-approval 템플릿). 필요한 값: partnerId.
• send_test_signal: 테스트 신호를 전송합니다. 관제 센터로 실제 테스트 신호를 대기열에 추가합니다. test_signal_status를 폴링하십시오. staged: true이면 라이브 설정 대신 스테이징된 변경을 테스트합니다. 필요한 값: partnerId. 확인을 요청합니다.
• activate: 연결 또는 변경을 활성화합니다. 대기 중인 연결을 라이브로 전환하거나, 스테이징된 변경을 승격하거나, 테스트되지 않은 변경을 확정합니다. 활성화하려면 마지막 변경 이후 성공한 테스트의 requestId가 필요합니다. 스테이징된 테스트(staged: true)는 스테이징된 변경을 승격하고, 라이브 테스트는 테스트되지 않은 변경을 확정합니다. 필요한 값: partnerId, requestId. 확인을 요청합니다.
• discard_pending_change: 스테이징된 변경을 취소합니다. 스테이징된 변경을 삭제하며 라이브 설정은 그대로 유지됩니다. 스테이징된 내용이 없으면 discarded는 false입니다. 필요한 값: partnerId. 확인을 요청합니다.

시설(기본값), 브랜드 또는 조직의 사용자 지정 경보 대상을 추가, 변경, 삭제하고 테스트 발송합니다. 대상에는 자체 모니터링 수신기, 릴레이 보드, SMS, 음성, 이메일, 웹훅, 팀 채팅 또는 온콜 호출 서비스(채널 목록)가 있습니다.

비밀이 아닌 설정은 config에, 비밀 값(비밀번호, 웹훅 URL, 키)은 설정 경로별로 fields에 넣으며, 봉인되어 반환되지 않습니다. 활성화된 대상에는 완전한 config가 필요합니다. 시설 대상에는 해당 시설에 대한 External Integrations 또는 Duress Configuration 권한이 필요하며, 브랜드 및 조직 대상에는 조직 전체 접근 권한이 필요합니다. 먼저 alarm_integrations_read destinations로 확인하십시오.

작업:

• save: 대상을 저장합니다. connectionId가 없으면 새로 추가하고(channel과 name 필요), 있으면 해당 대상을 변경합니다(channel은 유지). config를 보내면 비밀이 아닌 설정을 대체하며, fields에서 생략한 비밀 값은 유지됩니다. 확인을 요청합니다.
• remove: 대상을 삭제합니다. 대상을 삭제하며, 시설 릴레이인 경우 경보 릴레이 구동도 중지됩니다. 필요한 값: connectionId. 확인을 요청합니다.
• send_test_signal: 대상에 테스트를 전송합니다. 대상으로 실제 테스트 메시지를 대기열에 추가합니다. 해당 시설로 alarm_integrations_read test_signal_status를 폴링하십시오. 브랜드 및 조직 대상은 facilityId에서 테스트합니다. 필요한 값: connectionId. 확인을 요청합니다.

시설의 Duress 경보가 Performance Hub 외부의 어디로 전송되는지 읽습니다. 관제 센터 연결(파트너, 템플릿, 계좌 번호, 구역 매핑, 상태, 준비 미비 항목, 스테이징된 변경), 시설과 그 브랜드 및 조직의 사용자 지정 대상(모니터링 수신기, 릴레이, SMS, 음성, 이메일, 웹훅, 채팅, 호출), 라우팅 미리 보기, 전송 로그 및 테스트 신호 결과를 확인할 수 있습니다.

해당 시설에 대한 External Integrations 또는 Duress Configuration 권한이 필요합니다. 비밀 값과 봉인된 값은 표시되지 않고 { key, secret, hasValue }만 표시되며, 사람의 전화번호와 주소는 라우팅 및 전송 정보에서 가려집니다. 시간은 ISO 형식입니다. 변경하려면 alarm_integrations_connections_write 및 alarm_integrations_destinations_write를 사용하십시오.

작업:

• connections: 관제 센터 연결. 시설의 파트너 연결: 템플릿, 계좌 번호(linkingIdentifier), 구역 매핑, 이벤트, connectionStatus, missing(라이브 전환을 막는 항목), pendingChange(스테이징됨, 아직 라이브 아님) 및 untestedChange. canEdit: 이 시설에 대한 External Integrations 권한.
• destinations: 사용자 지정 대상. 시설에 대해 발송될 수 있는 대상(시설 자체, 브랜드 및 조직의 대상, 각각 canEdit 포함), 또는 ownerScope를 지정하면 해당 범위의 대상. 설정은 config에, 비밀 값은 fields { key, secret, hasValue }로 표시됩니다.
• routing: 라우팅 미리 보기. universal-api가 판단하는 대로 지금 경보가 전송될 위치(라이브 설정만 해당): lane, events, 비밀 값을 제외한 config가 포함된 대상, 제외된 항목을 설명하는 problems, 아직 라우팅되지 않은 pendingChanges. eventType을 지정하면 해당 이벤트를 수신하는 항목만 남깁니다.
• deliveries: 전송 로그. 최신순 경보 전송 내역(상태, 채널, 수신기, 지연 시간, 공개 오류 문구). 필터링된 페이지는 항목 수가 적어도 nextCursor가 있을 수 있습니다. 기기 알림은 kind alert로 표시됩니다.
• test_signal_status: 테스트 신호 결과. universal-api가 시도를 기록할 때까지 queued이며, 이후 succeeded(수신기가 응답했거나 전송됨) 또는 failed가 되고 전송 행이 함께 표시됩니다. 테스트를 보낸 시설을 사용하십시오. 필요한 값: requestId.