Alarmintegraties

Koppelt een faciliteit aan de template van een meldkamerpartner en beheert die koppeling: opslaan (template, abonneenummer, zonetabel, events, faciliteitvelden), verwijderen, goedkeuring aanvragen, een testsignaal sturen, activeren na een geslaagde test en een voorbereide wijziging verwerpen.

Een live koppeling (active of failing) verandert alleen met applyMode: staged houdt alarmen op de live instellingen tot een test van de voorbereide wijziging slaagt en je die activeert; immediate past de wijziging direct toe. Geheime velden worden geaccepteerd maar nooit teruggegeven. Vereist External Integrations bij de faciliteit. Lees eerst met alarm_integrations_read connections.

Acties:

• save: Een koppeling opslaan. templateId is nodig voor een nieuwe koppeling. fields stelt faciliteitvelden in op sleutel (null wist er een; geheimen worden versleuteld). Geef bij een live koppeling applyMode mee, anders mislukt de aanroep met apply-mode-required. Vereist partnerId. Vraagt om bevestiging.
• remove: Een koppeling verwijderen. Verwijdert de koppeling van de faciliteit met de partner, inclusief een eventuele voorbereide wijziging; vanaf hier gaan geen alarmen meer naar die meldkamer. Vereist partnerId. Vraagt om bevestiging.
• request_approval: Goedkeuring aanvragen. Vraagt de meldkamer de koppeling goed te keuren of een abonneenummer toe te wijzen (templates met partnergoedkeuring). Vereist partnerId.
• send_test_signal: Een testsignaal sturen. Zet een echt testsignaal naar de meldkamer in de wachtrij; vraag test_signal_status op. staged: true test de voorbereide wijziging in plaats van de live instellingen. Vereist partnerId. Vraagt om bevestiging.
• activate: Een koppeling of wijziging activeren. Zet een openstaande koppeling live, promoveert een voorbereide wijziging of bevestigt een niet-geteste wijziging. Activeren vereist de requestId van een test die na de laatste wijziging is geslaagd: een test van de voorbereide wijziging (staged: true) promoveert een voorbereide wijziging, een live test bevestigt een niet-geteste wijziging. Vereist partnerId, requestId. Vraagt om bevestiging.
• discard_pending_change: Een voorbereide wijziging verwerpen. Verwijdert de voorbereide wijziging; de live instellingen blijven ongewijzigd. discarded is false als er niets was voorbereid. Vereist partnerId. Vraagt om bevestiging.

Voegt eigen alarmbestemmingen toe, wijzigt en verwijdert ze en stuurt er testsignalen naar: je eigen meldontvanger, een relaisbord, sms, spraak, e-mail, webhooks, teamchat of een on-call-oproepdienst (de kanaallijst), bij een faciliteit (standaard), merk of organisatie.

Niet-geheime instellingen horen in config; geheimen (wachtwoorden, webhook-URL's, sleutels) horen in fields op instellingspad en worden versleuteld, nooit teruggegeven. Ingeschakelde bestemmingen hebben een volledige config nodig. Bestemmingen van een faciliteit vereisen daar External Integrations of Duress Configuration; bestemmingen van een merk of organisatie vereisen organisatiebrede toegang. Lees eerst met alarm_integrations_read destinations.

Acties:

• save: Een bestemming opslaan. Zonder connectionId wordt er een toegevoegd (channel en name nodig); met connectionId wordt er een gewijzigd (het kanaal blijft). config vervangt, indien meegestuurd, de niet-geheime instellingen; geheimen die niet in fields staan, blijven behouden. Vraagt om bevestiging.
• remove: Een bestemming verwijderen. Verwijdert de bestemming; een relais van een faciliteit stuurt dan ook het alarmrelais niet meer aan. Vereist connectionId. Vraagt om bevestiging.
• send_test_signal: Een test naar een bestemming sturen. Zet een echt testbericht naar de bestemming in de wachtrij; vraag alarm_integrations_read test_signal_status op met de faciliteit. Bestemmingen van een merk of organisatie worden getest vanuit facilityId. Vereist connectionId. Vraagt om bevestiging.

Leest waar de duress-alarmen van een faciliteit buiten Performance Hub naartoe gaan: de meldkamerkoppelingen (partner, template, abonneenummer, zonetabel, status, wat nog ontbreekt, voorbereide wijzigingen), eigen bestemmingen (meldontvangers, relais, sms, spraak, e-mail, webhooks, chat, oproepdiensten) bij de faciliteit, het merk en de organisatie, een routeringsvoorbeeld, het afleverlogboek en de uitkomsten van testsignalen.

Vereist External Integrations of Duress Configuration bij de faciliteit. Geheimen en versleutelde waarden worden nooit getoond, alleen { key, secret, hasValue }; telefoonnummers en adressen van personen worden uit routering en afleveringen weggelaten. Tijden zijn in ISO. Wijzig ze met alarm_integrations_connections_write en alarm_integrations_destinations_write.

Acties:

• connections: Meldkamerkoppelingen. De partnerkoppelingen van de faciliteit: template, abonneenummer (linkingIdentifier), zonetabel, events, connectionStatus, missing (wat het live gaan blokkeert), pendingChange (voorbereid, nog niet live) en untestedChange. canEdit: External Integrations hier.
• destinations: Eigen bestemmingen. Bestemmingen die voor de faciliteit kunnen afgaan (die van de faciliteit zelf, van het merk en van de organisatie, elk met canEdit), of met ownerScope die van één scope. Instellingen in config; geheimen als fields { key, secret, hasValue }.
• routing: Routeringsvoorbeeld. Waar een alarm op dit moment naartoe zou gaan (alleen live instellingen), zoals universal-api het bepaalt: bestemmingen met lane, events en config zonder geheimen, problems die uitleggen wat is weggelaten, en pendingChanges die nog niet worden gerouteerd. eventType houdt alleen over wat dat event ontvangt.
• deliveries: Afleverlogboek. Alarmafleveringen, nieuwste eerst (status, kanaal, ontvanger, latentie, openbare foutmelding). Een gefilterde pagina kan kort zijn en toch een nextCursor hebben. Apparaatmeldingen verschijnen als kind alert.
• test_signal_status: Uitkomst van het testsignaal. queued tot universal-api een poging registreert, daarna succeeded (een ontvanger heeft het bevestigd of het is verstuurd) of failed, met de afleverregels. Gebruik de faciliteit van waaruit de test is verstuurd. Vereist requestId.