Интеграции тревог

Подключает объект к шаблону партнёра по мониторингу и управляет этим подключением: сохранение (шаблон, номер счёта, карта зон, события, поля объекта), удаление, запрос одобрения, отправка тестового сигнала, активация после успешного теста и отмена подготовленного изменения.

Действующее подключение (активное или со сбоями) изменяется только с applyMode: staged оставляет тревоги на действующих настройках, пока тест подготовленного изменения не пройдёт успешно и вы его не активируете; immediate применяет изменения сразу. Секретные поля принимаются, но никогда не возвращаются. Требуется External Integrations на объекте. Сначала прочитайте данные с помощью alarm_integrations_read connections.

Действия:

• save: Сохранить подключение. Для нового подключения требуется templateId. fields задаёт поля объекта по ключу (null сбрасывает поле; секреты шифруются). Для действующего подключения передайте applyMode, иначе вызов завершится ошибкой apply-mode-required. Требуется partnerId. Запрашивает подтверждение.
• remove: Удалить подключение. Удаляет подключение объекта к партнёру вместе с подготовленными изменениями; тревоги с этого объекта перестают поступать в этот центр мониторинга. Требуется partnerId. Запрашивает подтверждение.
• request_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); с ним изменяет существующего (канал не меняется). Переданный config заменяет несекретные настройки; секреты, не указанные в fields, сохраняются. Запрашивает подтверждение.
• remove: Удалить получателя. Удаляет получателя; реле объекта также перестаёт управлять тревожным реле. Требуется connectionId. Запрашивает подтверждение.
• send_test_signal: Отправить тест получателю. Ставит в очередь реальное тестовое сообщение получателю; проверяйте alarm_integrations_read test_signal_status с указанием объекта. Получатели бренда и организации тестируются с facilityId. Требуется connectionId. Запрашивает подтверждение.

Показывает, куда за пределы Performance Hub направляются тревоги Duress объекта: подключения к центрам мониторинга (партнёр, шаблон, номер счёта, карта зон, статус, препятствия для запуска, подготовленные изменения), пользовательские получатели (приёмники мониторинга, реле, 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: Результат тестового сигнала. queued, пока universal-api не зафиксирует попытку, затем succeeded (получатель подтвердил получение или сигнал был отправлен) или failed, со строками доставки. Используйте объект, с которого был отправлен тест. Требуется requestId.