Notifications
Notifications keep you informed about important events in your TWIST installation, even when you're not actively using the app. You'll receive alerts for routine activity, device status changes, access requests, and other critical events.
You receive notifications from all installations you have access to, not just the active installation. Notifications indicate which installation they're from.
Types of Notifications
Routine Activity
What: Notifications when routines run or fail Examples:
- "Sunset Routine ran successfully"
- "Wind Protection Routine triggered"
- "Morning Wake-Up failed: Some products offline"
Use Case: Monitor automatic routines and respond to failures
Device Status Changes
What: Notifications when devices go online or offline Examples:
- "Gateway is offline"
- "Bedroom Screen is offline"
- "Pergola reconnected"
Use Case: Stay informed about device connectivity issues
Access Requests (Future Versions)
What: Notifications when someone requests access to your installation Examples:
- "User John Doe requests access to Home installation"
- "Access request approved"
Use Case: Manage who has access to your installation
In v01.00, access requests are auto-approved. Future versions will require owner approval and send notifications.
System Events
What: Notifications about system-level events Examples:
- "Firmware update available for Gateway"
- "Installation requires attention"
- "Product configuration incomplete"
Use Case: Stay informed about system maintenance and issues
Enabling Notifications
- Mobile App
- Web Portal
Enable Push Notifications
-
Grant OS-Level Permissions
- When you first install the app, you'll be prompted to allow notifications
- If you declined, go to your device Settings → Apps → TWIST → Notifications → Enable
-
Enable in App Settings
- Open the TWIST app
- Go to Settings → Notifications
- Toggle Enable Notifications to ON
-
Choose Events to Receive
- Select which types of events you want to be notified about:
- Routine Activity: Notifications when routines run or fail
- Device Status: Notifications when devices go online/offline
- System Events: Notifications about updates, issues, etc.
- Access Requests: Notifications when someone requests access (future versions)
- Select which types of events you want to be notified about:
-
Configure Per Installation (if supported)
- Some apps allow you to configure notification preferences per installation
- Go to Settings → Installations → Select Installation → Notifications
- Choose which events to receive for this installation
Manage Notification Preferences
-
Navigate to Settings
- Go to Settings → Notifications
-
Configure Preferences Per Installation
- Select the installation
- Choose which events to receive notifications for
-
Configure Channels (if supported)
- Email: Receive notifications via email
- External Connectors: Integrate with external services (e.g., Slack, Microsoft Teams)
-
Set Notification Frequency
- Immediate: Receive notifications as events occur
- Digest: Receive a summary of events once per day or week
Receiving Notifications
- Mobile App
- Web Portal
How Notifications Appear
Notifications appear as push notifications on your mobile device:
-
Notification Banner
- Appears at the top of your screen (or lock screen)
- Shows the installation name and event
-
Notification Sound/Vibration
- Based on your device notification settings
-
Notification Badge
- App icon shows a badge with the number of unread notifications
Interacting with Notifications
Tap a Notification:
- Opens the relevant screen in the app
- Example: Tapping "Gateway offline" opens the Gateway product page
Swipe to Dismiss:
- Removes the notification without opening the app
View Notification History:
- Some apps provide a notification history or activity log
- Go to Settings → Notifications → History (if available)
In-Portal Notifications
Notifications may appear as:
-
Notification Bell Icon
- Icon in the header shows unread notifications
- Click to view notification list
-
Email Notifications
- Receive emails based on your preferences
-
External Connectors
- Notifications sent to configured external services
Managing Notifications
- Mobile App
- Web Portal
Adjust Notification Settings
-
Navigate to Settings
- Go to Settings → Notifications
-
Enable/Disable Notification Types
- Toggle specific event types on or off:
- Routine Activity
- Device Status
- System Events
- Access Requests
- Toggle specific event types on or off:
-
Configure Per Installation
- If supported, configure notifications separately for each installation
- Go to Settings → Installations → Select Installation → Notifications
-
Adjust Sound/Vibration
- Go to your device Settings → Apps → TWIST → Notifications
- Configure sound, vibration, and banner settings
Do Not Disturb
Temporarily disable notifications without changing settings:
-
Enable Do Not Disturb
- Go to Settings → Notifications → Do Not Disturb
- Set a time period (e.g., next 2 hours, until tomorrow morning)
-
Disable Do Not Disturb
- Notifications resume automatically after the set period
- Or manually disable in Settings
Adjust Preferences
-
Navigate to Settings
- Go to Settings → Notifications
-
Configure Per Installation
- Select the installation
- Enable/disable notification types
-
Configure Channels
- Update email address or external connectors
- Set notification frequency (immediate vs. digest)
Notification Examples
Example 1: Routine Success
Notification:
- Title: "Sunset Routine completed"
- Message: "All screens closed successfully"
- Installation: Home
Action: Tap to view routine details
Example 2: Routine Failure
Notification:
- Title: "Morning Wake-Up failed"
- Message: "Bedroom Screen is offline"
- Installation: Home
Action: Tap to view the offline device and troubleshoot
Example 3: Device Offline
Notification:
- Title: "Gateway is offline"
- Message: "Check your internet connection"
- Installation: Home
Action: Tap to view gateway status and reconnect
Example 4: Access Request (Future)
Notification:
- Title: "Access request from Jane Smith"
- Message: "Jane Smith requests access to Home installation"
- Installation: Home
Action: Tap to approve or deny the request
Expected Result
After enabling notifications:
- You receive push notifications for selected events
- Notifications appear even when the installation is not active
- You can tap notifications to open the relevant screen
- Notification preferences are saved per installation (if supported)
Troubleshooting
Not Receiving Notifications
Check OS Permissions:
- Go to device Settings → Apps → TWIST → Notifications
- Ensure notifications are enabled
Check App Settings:
- Open TWIST app → Settings → Notifications
- Ensure notifications are enabled for the desired events
Check Network:
- Ensure your device has an active internet connection
- Push notifications require network connectivity
Check Do Not Disturb:
- Ensure Do Not Disturb is not enabled (either in TWIST or device settings)
Restart App:
- Close and reopen the TWIST app
- This refreshes notification settings
Receiving Too Many Notifications
Disable Specific Event Types:
- Go to Settings → Notifications
- Turn off notification types you don't need (e.g., Device Status)
Configure Per Installation:
- If you have multiple installations, configure notifications separately
- Disable notifications for installations you don't monitor actively
Use Digest Mode (if available):
- Go to Settings → Notifications
- Change frequency from "Immediate" to "Daily Digest"
Notifications Not Opening Correct Screen
Update App:
- Ensure you're using the latest version of the TWIST app
- Check the app store for updates
Clear Cache:
- Go to Settings → App → Clear Cache
- This resets notification deep links
Report Issue:
- If notifications consistently open the wrong screen, report this via Settings → Help → Report Issue
Notification Sound Too Loud/Quiet
Adjust Device Settings:
- Go to device Settings → Apps → TWIST → Notifications
- Adjust notification sound or vibration settings
Use Custom Sound (if supported):
- Some devices allow custom notification sounds per app
- Set a custom sound for TWIST notifications
Privacy and Security
- Notification Content: Notifications may contain sensitive information (e.g., "Front Door opened")
- Lock Screen: Configure your device to hide notification content on the lock screen if needed
- Do Not Disturb: Use Do Not Disturb mode to prevent notifications during private times
- Unsubscribe: You can disable notifications at any time in Settings
Best Practices
- Enable Critical Notifications: Always enable notifications for device offline events and routine failures
- Disable Non-Essential: Turn off notifications for events you don't need to monitor
- Use Per-Installation Settings: Configure notifications separately for each installation based on importance
- Test Notifications: After enabling, trigger a routine to test that notifications are working
- Keep App Updated: Update the TWIST app regularly to ensure notifications work correctly
- Check Permissions: Periodically verify that notification permissions haven't been revoked
Next Steps
After setting up notifications:
- Create Routines – Set up routines to receive activity notifications
- Troubleshooting – Learn how to troubleshoot common issues
- Control Products – Continue controlling products