Failed Message Email Notifications
Configure email alerts for failed SMS messages and device failures to stay on top of delivery issues and maintain reliable messaging operations.
Learn how to configure email notifications when your Android device fails to send messages or goes offline.
Overview
WhatSnap includes a notification system that alerts you via email when your device encounters issues, ensuring you never miss delivery problems.
Common Scenarios for Alerts:
📵 Device powered off
📶 No internet connection
🔴 WhatSnap Gateway app stopped
⚠️ SIM card failure
❌ Message delivery errors
🔋 Battery dead (device unplugged)
Proactive Monitoring: Email notifications help you catch issues before they impact your business or client operations.
What Triggers Notification Emails
Device-Level Failures
Device Offline:
Android device loses internet connection
Device powered off or battery died
Gateway app crashed or stopped
Device disconnected from WhatSnap
SIM Card Issues:
SIM card removed or not detected
Carrier network unavailable
SIM blocked by carrier
No signal strength
Message-Level Failures
Delivery Failures:
Message fails to send after retry attempts
Invalid phone number format
Recipient number blocked or doesn't exist
Carrier rejection
GENERIC_FAILURE errors
Queue Buildup:
Multiple messages queued (device offline)
Messages delayed beyond threshold
System detects sustained delivery issues
Configuring Email Notifications
Step-by-Step Setup
Choose Recipients
Option 1: Agency Admin Only (Recommended if you manage devices)
Only you receive notifications
You handle device issues directly
Cleaner client experience
Option 2: Agency Admin + Sub-Account
Both you and client receive notifications
Ideal if client manages or has access to the device
Client can take immediate action
Select the appropriate option:
Check "Notify Agency Admin" → You get emails
Check "Notify Sub-Account" → Client gets emails
Check both → Both get emails
What Notification Emails Look Like
Sample: Device Offline Alert
Subject: WhatSnap Alert: Device "Android-Main-SMS" is Offline
Body:
Your WhatSnap device has gone offline and is no longer
sending messages.
Device Name: Android-Main-SMS
Phone Number: +1 (555) 123-4567
Last Seen: November 7, 2025 at 2:45 PM
Issue: Device disconnected
Action Required:
- Check if device is powered on
- Verify internet connection
- Restart WhatSnap Gateway app
- Contact support if issue persists
View Device Status: [Link to Dashboard]Sample: Message Delivery Failure Alert
Subject: WhatSnap Alert: Message Delivery Failures Detected
Body:
Multiple messages have failed to send from your device.
Device Name: Android-Main-SMS
Failed Messages: 15 in the last hour
Common Error: GENERIC_FAILURE
Possible Causes:
- SIM card issue
- Poor signal strength
- Carrier restrictions
- Device needs restart
Action Required:
- Check device signal strength
- Restart WhatSnap Gateway app
- Test sending SMS directly from phone
- See troubleshooting guide
View Failed Messages: [Link to Dashboard]Who Should Receive Notifications?
Decision Matrix
You manage device remotely
✅ Yes
❌ No
Client has physical access to device
✅ Yes
✅ Yes
Client manages device themselves
⚠️ Optional
✅ Yes
Testing/development device
✅ Yes
❌ No
Client is non-technical
✅ Yes
❌ No (handle yourself)
Client wants visibility
✅ Yes
✅ Yes
Recommendations
Notify Agency Admin Only When:
✅ You manage client devices directly
✅ You have remote access to devices
✅ Client shouldn't be bothered with technical issues
✅ You provide white-glove managed service
Notify Both When:
✅ Client has access to/manages the device
✅ Client requested visibility into operations
✅ Device is physically at client's location
✅ Quick action needed and client can respond faster
Notify Sub-Account Only When:
✅ Client fully manages device themselves
✅ You're not responsible for device management
✅ Client is technically competent
Responding to Notification Emails
Device Offline Notification
Immediate Actions:
Message Failure Notification
Troubleshooting Steps:
Check Error Type
GENERIC_FAILURE → SIM/carrier issue
Invalid number → Contact data issue
Network error → Connection issue
Test Direct SMS
Open native Messages app
Send test SMS to your personal number
If this fails → Carrier/SIM problem
If this works → WhatSnap configuration issue
Check Signal Strength
Ensure 3-4 bars signal
Move device closer to window if needed
Switch between WiFi and mobile data
Review Recent Changes
Did you change settings recently?
New Android update?
Carrier plan change?
High message volume sent?
Restart if Needed
Restart WhatSnap Gateway app
If still failing, restart Android device
Re-authenticate if device stays offline
See: Troubleshooting Guide for detailed solutions.
Email Notification Best Practices
1. Set Up Email Filters
Create Gmail/Email Rules:
Label WhatSnap notifications
Highlight critical alerts (device offline)
Forward to team channel (Slack, Teams) if needed
Archive low-priority notifications
2. Establish Response Protocols
For Agencies:
Assign team member to monitor notifications
Set response time targets (e.g., within 30 minutes)
Escalation process for after-hours
Document common issues and solutions
For Solo Users:
Check email regularly during business hours
Set up mobile notifications for email
Have troubleshooting checklist ready
Know when to contact support
3. Monitor Notification Frequency
Normal:
Occasional notifications (1-2 per week or less)
Quick resolution (device back online in minutes)
Concerning:
Daily notifications
Same issue recurring
Long offline periods
Action:
If frequent issues, investigate root cause
May need better internet connection
May need to upgrade device
May need different carrier
4. Test Notifications
Regularly Verify:
Intentionally disconnect device
Verify you receive email within 5-10 minutes
Check email goes to correct recipient(s)
Ensure links in email work
Test Quarterly:
Ensures notification system still working
Confirms email addresses still valid
Team knows what to expect
Alternative Notification Methods
1. WhatSnap Dashboard Monitoring
Real-Time Status:
View device status in dashboard
See "Online" or "Offline" indicator
No email needed for proactive monitoring
When to Use:
Daily check-in routine
Before running campaigns
After device maintenance
2. Internal GoHighLevel Notifications
Set Up Internal Alerts:
Use GHL workflow to monitor failed messages
Create workflow triggered by failed sends
Send internal notification to team
Example Workflow:
Trigger: SMS delivery failed
↓
Send internal notification to team
↓
Tag contact with "Failed-SMS"
↓
Create task to investigate3. Third-Party Monitoring
UptimeRobot or Similar:
Monitor WhatSnap dashboard URL
Get alerts if dashboard unreachable
More advanced monitoring
Use Case:
Enterprise operations
Critical business messaging
24/7 monitoring needed
Troubleshooting Notification Issues
Not Receiving Notification Emails
Check These:
✅ Email notifications enabled in settings
✅ Correct email address configured
✅ Check spam/junk folder
✅ Email server not blocking WhatSnap emails
✅ Test with device disconnect
Solutions:
Add WhatSnap email to contacts/safe senders
Check email filters and rules
Verify email address in settings
Contact support if still not receiving
Receiving Too Many Notifications
Causes:
Device frequently disconnecting
Intermittent connectivity issues
Battery optimization causing app restarts
Solutions:
Improve internet connection reliability
Fix battery optimization settings
Upgrade to more reliable device
Adjust notification threshold (if available)
Emails Delayed
Normal Delay:
2-5 minutes after issue occurs
Excessive Delay:
30 minutes is concerning
Solutions:
Check email server delays
Verify internet connectivity
May be carrier email delivery issue
Contact support if consistently delayed
Summary: Notification Configuration
Best Practices:
✅ Enable email notifications for device failures
✅ Notify agency admin if you manage devices
✅ Only notify sub-account if they manage device
✅ Test notifications quarterly
✅ Set up email filters and response protocols
✅ Monitor notification frequency for patterns
Quick Setup:
WhatSnap Dashboard → Settings
Enable Email Notifications for Device Failures
Select recipients (Admin or Admin + Sub-Account)
Save settings
Test with device disconnect
Response Time:
Target: Address within 30 minutes during business hours
Critical: Device offline notifications
Lower priority: Occasional failed messages
Proactive Operations: Email notifications ensure you catch device issues before they impact your messaging operations or client campaigns. Configure them as part of your initial setup.
Related Resources
Troubleshooting SMS - Fix common issues
Device Configuration - Prevent issues
Error Codes - Decode error messages
Reliability Guide - Maximize uptime
Questions about notifications? Contact support at support@whatsnap.ai for help configuring alerts.
Last updated