Documentation
Progressive Web App & Push Notifications
LeadMachine is available as a Progressive Web App (PWA) that you can install directly to your phone or computer's home screen. Once installed, you'll receive instant push notifications when leads are assigned to you - completely free with no SMS charges.
Why Use the LeadMachine App?
🔔 Instant Push Notifications
- Get notified immediately when leads are assigned to you
- See lead name and contact info right in the notification
- Tap to open the lead directly in the app
- 100% FREE - no SMS fees or charges
- Access your leads even without internet
- View cached lead data when offline
- Automatic sync when you're back online
- Launches instantly from your home screen
- No need to open browser and navigate
- Full-screen experience without browser UI
- Uses device resources efficiently
- Intelligent caching reduces data usage
- Works great on limited data plans
- Faster than loading in browser each time
- See notification and task counts on the app icon
- Badge updates automatically when you have pending items
- Clear at a glance whether you have items requiring attention
- App updates automatically when new versions are released
- You'll see an "Update available" banner when there's a new version
- Just tap "Refresh Now" to get the latest features
- Open Safari and navigate to
app.leadmachine.fyi - Tap the Share button (square with arrow pointing up) at the bottom of Safari
- Scroll down and tap "Add to Home Screen"
- Name the app (default: "LeadMachine.fyi") and tap "Add"
- The app icon will appear on your home screen
- Open Chrome or Edge and navigate to
app.leadmachine.fyi - Tap the three dots menu (â‹®) in the top right
- Tap "Install app" or "Add to Home Screen"
- Confirm by tapping "Install"
- The app will be added to your home screen and app drawer
- Open your browser and navigate to
app.leadmachine.fyi - Look for the install icon (⊕ or ⬇) in the address bar
- Click the icon and confirm installation
- The app will open in its own window and be added to your applications
- Open the installed app from your home screen (first time)
- Wait 3 seconds - a modal will appear asking to enable notifications
- Tap "Enable Notifications"
- Allow when your device prompts for permission
- Done! You'll now receive push notifications
- Open the app and navigate to your profile (top right)
- Go to Settings tab
- Scroll to "Push Notifications" section
- Click "Enable Notifications" button
- Allow when prompted
- Send Test Notification to verify it's working
- Notification appears when a lead is assigned to you
- Shows lead name and contact info (email or phone)
- Tap to open the lead directly
- Notification appears when someone assigns a task to you
- Shows who assigned it and the task title
- Tap to go directly to your tasks
âš¡ Works Offline
🚀 Fast & Native-Like
💾 Saves Data
🔢 App Badge
🔄 Automatic Updates
Installing the PWA
iOS (iPhone/iPad) - Safari Required
> Note: Push notifications on iOS require iOS 16.4 or later and Safari browser.
Alternative: You may see a banner at the bottom of the screen with install instructions. Follow those if shown.
Android - Chrome or Edge
Alternative: You may see an "Install" banner at the bottom of the screen. Tap "Install" to proceed.
Desktop - Chrome, Edge, or Brave
Alternative: Click the three dots menu → "Install LeadMachine" or "Install app"
Enabling Push Notifications
After installing the PWA, you'll be prompted to enable push notifications. Here's what to expect:
First Launch
Manual Setup
If you dismissed the prompt or need to enable later:What Notifications You'll Receive
New Lead Assignments
Task Assignments
Format Examples:
🔔 New Lead Assigned
John Smith - [email protected]🔔 New Task Assigned
Mike assigned you: Follow up with client
Managing Notification Settings
View Your Status
Go to Profile → Settings → Push Notifications to see:Test Notifications
Disable Notifications
If you no longer want push notifications:You can re-enable anytime by clicking "Enable Notifications" again.
Blocked Notifications?
If you previously blocked notifications:iOS:
Android:
Desktop:
Troubleshooting
Not Receiving Notifications?
Check Installation:
Check Permissions:
Check Device Settings:
iOS Specific:
Send a Test:
"Not Supported" Message in Browser?
You're viewing in a regular browser tab, not the installed PWA:
Install Prompt Not Showing?
iOS:
Android/Desktop:
App Not Opening in Full Screen?
This means it wasn't installed correctly:
Privacy & Data
What Data is Stored?
Can Others See My Notifications?
How to Remove All Data?
Frequently Asked Questions
Q: Do I need the PWA for push notifications? A: Yes, push notifications only work in the installed PWA, not in a regular browser tab.
Q: Can I install on multiple devices? A: Absolutely! Install on your phone, tablet, and computer. Each will receive notifications independently.
Q: Will I still receive email notifications? A: Yes, email notifications are separate and controlled in Email Preferences (if configured by your admin).
Q: What's the difference between SMS and push? A: Push notifications are instant, free, and work through the app. SMS requires a phone number and may incur carrier charges. Push is recommended for all users.
Q: Do push notifications work offline? A: You need internet to receive notifications, but the PWA itself works offline for viewing cached leads.
Q: Can I customize which notifications I receive? A: Currently all lead assignment notifications are sent. Additional preferences coming soon.
Q: How do I uninstall the PWA? A:
Q: Is this safe and secure? A: Yes! Push notifications use industry-standard encryption (VAPID). Your data is never shared with third parties.
Support
Having trouble with the PWA or push notifications?
Last Updated: December 2025