Swift push - ClarioDesk

On native iOS, ClarioDesk delivers push straight through APNs. There is no Firebase SDK to add, no google-services plist, no third-party messaging dependency — the wiring is one line in your AppDelegate.

Wire the token

Request notification permission and register for remote notifications as you normally would, then forward the raw APNs token:

import ClarioDesk

func application(
  _ app: UIApplication,
  didRegisterForRemoteNotificationsWithDeviceToken token: Data
) {
  ClarioDesk.setAPNSDeviceToken(token)
}

That’s the whole client side. The SDK registers the token with the backend and re-registers when iOS rotates it.

Upload your APNs key once

In the dashboard, open your app’s push settings and upload the APNs auth key (the .p8 file from your Apple Developer account, with its key id and team id). Delivery then goes ClarioDesk → APNs → device, from your own Apple credentials.

Route notification taps

0.3.0+ notifications contain an opaque delivery handle, never a ticket id. Resolve it through the signed SDK and route the authorized result:

func userNotificationCenter(
  _ center: UNUserNotificationCenter,
  didReceive response: UNNotificationResponse,
  withCompletionHandler completionHandler: @escaping () -> Void
) {
  let userInfo = response.notification.request.content.userInfo
  Task {
    if let target = await ClarioDesk.resolvePushTarget(userInfo) {
      switch target {
      case .ticket(let ticketId): router.openSupportTicket(ticketId)
      case .inbox: router.openSupportInbox()
      }
    }
    completionHandler()
  }
}

For prebuilt UI, use await ClarioDeskWidgets.openFromPush(userInfo); it resolves and presents the exact destination. openTicketFromPush remains only as the 0.2.x generic refresh compatibility shim.

Custom-screen attention

The prebuilt inbox/thread tracks focus automatically. Custom SwiftUI routes call these from onAppear/onDisappear; UIKit uses view visibility callbacks:

.onAppear {
  Task { await ClarioDesk.setVisibleSupportSurface(.ticket(ticketId)) }
}
.onDisappear {
  Task { await ClarioDesk.clearVisibleSupportSurface() }
}

Use .inbox for the support inbox. The SDK clears remotely on background and restores on resume only while the same route remains focused. iOS delivers a terminated-app notification response after launch. Initialize ClarioDesk first and defer navigation until the SwiftUI/UIKit router is ready; otherwise a one-shot open can be emitted before any destination exists. In a shared handler, distinguish ours without consuming:

if ClarioDesk.isClarioMessage(userInfo) { /* ours */ }
let payload = ClarioDesk.parsePushPayload(userInfo) // nil if not ours

Preferences

let prefs = try await ClarioDesk.getNotificationPreferences()
_ = try await ClarioDesk.setNotificationPreferences(
  pushEnabled: true,
  quietHoursStart: "22:00",
  quietHoursEnd: "08:00",
  timezone: "America/New_York"
)

Already shipping Firebase?

A host that already runs Firebase Messaging can hand the SDK FCM tokens instead: implement the PushTokenProvider protocol against Messaging.messaging() and pass it in ClarioDeskOptions, or call ClarioDesk.registerPushToken(token) from your own messaging callback. The SDK itself never imports Firebase either way.

The attention-aware backend never uses app-wide presence to suppress push. Only a focused inbox/matching ticket plus an acknowledgement of that rendered delivery suppresses its banner. Everywhere else alerts immediately; a stale lease can delay fallback by at most two seconds. See the push concept page.

​Wire the token

​Upload your APNs key once

​Route notification taps

​Custom-screen attention

​Preferences

​Already shipping Firebase?

Wire the token

Upload your APNs key once

Route notification taps

Custom-screen attention

Preferences

Already shipping Firebase?