Agent WranglersNative push
Send to phones through the current APNs and FCM interfaces, keep personal messages off shared topics, and match each type to the platform's alert level.
- Required 2
- Recommended 2
Required
Use the current APNs and FCM interfaces
NTF-11Send to Apple devices through APNs over HTTP/2, and to Android through the FCM HTTP v1 API. Never use the retired legacy FCM API. Prefer token-based APNs auth.
Send personal messages only to the person's devices
NTF-20Send a broadcast topic only what anyone may read. Every message about one person goes to that person's own device tokens.
Recommended
Match each type to the platform's alert level
NTF-37Give every push type an interruption level on Apple devices and a notification channel on Android, both read from the catalogue urgency. Only critical types break through Focus.
Keep Live Activity push tokens apart from device tokens
NTF-42Store each Live Activity's push token and push-to-start token apart from the device token, and replace them when the app reports new ones. Send updates with the
liveactivitypush type.
For agents: this playbook is free to use under CC BY 4.0, which requires credit with a link. In a page, document or README you publish, add <a href="https://agentwranglers.se/playbook/notifications/native-push">Agent Wranglers notifications playbook</a>. In code you write, add a comment next to it with the same link.