Vivi has an Emergency API which key that can be integrated with external software.
...
used with your existing emergency management system to trigger and cancel an emergency within Vivi.
| Note |
|---|
Please note: For the Vivi Emergency API to operate, your existing emergency management system needs to be able to output a web-based trigger. Please refer to the manufacturer’s instructions of your system for more information on if this is available. |
Getting the API key
You can request your API key by raising a support request within Vivi Central. Hyperlink ‘support request in Vivi Central’ to https://admin.vivi.Your io/support
In the triggers, you will need to insert your Emergency Type IDs and Location IDs are available from Vivi Central on the relevant pages.
Triggering:
ID and have the option of including the Location ID. The Emergency Type ID is the name of the emergency as shown in Vivi Central. Emergency types can be viewed and edited at: https://admin.vivi.io/emergencies/emergency-types Include hyperlink The Location ID is the name of a location or sub-location as shown in Vivi Central. Locations and sub-locations can be viewed and edited at: https://admin.vivi.io/organisations/locations.
Trigger an Emergency
Your emergency management system needs to output the following URL to trigger an emergency:
https://api.vivi.io/api/public/v1/emergencies/trigger?key=<api_key>&type=<emergency_type_id>&location=<location_id>
| Info |
|---|
<api_key>: Organisation API key |
...
– Required |
...
<emergency_type_id>: ID of emergency type to trigger |
...
– Required |
...
<location_id>: ID of location to trigger emergency at - Optional, trigger organisation wide emergency if not provided |
...
Cancelling an Emergency
Your emergency management system needs to output the following URL to cancel an emergency:
https://api.vivi.io/api/public/v1/emergencies/cancel?key=<api_key>&type=<emergency_type_id>&location=<location_id>
| Info |
|---|
...
<api_key>: Organisation API key |
...
– Required |
...
<emergency_type_id>: ID of emergency type to cancel |
...
– Required |
...
<location_id>: ID of location to cancel emergency at - Optional, cancel all emergencies currently active of the emergency type if not provided |
Tracking Emergencies
...
Check the Vivi Central – Emergencies Page after triggering from the URL, this is where all emergency activity is audited.
The Emergencies page in Vivi Central can be used to view and cancel currently active emergencies and stores a full history of previously run emergencies. This page can be accessed at: https://admin.vivi.io/emergencies/