[{"data":1,"prerenderedAt":572},["ShallowReactive",2],{"guide:en:getting-started/notifications":3},{"id":4,"title":5,"body":6,"description":564,"extension":565,"meta":566,"navigation":567,"path":568,"seo":569,"stem":570,"__hash__":571},"guide_en/en/user/getting-started/notifications.md","Notifications — Push, Calendar, Email, and SMS",{"type":7,"value":8,"toc":539},"minimark",[9,14,35,40,43,48,144,148,185,191,194,197,225,228,232,235,238,242,245,248,252,255,259,277,281,321,326,330,340,344,347,351,358,360,364,367,409,412,416,423,425,429,432,436,443,446,477,482,484,488,493,507,512,523,528],[10,11,13],"h1",{"id":12},"notifications","Notifications",[15,16,17,18,22,23,26,27,30,31,34],"p",{},"Aptli keeps field workers and coordinators informed through four channels: ",[19,20,21],"strong",{},"browser push notifications"," (instant alerts, even when the tab is inactive), a ",[19,24,25],{},"calendar / ICS feed"," (work order due dates in your calendar app), ",[19,28,29],{},"email",", and ",[19,32,33],{},"SMS",". Each user controls which events they receive notifications for from their profile.",[36,37,39],"h2",{"id":38},"push-notifications","Push Notifications",[15,41,42],{},"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.",[44,45,47],"h3",{"id":46},"what-triggers-a-notification","What Triggers a Notification",[49,50,51,64],"table",{},[52,53,54],"thead",{},[55,56,57,61],"tr",{},[58,59,60],"th",{},"Event",[58,62,63],{},"Who Gets Notified",[65,66,67,79,89,99,110,120,128,136],"tbody",{},[55,68,69,76],{},[70,71,72,73],"td",{},"Work order marked ",[19,74,75],{},"completed",[70,77,78],{},"All users assigned to the work order",[55,80,81,87],{},[70,82,83,84],{},"Work order ",[19,85,86],{},"cancelled",[70,88,78],{},[55,90,91,96],{},[70,92,83,93],{},[19,94,95],{},"reassigned",[70,97,98],{},"Newly assigned users",[55,100,101,107],{},[70,102,83,103,106],{},[19,104,105],{},"due soon"," (48 h warning)",[70,108,109],{},"All assigned users (nightly check, 2 AM)",[55,111,112,118],{},[70,113,114,115,106],{},"Pickup code ",[19,116,117],{},"expiring soon",[70,119,109],{},[55,121,122,125],{},[70,123,124],{},"Version submitted for review",[70,126,127],{},"Admins (if subscribed)",[55,129,130,133],{},[70,131,132],{},"Version committed or rejected",[70,134,135],{},"Submitter",[55,137,138,141],{},[70,139,140],{},"Help request response",[70,142,143],{},"Requester",[44,145,147],{"id":146},"enabling-push-notifications","Enabling Push Notifications",[149,150,151,164,170,176,182],"ol",{},[152,153,154,155,158,159,163],"li",{},"Open your ",[19,156,157],{},"Profile"," (top-right menu → Profile, or ",[160,161,162],"code",{},"/m/profile"," on mobile)",[152,165,166,167],{},"Scroll to ",[19,168,169],{},"Notification Preferences",[152,171,172,173],{},"Click ",[19,174,175],{},"Enable Push Notifications",[152,177,178,179],{},"Your browser shows a permission prompt — click ",[19,180,181],{},"Allow",[152,183,184],{},"A confirmation message appears: \"Push notifications enabled\"",[186,187,188],"blockquote",{},[15,189,190],{},"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).",[44,192,169],{"id":193},"notification-preferences",[15,195,196],{},"Each user controls which events they receive notifications for. From your profile:",[198,199,200,207,213,219],"ul",{},[152,201,202,203,206],{},"Toggle ",[19,204,205],{},"Work Order Updates"," — completed / cancelled / status changes",[152,208,202,209,212],{},[19,210,211],{},"Due Soon Alerts"," — 48-hour advance warning for upcoming due dates",[152,214,202,215,218],{},[19,216,217],{},"Pickup Code Expiry"," — 48-hour advance warning before pickup codes expire",[152,220,202,221,224],{},[19,222,223],{},"Version Review"," — (admin only) new submissions in the review queue",[15,226,227],{},"Preferences are saved per user and respected across all devices where you are subscribed.",[44,229,231],{"id":230},"multiple-devices","Multiple Devices",[15,233,234],{},"You can subscribe to push notifications on multiple devices (phone, tablet, desktop). Each device registers independently. Notifications are delivered to all subscribed devices simultaneously.",[15,236,237],{},"When you log out, the push subscription for that device is removed. Log in again and re-enable push notifications to resubscribe.",[44,239,241],{"id":240},"stale-subscriptions","Stale Subscriptions",[15,243,244],{},"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.",[246,247],"hr",{},[36,249,251],{"id":250},"calendar-ics-feed","Calendar / ICS Feed",[15,253,254],{},"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.",[44,256,258],{"id":257},"what-appears-in-the-calendar","What Appears in the Calendar",[198,260,261,267,274],{},[152,262,263,264],{},"Work orders where you are listed in ",[19,265,266],{},"Assigned To",[152,268,269,270,273],{},"Work orders with a ",[19,271,272],{},"due date"," set",[152,275,276],{},"Each entry shows: work order name, due date/time, and a link back to the work order in Aptli",[44,278,280],{"id":279},"subscribing","Subscribing",[149,282,283,288,295,318],{},[152,284,154,285],{},[19,286,287],{},"Profile → Calendar Integration",[152,289,290,291,294],{},"Copy the ",[19,292,293],{},"ICS Feed URL"," (unique per user)",[152,296,297,298],{},"Open your calendar application and add a new calendar subscription:\n",[198,299,300,306,312],{},[152,301,302,305],{},[19,303,304],{},"Google Calendar:"," Other calendars → Add by URL → paste URL",[152,307,308,311],{},[19,309,310],{},"Outlook:"," Add calendar → Subscribe from web → paste URL",[152,313,314,317],{},[19,315,316],{},"Apple Calendar:"," File → New Calendar Subscription → paste URL",[152,319,320],{},"Set the refresh interval (recommended: every hour)",[186,322,323],{},[15,324,325],{},"The ICS URL is personal and contains a token. Do not share it — anyone with the URL can see your assigned work orders.",[44,327,329],{"id":328},"calendar-entry-format","Calendar Entry Format",[331,332,337],"pre",{"className":333,"code":335,"language":336},[334],"language-text","SUMMARY:Install Fibre Splice - Block C\nDTSTART:20260415T090000Z\nDTEND:20260415T170000Z\nDESCRIPTION:Work order #WO-1042\\nAssigned to: Alice Chen\nURL:https://demo.aptli.io/fulfillment/workorders?id=WO-1042\n","text",[160,338,335],{"__ignoreMap":339},"",[44,341,343],{"id":342},"rescheduled-work-orders","Rescheduled Work Orders",[15,345,346],{},"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.",[44,348,350],{"id":349},"cancelled-work-orders","Cancelled Work Orders",[15,352,353,354,357],{},"When a work order is cancelled, the calendar entry is updated with ",[160,355,356],{},"STATUS:CANCELLED",". Compliant calendar apps show a strikethrough or remove the event.",[246,359],{},[36,361,363],{"id":362},"email-notifications","Email Notifications",[15,365,366],{},"Beyond push and calendar, Aptli sends email notifications for:",[198,368,369,375,381,387,393,403],{},[152,370,371,374],{},[19,372,373],{},"New work order assignment"," — when you are added to a work order",[152,376,377,380],{},[19,378,379],{},"Work order status change"," — completed or cancelled",[152,382,383,386],{},[19,384,385],{},"Rescheduled work order"," — date change confirmation with updated .ics attachment",[152,388,389,392],{},[19,390,391],{},"Pickup code expiry warning"," — 48 hours before the code expires",[152,394,395,398,399,402],{},[19,396,397],{},"Password reset"," and ",[19,400,401],{},"email verification"," flows",[152,404,405,408],{},[19,406,407],{},"Help request updates"," — new response or status change",[15,410,411],{},"Email notification preferences are managed alongside push notification preferences in your Profile.",[44,413,415],{"id":414},"ics-email-attachments",".ics Email Attachments",[15,417,418,419,422],{},"Work order assignment emails include a ",[160,420,421],{},".ics"," file attachment. Tap or double-click the attachment to add the work order directly to your calendar — without setting up a subscription URL.",[246,424],{},[36,426,428],{"id":427},"sms-notifications","SMS Notifications",[15,430,431],{},"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.",[44,433,435],{"id":434},"carrier-stop-block-re-enabling-sms","Carrier STOP Block — Re-enabling SMS",[15,437,438,439,442],{},"If you reply ",[19,440,441],{},"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.",[15,444,445],{},"To re-enable SMS notifications after a STOP reply:",[149,447,448,453,459,465,470],{},[152,449,154,450,452],{},[19,451,157],{}," (top-right menu → Profile)",[152,454,455,456],{},"Navigate to ",[19,457,458],{},"Communications Preferences",[152,460,461,462,464],{},"Find the ",[19,463,428],{}," section",[152,466,172,467],{},[19,468,469],{},"Re-enable SMS",[152,471,472,473,476],{},"A confirmation SMS will be sent — reply ",[19,474,475],{},"START"," to restore delivery",[186,478,479],{},[15,480,481],{},"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.",[246,483],{},[36,485,487],{"id":486},"troubleshooting","Troubleshooting",[15,489,490],{},[19,491,492],{},"Notifications not arriving:",[198,494,495,498,501,504],{},[152,496,497],{},"Confirm push notifications are enabled in your browser (site settings → notifications)",[152,499,500],{},"Verify you allowed notifications in the Aptli profile (check the toggle is on)",[152,502,503],{},"Some mobile browsers require the PWA to be installed (\"Add to Home Screen\") for reliable background delivery",[152,505,506],{},"Check that your device is not in Do Not Disturb mode",[15,508,509],{},[19,510,511],{},"Calendar not updating:",[198,513,514,517,520],{},[152,515,516],{},"Most calendar apps refresh subscriptions hourly or daily; expect up to 24-hour delay",[152,518,519],{},"Force a manual refresh in your calendar app",[152,521,522],{},"Confirm the ICS URL is still valid (profile → Calendar Integration)",[15,524,525],{},[19,526,527],{},"Push subscription expired:",[198,529,530,533,536],{},[152,531,532],{},"Log out and log back in",[152,534,535],{},"Re-enable push notifications in your profile",[152,537,538],{},"The old stale subscription is cleaned up automatically",{"title":339,"searchDepth":540,"depth":540,"links":541},2,[542,550,557,560,563],{"id":38,"depth":540,"text":39,"children":543},[544,546,547,548,549],{"id":46,"depth":545,"text":47},3,{"id":146,"depth":545,"text":147},{"id":193,"depth":545,"text":169},{"id":230,"depth":545,"text":231},{"id":240,"depth":545,"text":241},{"id":250,"depth":540,"text":251,"children":551},[552,553,554,555,556],{"id":257,"depth":545,"text":258},{"id":279,"depth":545,"text":280},{"id":328,"depth":545,"text":329},{"id":342,"depth":545,"text":343},{"id":349,"depth":545,"text":350},{"id":362,"depth":540,"text":363,"children":558},[559],{"id":414,"depth":545,"text":415},{"id":427,"depth":540,"text":428,"children":561},[562],{"id":434,"depth":545,"text":435},{"id":486,"depth":540,"text":487},"Stay informed on work order changes, due-date warnings, and pickup code expirations through browser push notifications, calendar subscriptions, email, and SMS.","md",{},true,"/en/user/getting-started/notifications",{"title":5,"description":564},"en/user/getting-started/notifications","-s3gZUNHCmB0hFyySBG3NyzbCtXOHHsVCUcRXZl1S5c",1776295546621]