Notifications

Aptli keeps field workers and coordinators informed through four channels: browser push notifications (instant alerts, even when the tab is inactive), a calendar / ICS feed (work order due dates in your calendar app), email, and SMS. Each user controls which events they receive notifications for from their profile.

Push Notifications

Push notifications appear on your device even when the browser tab is not active. They are delivered via the Web Push standard — no app store installation required.

What Triggers a Notification

Enabling Push Notifications

1. Open your Profile (top-right menu → Profile, or /m/profile on mobile)
2. Scroll to Notification Preferences
3. Click Enable Push Notifications
4. Your browser shows a permission prompt — click Allow
5. A confirmation message appears: "Push notifications enabled"

If you previously blocked notifications in your browser, you will need to manually re-enable them in your browser settings (address bar → site settings → notifications → allow).

Notification Preferences

Each user controls which events they receive notifications for. From your profile:

• Toggle Work Order Updates — completed / cancelled / status changes
• Toggle Due Soon Alerts — 48-hour advance warning for upcoming due dates
• Toggle Pickup Code Expiry — 48-hour advance warning before pickup codes expire
• Toggle Version Review — (admin only) new submissions in the review queue

Preferences are saved per user and respected across all devices where you are subscribed.

Multiple Devices

You can subscribe to push notifications on multiple devices (phone, tablet, desktop). Each device registers independently. Notifications are delivered to all subscribed devices simultaneously.

When you log out, the push subscription for that device is removed. Log in again and re-enable push notifications to resubscribe.

Stale Subscriptions

If a device is no longer in use, its subscription eventually becomes stale (the browser has stopped accepting deliveries). Aptli automatically clears stale subscriptions when a delivery fails. No manual cleanup is needed.

Calendar / ICS Feed

Work orders with due dates can be subscribed to as a calendar feed. This adds your upcoming work to any calendar application that supports ICS (iCal) — Google Calendar, Outlook, Apple Calendar, and most others.

What Appears in the Calendar

• Work orders where you are listed in Assigned To
• Work orders with a due date set
• Each entry shows: work order name, due date/time, and a link back to the work order in Aptli

Subscribing

1. Open your Profile → Calendar Integration
2. Copy the ICS Feed URL (unique per user)
3. Open your calendar application and add a new calendar subscription:
   • Google Calendar: Other calendars → Add by URL → paste URL
   • Outlook: Add calendar → Subscribe from web → paste URL
   • Apple Calendar: File → New Calendar Subscription → paste URL
4. Set the refresh interval (recommended: every hour)

The ICS URL is personal and contains a token. Do not share it — anyone with the URL can see your assigned work orders.

Calendar Entry Format

SUMMARY:Install Fibre Splice - Block C
DTSTART:20260415T090000Z
DTEND:20260415T170000Z
DESCRIPTION:Work order #WO-1042\nAssigned to: Alice Chen
URL:https://demo.aptli.io/fulfillment/workorders?id=WO-1042

Rescheduled Work Orders

If a work order's due date changes, the calendar entry updates automatically on the next refresh. The calendar event sequence number increments so compliant calendar apps update rather than create duplicates.

Cancelled Work Orders

When a work order is cancelled, the calendar entry is updated with STATUS:CANCELLED. Compliant calendar apps show a strikethrough or remove the event.

Email Notifications

Beyond push and calendar, Aptli sends email notifications for:

• New work order assignment — when you are added to a work order
• Work order status change — completed or cancelled
• Rescheduled work order — date change confirmation with updated .ics attachment
• Pickup code expiry warning — 48 hours before the code expires
• Password reset and email verification flows
• Help request updates — new response or status change

Email notification preferences are managed alongside push notification preferences in your Profile.

.ics Email Attachments

Work order assignment emails include a .ics file attachment. Tap or double-click the attachment to add the work order directly to your calendar — without setting up a subscription URL.

SMS Notifications

Aptli can send SMS notifications for critical events such as new work order assignments and pickup code reminders. SMS notifications are enabled by your system administrator and depend on your organisation's SMS configuration.

Carrier STOP Block — Re-enabling SMS

If you reply STOP to an Aptli SMS, your mobile carrier blocks all further messages from that number at the carrier level. Aptli cannot override a carrier-level block.

To re-enable SMS notifications after a STOP reply:

1. Open your Profile (top-right menu → Profile)
2. Navigate to Communications Preferences
3. Find the SMS Notifications section
4. Click Re-enable SMS
5. A confirmation SMS will be sent — reply START to restore delivery

If you do not receive the confirmation SMS, contact your mobile carrier directly and ask them to re-enable messages from the Aptli sender number. Your admin can provide the sender number if needed.

Troubleshooting

Notifications not arriving:

• Confirm push notifications are enabled in your browser (site settings → notifications)
• Verify you allowed notifications in the Aptli profile (check the toggle is on)
• Some mobile browsers require the PWA to be installed ("Add to Home Screen") for reliable background delivery
• Check that your device is not in Do Not Disturb mode

Calendar not updating:

• Most calendar apps refresh subscriptions hourly or daily; expect up to 24-hour delay
• Force a manual refresh in your calendar app
• Confirm the ICS URL is still valid (profile → Calendar Integration)

Push subscription expired:

• Log out and log back in
• Re-enable push notifications in your profile
• The old stale subscription is cleaned up automatically