Push notifications
FCM, APNs, and Knock delivery in the Intry mobile app.
Overview
Entry alerts are delivered through Knock workflows to registered Device tokens. The app registers tokens with Core after login.
Runbook: docs/PUSH_NOTIFICATIONS.md.
Registration flow
- User logs in (Clerk or legacy JWT).
- App obtains FCM/APNs token from OS.
POST /devices/registerwith token, platform, and device metadata.- Core stores
Devicerow linked toUser.
User actions
When a push arrives, the resident taps Approve or Deny. The app calls /access/* endpoints; Core signals the telephony provider to release the door or hang up.
The approval window is approximately 30 seconds.
Fallback channels
If push fails or user enables fallbacks (set in app settings):
- SMS with approve/deny links
- Voice call to phone on file
See Notifications architecture.
Troubleshooting
| Issue | Check |
|---|---|
| No push | OS notification permissions; Device.isEnabled; DND mode |
| Delayed push | Knock workflow logs; device token freshness |
| Approve doesn't open gate | Call may have expired; telephony provider logs |
Last verified: 2026-06-21 (commit 293c4a7)