Skip to main content

Configure push notifications per user

User-level push notification configuration refers to push settings that apply to the currently logged-in user of the app.

tip

  • User-level push configuration is distinct from App Key-level push configuration. App Key-level configuration applies to all users under the app. You can adjust some App Key-level push service settings in the Nexconn console.

  • User-level push configuration requires user-level feature settings to be enabled for the App Key. To enable them, submit a ticket.

Set the user's push notification language preference​

You can set the display language for push notifications. Once set, format text strings in push notification content for built-in message types are adjusted according to the specified locale for the current user.

If the user has not set a preference, the App Key-level Push notification language setting is used.

Built-in Nexconn message types include format text strings in their default push notification content. For example, by default, when a user receives a push notification for a file message in a direct Channel, the notification displays the Simplified Chinese string "[文件]". If the user changes their push language preference to US English en_US, the format text string in subsequent file message notifications becomes "[File]".

The "[文件]" and "[File]" strings in the example above are format text strings. The Nexconn server currently provides format text strings for built-in message type push notifications in Simplified Chinese zh_CN, US English en_US, and Arabic ar_SA.

The current iOS public SDK does not expose a public API for setting the user's push notification language preference. Configure the default language at the App Key level in the Nexconn console, or contact Nexconn support if your app needs a per-user setting.

Nexconn's built-in supported push languages are Simplified Chinese zh_CN, US English en_US, and Arabic ar_SA.

You can also change the default push language for an App Key in the Nexconn console under Chat > Chat settings > Offline Push > Push notification language.

Set the user's push notification content display preference​

The current iOS public SDK does not expose a public API for changing this user-level display preference.

When sending a message, you can specify per-message push notification content via NCSendMessageParams.pushConfig.pushContent, and disable push notifications for that message via NCSendMessageParams.disableNotification.

You can also change the App Key-level default configuration in Nexconn. To change the App Key-level Push Notification Details setting, submit a ticket. Once disabled, all push notifications default to hiding notification content details.

Set the user's multi-Device push notification preference​

Configure whether offline mobile devices should receive push notifications when the current logged-in user is active on Web or PC. This interface is only available after Send to mobiles when web/PC online is enabled for the App Key.

You can modify the App Key-level configuration on the Chat settings page in the console under Chat > Chat settings > Offline Push.

  • If Send to mobiles when web/PC online is not enabled for the App Key, mobile devices that are offline will not receive push notifications while the user is active on Web or PC. App users cannot modify this behavior themselves.
  • If Send to mobiles when web/PC online is enabled for the App Key, the current logged-in user can turn this behavior on or off.

The current iOS public SDK does not expose a public API for changing this user-level multi-device push preference.

Last updated on