Mobile Inbox
Quick access to unread calls on mobile devices, helping you stay on top of customer interactions while on the go.
Overview
The Mobile Inbox feature provides a convenient way to track and access new calls from your mobile device. It displays an unread call count and takes you directly to recent calls with a single tap.
Platform: Mobile only (screens < 768px wide)
Accessing the Mobile Inbox
Inbox Button Location
The Inbox button appears in the mobile header of the Voka AI platform:
Visual Design:
- Gradient purple background with glow effect
- Inbox icon + "Inbox" label
- Located at top of screen for easy thumb access
- Animated pulse effect when unread calls are present
Unread Call Count
Badge Display:
- Shows number of unread calls
- Updates automatically every 60 seconds
- Resets when you visit the call logs page
What Counts as "Unread":
- Calls received since you last viewed the call logs page
- Based on call
started_attimestamp vs. your last visit - Tracked using browser localStorage
Using the Mobile Inbox
Viewing Unread Calls
To access:
- Tap the Inbox button in the mobile header
- Automatically marks all current calls as "read"
- Navigates to the call logs page
- View your recent calls in mobile-optimized layout
After Tapping Inbox
What happens:
- Unread count resets to 0
- Last viewed timestamp updates in localStorage
- Call logs page opens with mobile-friendly interface
- All calls remain accessible (nothing is deleted)
How Unread Tracking Works
Unread Logic
Calls are considered unread if:
- Call
started_attime is newer than your last visit timestamp - Within the last 30 days (older calls not included in count)
- Successfully completed or missed calls
Calls are marked as read when:
- You tap the Inbox button
- You visit the Analytics → Calls page directly
- Timestamp is stored in browser localStorage
Automatic Refresh
Update Frequency:
- Unread count refreshes every 60 seconds automatically
- No manual refresh needed
- Works in background while you use the app
Real-time Updates:
- New calls appear in count within 60 seconds
- No page reload required
- Stays current throughout your session
Mobile Call Logs Interface
Optimized for Mobile
When you access calls from the Inbox button, you'll see:
Sticky Header:
- Compact date range controls
- Stays at top when scrolling
- Easy access to filters
Full-Width Call Cards:
- Optimized for small screens
- Large tap targets
- Easy to read at a glance
Swipe-Friendly:
- Smooth scrolling
- Touch-optimized interface
- Fast navigation
Mobile-Specific Features
Call Card Display:
- Direction icon + caller name
- Lead score badge (color-coded)
- Phone number and timestamp
- Assistant name (if available)
- 2-line summary preview
- Duration and status badges
Quick Actions:
- Tap any call to view details
- Swipe to scroll through list
- Use filters to narrow results
Notification Bell (Separate Feature)
The Inbox button is separate from the general notification bell.
Notification Bell
Location: Top-right of mobile header
Purpose:
- General platform notifications
- Account updates
- System messages
- Different from call inbox
Visual Design:
- Smaller badge (16px × 16px)
- Shows "9+" for counts over 9
- Opens notification panel (not call logs)
Inbox vs. Notifications
| Feature | Inbox | Notification Bell |
|---|---|---|
| Purpose | Unread calls tracking | General notifications |
| Badge Color | Purple gradient | Red/gray |
| Tap Action | Opens call logs | Opens notification panel |
| Content | Recent calls | Platform notifications |
Privacy and Storage
Local Storage
What's Stored:
- Last viewed timestamp only
- Stored in browser localStorage
- Key:
calls-last-viewed - No call content or personal data
Data Persistence:
- Persists across sessions
- Specific to each browser
- Clearing browser data resets counter
- Not synced across devices
Multi-Device Behavior
Important to Know:
- Each device tracks unread calls independently
- Viewing calls on desktop doesn't affect mobile count
- Viewing calls on one phone doesn't affect another
- Each browser maintains its own timestamp
Example:
- View calls on desktop at 9:00 AM
- Check mobile at 10:00 AM - still shows calls since your last mobile visit
- Each device tracks separately
Troubleshooting
Badge Not Updating
Check:
- Ensure you have calls in the last 30 days
- Wait up to 60 seconds for automatic refresh
- Check if calls are newer than your last visit
- Try refreshing the page manually
Still Not Working:
- Clear browser cache and localStorage
- Make a test call to verify
- Check browser console for errors
Count Seems Incorrect
Common Reasons:
- Visited calls recently: Counter resets when you view call logs
- Multiple browsers: Each browser tracks separately
- Cleared browser data: Reset the timestamp
- Old calls: Only counts last 30 days
To Reset:
- Tap the Inbox button
- Or visit Analytics → Calls page
- Counter will reset to 0
Inbox Button Not Visible
Check:
- Screen size: Only visible on mobile (< 768px width)
- Desktop users: Use Analytics → Calls in main navigation instead
- Browser zoom: Ensure zoom level is normal
Best Practices
Daily Workflow
Morning Routine:
- Open Voka AI on mobile
- Check Inbox button for unread count
- Tap to review overnight calls
- Prioritize high lead score calls
- Follow up on action items
Throughout Day:
- Glance at pulse animation for new calls
- Quick tap to stay current
- Review summaries on the go
- Archive resolved calls
Managing Calls on Mobile
Tips:
- Use filters: Narrow by assistant or date
- Sort by lead score: Focus on hot leads first
- Archive old calls: Keep list clean
- Copy transcripts: Share with team via mobile
- Call back directly: Use the Call Back button
Related Features
Desktop Alternative
On Desktop:
- No Inbox button (screen too wide)
- Use Analytics → Calls in main navigation
- Same call logs page, different layout
- Wider screen optimizations
Related Documentation
Future Enhancements
The Mobile Inbox feature may receive updates including:
- Push notifications for new calls (opt-in)
- Custom filters for inbox view
- Quick actions from inbox screen
- Cross-device sync options
Check release notes for new features as they become available.