Bosca

Devices & Push

Register client devices and deliver push notifications across iOS, Android, web, and desktop platforms.

Bosca includes device registration and push notification delivery for reaching users on their devices. Register devices by platform, manage push tokens, and deliver notifications through the Campaigns system.

What you get

  • Device Registration: Track client devices by platform with ownership and activity tracking.
  • Push Tokens: Manage notification tokens from push services (Firebase, APNs, and others).
  • Multi-Platform Support: iOS, Android, web, and desktop devices.
  • Campaign Integration: Deliver push notifications as a campaign channel alongside banners and email.

Core Concepts

Devices

A Device represents a registered client application instance. Each device records:

  • Platform — the device type (iOS, Android, web, or desktop)
  • Installation ID — an optional identifier for deduplication across reinstalls
  • Last Check-In — timestamp of the most recent activity
  • Owner — the authenticated principal who registered the device

Platforms

PlatformDescription
IOSApple iOS devices
ANDROIDAndroid devices
WEBBrowser-based web clients
DESKTOPDesktop application clients

Push Tokens

A PushToken stores the notification credential for a specific device. Tokens are provided by platform push services (Firebase Cloud Messaging, Apple Push Notification Service, and others) and are registered against a device.

Devices can have multiple push tokens to support different notification providers.

How It Works

  1. Register a Device — when a user opens your app, register their device with the platform type and an optional installation ID.
  2. Add Push Tokens — after obtaining a push token from the platform's push service, register it on the device.
  3. Check In — periodically update the device's last check-in time to track active devices.
  4. Deliver Notifications — use Campaigns with the PUSH channel to send notifications to segment audiences.

During campaign delivery, Bosca resolves the target profiles to their registered devices and sends push notifications through the associated tokens.

Administration

Device management is handled through the GraphQL API. The segmentation admin UI shows push as an available campaign channel.

For developers

Related modules:

  • Core interfaces: backend/framework/core-devices
  • Implementation: backend/framework/devices
  • GraphQL schema: backend/framework/devices/src/main/resources/graphql/devices.graphqls

Related:

Segmentation & Campaigns

Build audience segments and deliver targeted campaigns across banner, email, and push channels.