Central stations

YourSixOS comes with first-class support for central station monitoring. The ideal setup is that security events will be sent off to central stations for professional investigation, and that the central station will take appropriate action (e.g. call the police or dispatch guards).

In YourSixOS, the central stations have dedicated API entrypoints and applications, and the integrator can choose to authorize featured central stations access to desired sites. In order to become a featured central station in YourSix, the central station needs to have a partnership with YourSix.

Integration workflow

YourSix has worked closely with the market leaders in central station software to provide integrations of YourSixOS in those software products.

At its core, a central station software integrates with YourSixOS by:

1. Receiving and acting as a shared inbox of event notifications. When having received an event notification from YourSixOS, the central station software typically provides the operator with an alarm on their end. The operator then opens that alarm.

2. Depending on level of integration, the central station software can either bring up YourSixOS native alarm investigation application called Inspect, or provide their own investigation tools using our Central Station API.

The diagram below depicts the flow:

Authorization and Authentication

While the central station software vendor is integrating YourSixOS as a software service, the integration is only enabled for those central stations (the actual monitoring centers) that YourSix has approved and has a strategic partnership with.

After YourSix has enabled the integration for a certain central station, YourSix will authorize specific integrators to work with that specific central station. First after doing so, the integrators will have the ability to authorize the central station access to specific sites.

It is thus a three-part onboarding process where trust is established between YourSix and the central station, YourSix and the integrator as well as between the integrator and the central station.

YourSixOS Inspect

YourSixOS Inspect is, in essence, YourSixOS's native central station application which provides a timeline grid of video widgets which allows for live video streaming, recording playback, peripheral control and speaker callouts.

Inspect is launched from a pre-signed URL that YourSixOS will send as part of event notification request payload when using the recipient type central station.

Webhooks

Webhooks are sent using HTTPS POST, and with the event serialized as JSON in request data. The JSON schema is entirely derived from the event structure and examples of each event are available in the event catalog.

In addition to the structure described in the event concept, central station webhooks carry two additional attributes:

• Central station account identifier (name: centralStationAccount, type: string)
• Callback URL to Inspect (name: callbackUrl, type: string)

For more details on how the webhooks are sent, review the dataflows.

Example

{
    "eventTopic": "topic-code",
    "eventCode": "event-code",
    "eventDescription": "A verbal description of the event",
    "eventOccurred": "2023-09-07T10:18:41+02:00",
    "eventId": "1ee4d572-7b62-6136-86c8-35b55032bfe2",
    "eventData": {...},
    "centralStationAccount": "CS-12345", 
    "callbackUrl": "https://inspect.cloud.yoursix.com?token=xyz"
}