Configure message push properties

When sending a message, use NCPushConfig within NCSendMessageParams to customize the push notification behavior for that individual message. For example:

• Customize push notification content (pushContent)
• Add extra data to the remote push notification (pushData)
• Disable push notifications for the message (disableNotification)

Swift

swift

import NexconnChatSDK

let textContent = TextMessage(text: "Test text message")
let params = SendMessageParams(content: textContent)

let pushConfig = PushConfig()
pushConfig.pushContent = "Notification content"
pushConfig.pushData = "Additional pushData for the notification"
params.pushConfig = pushConfig

// To disable push notifications for this message:
// params.disableNotification = true

guard let channel = DirectChannel(channelId: "targetUserId") else {
    return
}

channel.sendMessage(
    params: params,
    attachedHandler: { message in
        // Message saved to local DB
    },
    completionHandler: { sentMessage, error in
        // Handle send result
    }
)

Objective-C

Objective C

NCTextMessage *textContent = [[NCTextMessage alloc] initWithText:@"Test text message"];

NCSendMessageParams *params = [[NCSendMessageParams alloc] initWithContent:textContent];

// Customize push notification properties
NCPushConfig *pushConfig = [[NCPushConfig alloc] init];
pushConfig.pushContent = @"Notification content";
pushConfig.pushData    = @"Additional pushData for the notification";
params.pushConfig = pushConfig;

// To disable push notifications for this message:
// params.disableNotification = YES;

NCDirectChannel *channel = [[NCDirectChannel alloc] initWithChannelId:@"targetUserId"];
[channel sendMessageWithParams:params attachedHandler:^(NCMessage * _Nullable message) {
    // Message saved to local DB
} completionHandler:^(NCMessage * _Nullable sentMessage, NCError * _Nullable error) {
    // Handle send result
}];

Message push property reference

NCPushConfig properties (set via NCSendMessageParams.pushConfig)

Property	Type	Description
pushTitle	NSString *	Push notification title. nil uses the default title.
pushContent	NSString *	Push notification content. When set, overrides the default push content for the message type. nil uses the default.
pushData	NSString *	Additional data attached to the remote push notification. Accessible from the push notification payload.
disablePushTitle	BOOL	Whether to hide the push notification title for this message. When YES, only the body is shown.
forceShowDetailContent	BOOL	Whether to force showing notification content even when recipient has opted to hide message details. Default NO.
iOSConfig	NCIOSPushConfig *	iOS-specific push configuration (APNs thread ID, collapse ID, etc.).

NCSendMessageParams push-related properties

Property	Type	Description
pushConfig	NCPushConfig *	Per-message push configuration. nil uses the default push strategy.
disableNotification	BOOL	Whether to disable remote push and local notifications. Defaults to NO.
needReceipt	BOOL	Whether a read receipt is required.