Deliver agent replies reliably and route notification taps into prebuilt or custom support UI.
When an agent replies (or a ticket’s status changes) while the user is away,
ClarioDesk can fire an OS push notification. The host app owns the platform
notification handler; ClarioDesk validates its payload, refreshes authorized
support state, and provides the routing surface supported by the installed SDK
version.
How it’s wired
Push goes through a PushTokenProvider seam rather than importing a messaging
library directly. Your app owns the Firebase/FCM plugin; the SDK just asks it
for a token. This keeps Firebase’s native code out of hosts that don’t want
push.
React Native: push lives in a separate package,
@clariodesk/react-native-push, so Firebase never autolinks into a headless
host’s binary. See the RN push guide.
Flutter: the PushTokenProvider abstraction lets you hand the SDK an FCM
token without the SDK depending on firebase_messaging.
Swift (native iOS): no Firebase at all — forward the raw APNs token with
ClarioDesk.setAPNSDeviceToken(token) from your AppDelegate. See the
Swift push guide.
Delivery and attention
End-user push goes out via FCM HTTP v1. iOS is reached through FCM → APNs.
Each customer uploads their own service-account JSON per app in the dashboard,
so notifications come from your own Firebase project.Native Swift hosts skip Firebase entirely: upload an APNs auth key (.p8)
instead, and delivery goes straight to APNs from your own Apple credentials.The attention-aware backend uses this contract: only the visibly
focused support inbox or matching ticket may suppress a banner, and only after
it confirms that the specific realtime event rendered. Outside support,
backgrounded, or killed, the notification alerts immediately. A stale visible
surface that does not acknowledge the event falls back to an alert within a
short bounded window, so one support question cannot disappear indefinitely.
Every SDK 0.3.0+ exposes support-surface visibility and authenticated target
resolution. Older 0.2.x packages never suppress from presence and receive
immediate generic alerts. Check the installed version before wiring these APIs.
Payload privacy
Notification data is a content-free invalidation envelope. It contains the
destination device, identity epoch, event nonce, and (on the new envelope) an
opaque delivery id—but no ticket id, message id, customer id, message body, or
preview. The SDK resolves the opaque id through a signed request after checking the
current device, identity epoch, app, customer, and target access. Never put or
read a raw ticketId in FCM/APNs data.
Handling a tap
Route ClarioDesk messages in your shared push handler so they don’t collide
with your app’s own notifications. SDK 0.3.0+ resolves the authenticated
target after a tap:
final target = await ClarioDesk.resolvePushTarget(message.data);switch (target) { case TicketPushTarget(:final ticketId): appRouter.go('/support/tickets/$ticketId'); case InboxPushTarget(): appRouter.go('/support'); case null: break; // Not ClarioDesk, or another device/identity.}
// Distinguish ours in a shared background handler:if (ClarioDesk.isClarioMessage(msg.data ?? {})) return;// On notification tap:const target = await ClarioDesk.resolvePushTarget(data);if (target?.kind === 'ticket') navigation.navigate('SupportTicket', { ticketId: target.ticketId });else if (target?.kind === 'inbox') navigation.navigate('SupportInbox');
if let target = await ClarioDesk.resolvePushTarget(userInfo) { switch target { case .ticket(let id): router.openSupportTicket(id) case .inbox: router.openSupportInbox() }}
Prebuilt UI calls ClarioDeskWidgets.openFromPush(...) on Flutter/Swift or
openFromPush(data) from the React Native UI package. Older 0.2.xopenTicketFromPush validates/refreshes and falls back to the inbox.
Custom-screen visibility
Only assert a surface while its route is actually focused:
React Native uses useVisibleSupportSurface({ kind: 'ticket', ticketId }, useIsFocused()) (or the imperative set/clear methods). Swift uses
setVisibleSupportSurface(.ticket(ticketId)) on focus and clears on blur.
Every SDK clears the lease on app background, logout, identity switch, and
reset, then restores it on resume only if the same route remains focused. Each
prebuilt navigator manages this automatically.
Background, killed, and foreground taps
Wire all three states:
Background: handle the platform notification-open callback.
Killed: read the platform’s initial notification once, then wait until
ClarioDesk.init and the host router are ready before navigating.
Foreground outside support: mobile OSes may not display a remote banner;
use the host app’s existing in-app banner/local-notification layer.
If the notification belongs to ClarioDesk, return early from the shared
handler so the host’s unrelated push logic does not process it a second time.
For a custom UI, notification navigation always belongs to the host router.
For prebuilt UI, navigation belongs to the prebuilt modal—do not mix them.
React Native: registering the background message handler in index.js at
startup is the #1 push setup-failure cause. Make sure it runs at app entry, not
inside a component.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ClarioDesk","description":"In-app support and bug reporting SDKs for Flutter, React Native, and native iOS (Swift).","colors":{"primary":"#809447","light":"#D4FF00","dark":"#5F6E36"},"logo":{"light":"https://mintcdn.com/clariodesk/nlEbZ2118mD971gH/logo/light.svg?fit=max\u0026auto=format\u0026n=nlEbZ2118mD971gH\u0026q=85\u0026s=05cf11cb6d111dd635cd7be420d87076","dark":"https://mintcdn.com/clariodesk/nlEbZ2118mD971gH/logo/dark.svg?fit=max\u0026auto=format\u0026n=nlEbZ2118mD971gH\u0026q=85\u0026s=b26fd941f305e7a38ecc72386de165ad"},"favicon":"https://mintcdn.com/clariodesk/nlEbZ2118mD971gH/favicon.svg?fit=max\u0026auto=format\u0026n=nlEbZ2118mD971gH\u0026q=85\u0026s=a741288538376c49b031a0c2ea29d72a","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://dashboard.clariodesk.com","label":"Dashboard"}],"primary":{"type":"button","label":"Get started","href":"https://clariodesk.com"}},"footer":{"socials":{"github":"https://github.com/clariodesk","website":"https://clariodesk.com"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"clariodesk","hasAudioNarration":false,"actualSubdomain":"clariodesk","customDomains":["docs.clariodesk.com"],"gitSource":{"type":"github","owner":"shipwithdhruvil","repo":"clariodesk-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a94f06349c45aa1a0eb5673","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Get started","count":15},{"language":"default","tag":"Core concepts","count":8},{"language":"default","tag":"React Native SDK","count":6},{"language":"default","tag":"React Native","count":6},{"language":"default","tag":"Swift SDK","count":6},{"language":"default","tag":"Swift","count":6},{"language":"default","tag":"Flutter SDK","count":5},{"language":"default","tag":"Flutter","count":5},{"language":"default","tag":"Integration","count":3},{"language":"default","tag":"Build with AI","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"concepts/push-notifications","slug":"/concepts/push-notifications","pageMetadata":{"title":"Push notifications","description":"Deliver agent replies reliably and route notification taps into prebuilt or custom support UI.","href":"/concepts/push-notifications"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Deliver agent replies reliably and route notification taps into prebuilt or custom support UI.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`When an agent replies (or a ticket’s status changes) while the user is away,\nClarioDesk can fire an OS push notification. The host app owns the platform\nnotification handler; ClarioDesk validates its payload, refreshes authorized\nsupport state, and provides the routing surface supported by the installed SDK\nversion.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-it’s-wired`,children:`How it’s wired`}),`\n`,_jsxs(_components.p,{children:[`Push goes through a `,_jsx(_components.code,{children:`PushTokenProvider`}),` seam rather than importing a messaging\nlibrary directly. Your app owns the Firebase/FCM plugin; the SDK just asks it\nfor a token. This keeps Firebase’s native code out of hosts that don’t want\npush.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`React Native:`}),` push lives in a separate package,\n`,_jsx(_components.code,{children:`@clariodesk/react-native-push`}),`, so Firebase never autolinks into a headless\nhost’s binary. See the `,_jsx(_components.a,{href:`/react-native/push`,children:`RN push guide`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Flutter:`}),` the `,_jsx(_components.code,{children:`PushTokenProvider`}),` abstraction lets you hand the SDK an FCM\ntoken without the SDK depending on `,_jsx(_components.code,{children:`firebase_messaging`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Swift (native iOS):`}),` no Firebase at all — forward the raw APNs token with\n`,_jsx(_components.code,{children:`ClarioDesk.setAPNSDeviceToken(token)`}),` from your AppDelegate. See the\n`,_jsx(_components.a,{href:`/swift/push`,children:`Swift push guide`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`delivery-and-attention`,children:`Delivery and attention`}),`\n`,_jsx(_components.p,{children:`End-user push goes out via FCM HTTP v1. iOS is reached through FCM → APNs.\nEach customer uploads their own service-account JSON per app in the dashboard,\nso notifications come from your own Firebase project.`}),`\n`,_jsxs(_components.p,{children:[`Native Swift hosts skip Firebase entirely: upload an APNs auth key (`,_jsx(_components.code,{children:`.p8`}),`)\ninstead, and delivery goes straight to APNs from your own Apple credentials.`]}),`\n`,_jsx(_components.p,{children:`The attention-aware backend uses this contract: only the visibly\nfocused support inbox or matching ticket may suppress a banner, and only after\nit confirms that the specific realtime event rendered. Outside support,\nbackgrounded, or killed, the notification alerts immediately. A stale visible\nsurface that does not acknowledge the event falls back to an alert within a\nshort bounded window, so one support question cannot disappear indefinitely.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Every SDK `,_jsx(_components.code,{children:`0.3.0+`}),` exposes support-surface visibility and authenticated target\nresolution. Older `,_jsx(_components.code,{children:`0.2.x`}),` packages never suppress from presence and receive\nimmediate generic alerts. Check the installed version before wiring these APIs.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`payload-privacy`,children:`Payload privacy`}),`\n`,_jsxs(_components.p,{children:[`Notification data is a content-free invalidation envelope. It contains the\ndestination device, identity epoch, event nonce, and (on the new envelope) an\nopaque delivery id—but no ticket id, message id, customer id, message body, or\npreview. The SDK resolves the opaque id through a signed request after checking the\ncurrent device, identity epoch, app, customer, and target access. Never put or\nread a raw `,_jsx(_components.code,{children:`ticketId`}),` in FCM/APNs data.`]}),`\n`,_jsx(Heading,{level:`2`,id:`handling-a-tap`,children:`Handling a tap`}),`\n`,_jsxs(_components.p,{children:[`Route ClarioDesk messages in your shared push handler so they don’t collide\nwith your app’s own notifications. SDK `,_jsx(_components.code,{children:`0.3.0+`}),` resolves the authenticated\ntarget after a tap:`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Flutter`,numberOfLines:`9`,language:`dart`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`dart`,children:_jsxs(_components.code,{language:`dart`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`final`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` target `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` ClarioDesk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`resolvePushTarget`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(message.data);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`switch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (target) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` case`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` TicketPushTarget`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`final`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ticketId)`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` appRouter.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`go`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'/support/tickets/`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`$`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:`ticketId`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` case`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` InboxPushTarget`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` appRouter.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`go`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'/support'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` case`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` null`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` break`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`; `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Not ClarioDesk, or another device/identity.`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`React Native`,numberOfLines:`7`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Distinguish ours in a shared background handler:`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ClarioDesk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`isClarioMessage`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`msg`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ??`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {})) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`return`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// On notification tap:`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` target`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` ClarioDesk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`resolvePushTarget`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`target`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`?.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`kind`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ===`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'ticket'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`navigation`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`navigate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'SupportTicket'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ticketId:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` target`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ticketId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`else`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`target`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`?.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`kind`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ===`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'inbox'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`navigation`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`navigate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'SupportInbox'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Swift`,numberOfLines:`6`,language:`swift`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`swift`,children:_jsxs(_components.code,{language:`swift`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` let`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` target `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ClarioDesk.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`resolvePushTarget`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(userInfo) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` switch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` target {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` case`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` .`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`ticket`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`let`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` id)`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` router.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`openSupportTicket`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(id)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` case`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` .`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`inbox`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` router.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`openSupportInbox`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`Prebuilt UI calls `,_jsx(_components.code,{children:`ClarioDeskWidgets.openFromPush(...)`}),` on Flutter/Swift or\n`,_jsx(_components.code,{children:`openFromPush(data)`}),` from the React Native UI package. Older `,_jsx(_components.code,{children:`0.2.x`}),`\n`,_jsx(_components.code,{children:`openTicketFromPush`}),` validates/refreshes and falls back to the inbox.`]}),`\n`,_jsx(Heading,{level:`2`,id:`custom-screen-visibility`,children:`Custom-screen visibility`}),`\n`,_jsx(_components.p,{children:`Only assert a surface while its route is actually focused:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`dart`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`dart`,children:_jsxs(_components.code,{language:`dart`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` ClarioDesk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`setVisibleSupportSurface`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`SupportSurface`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.inbox);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` ClarioDesk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`setVisibleSupportSurface`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:`SupportSurface`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`ticket`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(ticketId));`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` ClarioDesk`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`clearVisibleSupportSurface`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(); `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// blur/pop`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`React Native uses `,_jsx(_components.code,{children:`useVisibleSupportSurface({ kind: 'ticket', ticketId }, useIsFocused())`}),` (or the imperative set/clear methods). Swift uses\n`,_jsx(_components.code,{children:`setVisibleSupportSurface(.ticket(ticketId))`}),` on focus and clears on blur.\nEvery SDK clears the lease on app background, logout, identity switch, and\nreset, then restores it on resume only if the same route remains focused. Each\nprebuilt navigator manages this automatically.`]}),`\n`,_jsx(Heading,{level:`2`,id:`background-killed-and-foreground-taps`,children:`Background, killed, and foreground taps`}),`\n`,_jsx(_components.p,{children:`Wire all three states:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Background: handle the platform notification-open callback.`}),`\n`,_jsxs(_components.li,{children:[`Killed: read the platform’s initial notification once, then wait until\n`,_jsx(_components.code,{children:`ClarioDesk.init`}),` and the host router are ready before navigating.`]}),`\n`,_jsx(_components.li,{children:`Foreground outside support: mobile OSes may not display a remote banner;\nuse the host app’s existing in-app banner/local-notification layer.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`If the notification belongs to ClarioDesk, return early from the shared\nhandler so the host’s unrelated push logic does not process it a second time.\nFor a custom UI, notification navigation always belongs to the host router.\nFor prebuilt UI, navigation belongs to the prebuilt modal—do not mix them.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`React Native:`}),` registering the background message handler in `,_jsx(_components.code,{children:`index.js`}),` at\nstartup is the #1 push setup-failure cause. Make sure it runs at app entry, not\ninside a component.`]})}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/react-native/push`,children:`RN push guide`}),` for the full Firebase wiring.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Push notifications","description":"Deliver agent replies reliably and route notification taps into prebuilt or custom support UI.","href":"/concepts/push-notifications"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How it’s wired","slug":"how-it’s-wired","depth":2,"children":[]},{"title":"Delivery and attention","slug":"delivery-and-attention","depth":2,"children":[]},{"title":"Payload privacy","slug":"payload-privacy","depth":2,"children":[]},{"title":"Handling a tap","slug":"handling-a-tap","depth":2,"children":[]},{"title":"Custom-screen visibility","slug":"custom-screen-visibility","depth":2,"children":[]},{"title":"Background, killed, and foreground taps","slug":"background-killed-and-foreground-taps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"clariodesk","siteName":"ClarioDesk","title":"Push notifications - ClarioDesk","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-31T03:10:03.509Z","originalFileLocation":"concepts/push-notifications.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Deliver agent replies reliably and route notification taps into prebuilt or custom support UI.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ClarioDesk\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Push notifications - ClarioDesk\">\u003cmeta data-mint-head property=\"og:description\" content=\"Deliver agent replies reliably and route notification taps into prebuilt or custom support UI.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ClarioDesk\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.clariodesk.com/concepts/push-notifications\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://clariodesk.mintlify.site/_mintlify/api/og/v2?division=Core+concepts\u0026amp;title=Push+notifications\u0026amp;description=Deliver+agent+replies+reliably+and+route+notification+taps+into+prebuilt+or+custom+support+UI.\u0026amp;theme=03d21b49a97fe3c828410fd2\u0026amp;signature=8c9bba5afef98f75a045a5914e2847518fe9c9186524135bcc8af08eb143df8d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Push notifications - ClarioDesk\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Deliver agent replies reliably and route notification taps into prebuilt or custom support UI.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://clariodesk.mintlify.site/_mintlify/api/og/v2?division=Core+concepts\u0026amp;title=Push+notifications\u0026amp;description=Deliver+agent+replies+reliably+and+route+notification+taps+into+prebuilt+or+custom+support+UI.\u0026amp;theme=03d21b49a97fe3c828410fd2\u0026amp;signature=8c9bba5afef98f75a045a5914e2847518fe9c9186524135bcc8af08eb143df8d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/clariodesk/nVuqOLJh4xCQWkxU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ClarioDesk\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#809447\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.clariodesk.com/concepts/push-notifications\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/concepts/push-notifications.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.clariodesk.com/#organization\",\"name\":\"ClarioDesk\",\"url\":\"https://docs.clariodesk.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/clariodesk/nlEbZ2118mD971gH/logo/light.svg?fit=max\u0026auto=format\u0026n=nlEbZ2118mD971gH\u0026q=85\u0026s=05cf11cb6d111dd635cd7be420d87076\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.clariodesk.com#website\",\"name\":\"ClarioDesk\",\"url\":\"https://docs.clariodesk.com\",\"publisher\":{\"@id\":\"https://docs.clariodesk.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.clariodesk.com/concepts/push-notifications#webpage\",\"url\":\"https://docs.clariodesk.com/concepts/push-notifications\",\"name\":\"Push notifications\",\"description\":\"Deliver agent replies reliably and route notification taps into prebuilt or custom support UI.\",\"dateModified\":\"2026-08-31T03:10:03.509Z\",\"isPartOf\":{\"@id\":\"https://docs.clariodesk.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.clariodesk.com/concepts/push-notifications#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.clariodesk.com/concepts/push-notifications#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core concepts\",\"item\":\"https://docs.clariodesk.com/concepts/architecture\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Push notifications\",\"item\":\"https://docs.clariodesk.com/concepts/push-notifications\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.clariodesk.com/concepts/push-notifications#article\",\"headline\":\"Push notifications\",\"name\":\"Push notifications\",\"description\":\"Deliver agent replies reliably and route notification taps into prebuilt or custom support UI.\",\"url\":\"https://docs.clariodesk.com/concepts/push-notifications\",\"mainEntityOfPage\":{\"@id\":\"https://docs.clariodesk.com/concepts/push-notifications#webpage\"},\"dateModified\":\"2026-08-31T03:10:03.509Z\",\"publisher\":{\"@id\":\"https://docs.clariodesk.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.clariodesk.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ClarioDesk\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ClarioDesk\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/concepts/push-notifications.md","siteName":"ClarioDesk","nav":{"global":null,"tabs":[{"tab":"Get started","groups":[{"group":"Introduction","pages":[{"title":"ClarioDesk SDKs","href":""},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Integration","pages":[{"title":"Integrating into your Flutter app","href":"/integrate-flutter"},{"title":"Integrating into your React Native app","href":"/integrate-react-native"},{"title":"Integrating into your Swift app","href":"/integrate-swift"}]},{"group":"Build with AI","pages":[{"title":"Install with AI","href":"/claude-code"},{"title":"Rules for AI agents","href":"/concepts/agent-rules"}]},{"group":"Core concepts","pages":[{"title":"Architecture","href":"/concepts/architecture"},{"title":"Authentication","href":"/concepts/authentication"},{"title":"Verified identity","href":"/concepts/verified-identity"},{"title":"Identity \u0026 lifecycle","href":"/concepts/identity-lifecycle"},{"title":"Realtime","href":"/concepts/realtime"},{"title":"Attachments","description":"Photos, videos, and files on any message, both directions.","href":"/concepts/attachments"},{"title":"Push notifications","href":"/concepts/push-notifications"},{"title":"CSAT","description":"An inline satisfaction rating when an agent resolves a ticket.","href":"/concepts/csat"}]}]},{"tab":"Flutter SDK","pages":[{"title":"Flutter SDK","href":"/flutter/quickstart"}]},{"tab":"React Native SDK","pages":[{"title":"React Native SDK","href":"/react-native/quickstart"}]},{"tab":"Swift SDK","pages":[{"title":"Swift SDK","href":"/swift/quickstart"}]}]},"basePath":"","title":"Push notifications - ClarioDesk","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}