Push Notification Settings
How to configure Push notifications for iOS SDK in SalesIQ?
Step 1: In the Zoho SalesIQ dashboard, navigate to Settings > Brands > Installation -> iOS -> Configure push notification and click on the toggle to enable push notification for Sandbox or Production mode.
You have two environments available for the push notifications settings:
- Production: You are to use production mode if your application is being deployed in the production environment to customers.
- Sandbox: You can use the sandbox environment to test and debug the modifications before moving to production mode for deployment.
APNs Certificate (P12)
You must create and upload a valid Apple Push Notification service (APNs) certificate to send push notifications to your application users. The APNs forwards notification of SalesIQ applications to the Apple devices.
How to generate the APNs certificate?
- Log in to the iPhone Developer Connection Portal and click on the iOS Provisioning Portal on the right side of the page.
- On the welcome page, click on the Identifiers section, to open the list with identifiers.
- To create a new App ID, open the App IDs tab and click on the New App ID button. Enter your app name for the Description, and enter Bundle Identifier.
- Ensure, you have created an App ID without a wildcard. Wildcard IDs cannot use the push notification service.
- Then, click on the Submit button.
- You can enter the notification text in the message and click the Send button to test. The Registered mobile devices will receive your test notification message. Click the Upload button to upload the APNS Certificate(P12) for the respective modes, as shown.
APNs Password
The APNs certificate requires a password while configuring. Provide the same password of your APNs certificate here for authentication.
Test the push notification on your registered mobile devices
To test the push notification service, you can register your testing mobile devices here. Upon registering, the device will be added to the list of registered devices, and push notifications can be sent using the Send button.
How to register your mobile device?
Note:
You should make sure that you have enabled Push Notification for the project in Xcode.
Step 1: To enable push notification in your react-native project, confirm that AppDelegate uses the UNUserNotificationCenterDelegate protocol. Then, import the following into your AppDelegate.h (Objective-C) or AppDelegate.swift (Swift) file.
Copied #import <UserNotifications/UserNotifications.h>
#import <UserNotifications/UNUserNotificationCenter.h>
#import <RNZSIQNotifications.h>Copiedimport UserNotifications
import UserNotificationsUI
import RNZohoSalesIQAdd the following block of code within the "didFinishLaunchingWithOptions" method in the AppDelegate file.
Copiedif (@available(iOS 10.0, *)) {
UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
[center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) {
center.delegate = self;
if (granted){
dispatch_async(dispatch_get_main_queue(), ^{
UNNotificationCategoryOptions categoryOptions = UNNotificationCategoryOptionNone;
UNTextInputNotificationAction *reply = [UNTextInputNotificationAction actionWithIdentifier:@"Reply" title:@"Reply" options:@[] textInputButtonTitle:@"Send" textInputPlaceholder:@"Message"];
UNNotificationCategory *chatGrpMsgCategory_10 = [UNNotificationCategory categoryWithIdentifier:@"GRPCHATMSG" actions:@[reply] intentIdentifiers:@[] options:categoryOptions];
[[UNUserNotificationCenter currentNotificationCenter] setNotificationCategories:[NSSet setWithObjects:chatGrpMsgCategory_10,chatGrpMsgCategory_10, nil]];
[application registerForRemoteNotifications];
});
}
}];
}
else{
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:(UIUserNotificationTypeAlert | UIUserNotificationTypeBadge | UIUserNotificationTypeSound) categories:nil];
[application registerUserNotificationSettings:settings];
}
if(launchOptions[@"UIApplicationLaunchOptionsRemoteNotificationKey"] != nil){
NSDictionary *notificationData = launchOptions[@"UIApplicationLaunchOptionsRemoteNotificationKey"];
if(notificationData != nil){
[RNZSIQNotifications processNotificationWithInfo:notificationData];
}
}Copied if #available(iOS 10.0, *) {
let center = UNUserNotificationCenter.current()
center.requestAuthorization(options: [.alert, .badge, .sound]) { granted, error in
center.delegate = self
if granted {
DispatchQueue.main.async {
let categoryOptions: UNNotificationCategoryOptions = []
let replyAction = UNTextInputNotificationAction(
identifier: "Reply",
title: "Reply",
options: [],
textInputButtonTitle: "Send",
textInputPlaceholder: "Message"
)
let chatGrpMsgCategory = UNNotificationCategory(
identifier: "GRPCHATMSG",
actions: [replyAction],
intentIdentifiers: [],
options: categoryOptions
)
center.setNotificationCategories([chatGrpMsgCategory])
application.registerForRemoteNotifications()
}
}
}
} else {
let settings = UIUserNotificationSettings(types: [.alert, .badge, .sound], categories: nil)
application.registerUserNotificationSettings(settings)
}
if let notificationData = launchOptions?[.remoteNotification] as? [String: Any] {
RNZSIQNotificationService.processNotificationWithInfo(notificationData)
}Step 2: The enablePush API needs to be called to register the device with SalesIQ for push notifications. Insert the code within the "application:didRegisterForRemoteNotificationsWithDeviceToken" method in the AppDelegate file.
Copied- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
const char *data = [deviceToken bytes];
NSMutableString *token = [NSMutableString string];
for (NSUInteger i = 0; i < [deviceToken length]; i++) {
[token appendFormat:@"%02.2hhX", data[i]];
}
[RNZSIQNotifications enablePush:token isTestDevice:YES isProductionMode:NO];
/*
Note: isTestDevice is set to be as YES if device is being registered as a test device in sandbox mode.
*/
}Copied override func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
let token = deviceToken.map { String(format: "%02.2hhX", $0) }.joined()
RNZSIQNotificationService.enablePush(token, isTestDevice: true, isProductionMode: false)
}Step 3: In your AppDelegate file, include the following code in the "center:didReceiveNotificationResponse" method.
Copiedif (@available(iOS 10.0, *)) {
if ([RNZSIQNotifications isMobilistenNotification:response.notification.request.content.userInfo]) {
if ([response.actionIdentifier isEqualToString: @"Reply"]) {
[RNZSIQNotifications handleNotificationAction:response.notification.request.content.userInfo response:((UNTextInputNotificationResponse *)response).userText];
}
else if([response.actionIdentifier isEqualToString: UNNotificationDefaultActionIdentifier]){
[RNZSIQNotifications processNotificationWithInfo:response.notification.request.content.userInfo];
}
}
}Copied func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
let userInfo = response.notification.request.content.userInfo
if #available(iOS 10.0, *), RNZSIQNotificationService.isMobilistenNotification(userInfo) {
if response.actionIdentifier == "Reply",
let textResponse = response as? UNTextInputNotificationResponse {
RNZSIQNotificationService.handleNotificationAction(userInfo, response: textResponse.userText)
} else if response.actionIdentifier == UNNotificationDefaultActionIdentifier {
RNZSIQNotificationService.processNotificationWithInfo(userInfo)
}
}
completionHandler()
}Upon successful registration, the registered iOS device will be visible in the list of registered devices as shown below.
You can easily test if your push notification is working in the app. To test manually, go to the Settings > Website > Website Name > Live Chat for Mobile Apps.
Choose iOS and then select Sandbox. If your device is registered correctly and listed in the list of registered devices, enter the message in the testing text box and click Send. You will now receive a notification with your content on your registered iOS device.
You also have an option to delete the registered test devices.
Note:
If you delete a test device from the list of registered devices, any test notifications sent from the test page would not be sent to the removed device. Any other notifications from SalesIQ would still be received.
