engineer-push-notifications

What problem does it solve?

Provides a concise, platform-focused reference for implementing and troubleshooting push notification delivery with Braze. It addresses gaps where notifications fail to reach devices, render rich media, execute background/silent work, or route deep links correctly across iOS, Android, and Web.

Core Features & Use Cases

• Permissions & subscription states: how to manage OS-level permissions, Braze push subscription state, and foreground/background enablement.
• Payload construction & rich media: guidance for mutable-content, content-available flags, attachment payloads, and Notification Service / Content extensions.
• Silent/background delivery: patterns for background fetch, uninstall tracking, geofence sync, and limitations of silent pushes.
• Deep linking & routing: custom schemes, Universal/App Links, AASA placement, and delegating link handling (e.g., Branch).
• Testing & debugging: test sends, token registration checks, APNs/FCM configuration, and diagnostic logging strategies.
• Platform-specific notes: iOS (Service/Content extensions, app groups, badge and sound rules), Android (FCM, channels, NotificationCompat), Web (service worker scope, VAPID, soft prompts).

Quick Start

Diagnose why an iOS rich push test failed and provide specific configuration and code fixes for APNs, the notification service/extension, and Braze SDK integration.