Push shows a notification on a person’s device even when Hermetry is not open. The push channel delivers to the browsers and app installs a member has registered.
In development: The web app does not yet offer a step to allow notifications in your browser and register it, and the mobile app is not released. Until then, push reaches nobody in most organisations. Use the bell, e-mail recipients and chat apps instead.
What push carries
A push message has the notification’s title and text, and a link that opens the related page (for an alarm, the alarm page). It never carries e-mail HTML or attachments.
Push is for members only: it needs a member account with a registered device. Address-only recipients (e-mail addresses, phone numbers) never get push.
Push Settings
An administrator opens Settings > Push Settings (“How many devices a member may register and which plugin sends browser push”):
| Setting | Default | Meaning |
|---|---|---|
| Push notifications | On | Send push to this workspace’s browsers and app installs. Off: no push is sent; members keep their registered devices. |
| Devices per member | 10 | How many browsers and app installs one member may register (1 to 100). A new device past the limit is refused. |
| Browser push plugin | webpush | The plugin browser notifications are sent through when more than one is installed. |
The sender identity for browser push (its key pair and contact address) is on Settings > Notifications under Push Notifications. Leave the keys empty to use the platform’s own.
Changing push settings needs Change push settings (Admin by default).
The person’s choices
Each member can switch push off in My Profile > Preferences > Push notifications. Push respects quiet hours. Critical alarms ignore both by default. See Your notification preferences.
Registered devices
- A registered device belongs to one member. If another member registers the same browser, it moves to them.
- A device whose registration the push service reports as gone is removed automatically.
- When a member leaves the organisation, their registrations are removed.
API
Registration is available through the API for your own integrations:
| Call | Does |
|---|---|
POST /tenant/{tenantId}/api/notifications/push/subscribe | Registers a browser push subscription for the signed-in member: { "endpoint": "https://…", "keys": { "p256dh": "…", "auth": "…" } }. |
DELETE /tenant/{tenantId}/api/notifications/push/subscribe | Removes the member’s subscriptions. |
These calls need the member’s own session and the permissions Subscribe own device to push / Unsubscribe own device from push (User by default).