Skip to main content

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.

Cross-Installation Notifications

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

v01.00

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

Enable Push Notifications

  1. Grant OS-Level Permissions

    • When you first install the app, you'll be prompted to allow notifications
    • If you declined, go to your device SettingsAppsTWISTNotifications → Enable
  2. Enable in App Settings

    • Open the TWIST app
    • Go to SettingsNotifications
    • Toggle Enable Notifications to ON
  3. 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)
  4. Configure Per Installation (if supported)

    • Some apps allow you to configure notification preferences per installation
    • Go to SettingsInstallations → Select Installation → Notifications
    • Choose which events to receive for this installation

Receiving Notifications

How Notifications Appear

Notifications appear as push notifications on your mobile device:

  1. Notification Banner

    • Appears at the top of your screen (or lock screen)
    • Shows the installation name and event
  2. Notification Sound/Vibration

    • Based on your device notification settings
  3. 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 SettingsNotificationsHistory (if available)

Managing Notifications

Adjust Notification Settings

  1. Navigate to Settings

    • Go to SettingsNotifications
  2. Enable/Disable Notification Types

    • Toggle specific event types on or off:
      • Routine Activity
      • Device Status
      • System Events
      • Access Requests
  3. Configure Per Installation

    • If supported, configure notifications separately for each installation
    • Go to SettingsInstallations → Select Installation → Notifications
  4. Adjust Sound/Vibration

    • Go to your device SettingsAppsTWISTNotifications
    • Configure sound, vibration, and banner settings

Do Not Disturb

Temporarily disable notifications without changing settings:

  1. Enable Do Not Disturb

    • Go to SettingsNotificationsDo Not Disturb
    • Set a time period (e.g., next 2 hours, until tomorrow morning)
  2. Disable Do Not Disturb

    • Notifications resume automatically after the set period
    • Or manually disable in Settings

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 SettingsAppsTWISTNotifications
  • Ensure notifications are enabled

Check App Settings:

  • Open TWIST app → SettingsNotifications
  • 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 SettingsNotifications
  • 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 SettingsNotifications
  • 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 SettingsAppClear Cache
  • This resets notification deep links

Report Issue:

  • If notifications consistently open the wrong screen, report this via SettingsHelpReport Issue

Notification Sound Too Loud/Quiet

Adjust Device Settings:

  • Go to device SettingsAppsTWISTNotifications
  • 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

  1. Enable Critical Notifications: Always enable notifications for device offline events and routine failures
  2. Disable Non-Essential: Turn off notifications for events you don't need to monitor
  3. Use Per-Installation Settings: Configure notifications separately for each installation based on importance
  4. Test Notifications: After enabling, trigger a routine to test that notifications are working
  5. Keep App Updated: Update the TWIST app regularly to ensure notifications work correctly
  6. Check Permissions: Periodically verify that notification permissions haven't been revoked

Next Steps

After setting up notifications:

  1. Create Routines – Set up routines to receive activity notifications
  2. Troubleshooting – Learn how to troubleshoot common issues
  3. Control Products – Continue controlling products