import ZohoDeskPortalCore 
... 
ZDPortalHome.show()

@import ZohoDeskPortalCore; 
... 
[ZDPortalHome showWithConfiguration:nil andTitle:nil];

let config = ZDPHomeConfiguration() 
config.enableHelpCenter = true // disable/enable the Help center (Knowledge Base). 
config.enableCommunity = false // disable/enable the Community. 
config.enableCreateTicket = true // disable/enable the CreateTicket. 
config.enableMyTicket = true // disable/enable My Tickets. 
ZDPortalHome.show(withConfiguration: config)

ZDPHomeConfiguration * config = [[ZDPHomeConfiguration alloc]init]; 
config.enableHelpCenter = YES; // disable/enable the Help center (Knowledge Base). 
config.enableCommunity = NO; // disable/enable the Community. 
config.enableCreateTicket = YES; // disable/enable the CreateTicket. 
config.enableMyTicket = YES; // disable/enable My Tickets. 
[ZDPortalHome showWithConfiguration:config andTitle:<#(NSString * _Nullable)#>];

import ZohoDeskPortalChat 
... 
ZDPortalChat.show()

@import ZohoDeskPortalChat; 
... 
[ZDPortalChat show];

import ZohoDeskPortalKB

@import ZohoDeskPortalKB;

ZDPortakKB.show()

[ZDPortalKB showWithTitle:<#NSString#>];

ZDPortalKB.showCategory(withPermalink: <#String#>)

[ZDPortalKB showCategoryWithPermalink:<#NSString#>withTitle:<#NSString#>];

ZDPortalKB.showArticle(withPermalink : <#String#>)

ZDPortalKB showArticleWithPermalink:<#NSString#>withTitle:<#NSString#>];

import ZohoDeskPortalTicket

@import ZohoDeskPortalTicket;

ZDPortalSubmitTicket.show()

[ZDPortalSubmitTicket showWithTitle:<#NSString#>];

ZDPortalSubmitTicket.showAddTicketForm(completion: { (ticket) in 
  // The ticket parameter contains the details of the ticket created. 
  // Your program logic goes here. 
}, onError: { error in 
  // error creating Ticket 
})

[ZDPortalSubmitTicket showAddTicketFormWithTitle:<#(NSString * _Nullable)#> navigationMode:<#(enum ZDPNavigationMode)#> completion:^(ZDPTicket * ticket) { 
   // The ticket parameter contains the details of the ticket created. 
   // Your program logic goes here. 
} onError:^(NSError * error) { 
   // error creating Ticket 
}];

ZDPortalTicket.show()

[ZDPortalTicket showWithTitle:<#NSString#>];

import ZohoDeskPortalCommunity

@import ZohoDeskPortalCommunity;

ZDPortalCommunity.show()

[ZDPortalCommunity show];

ZDPortalCommunity.showTopic(withID: <#String#>)

[ZDPortalCommunity showTopicWithID:<#NSString#>];

import ZohoDeskPortalLiveChat

@import ZohoDeskPortalLiveChat;

ZDPortalLiveChat.show()

[ZDPortalLiveChat show];

Once you enable Guided Conversations or Zia, the Chat component will be displayed as below:

Authenticating Users in the SDK

• Anonymous - In this type, end-users are considered guest users. They can only submit tickets, view posts in the user community, and chat with a customer support agent. They cannot view the tickets they submitted or actively participate in the user community.
  
• JWT - In this type, end-users are considered authenticated users. In addition to the activities that guest users can perform, authenticated users can also view the tickets they submitted and actively participate in the user community (with rights to perform actions, such as following a topic, adding a topic, and adding a comment to existing posts).
  

import ZohoDeskPortalAPIKit

@import ZohoDeskPortalAPIKit;

if !ZohoDeskPortalSDK.isUserLoggedIn{ 
    ZohoDeskPortalSDK.login(withUserToken: String) { (isSuccess: Bool) in 
        // isSuccess shows whether the login attempt was successful 
        // any errors will be logged 
    } 
}else{ 
        // user logged in already 
}

if (!ZohoDeskPortalSDK.isUserLoggedIn){ 
    [ZohoDeskPortalSDK loginWithUserToken:<#(NSString * _Nonnull)#> onCompletion:^(BOOL isSuccess) { 
         // isSuccess shows whether the login attempt was successful 
         // any errors will be logged 
    }]; 
}else{ 
         // user logged in already 
}

ZohoDeskPortalSDK.logout { (isSuccess: Bool ) in 
    // isSuccess shows whether the logout attempt was successful 
    // any errors will be logged 
}

[ZohoDeskPortalSDK logoutOnCompletion:^(BOOL isSuccess) { 
     // isSuccess shows whether the logout attempt was successful 
     // any errors will be logged 
}];

Clearing Local Data

ZohoDeskPortalSDK.clearAllLocalData()

[ZohoDeskPortalSDK clearAllLocalData];

Customizing the Add-On UI

import ZDThemeKit

@import ZDThemeKit;

ZDThemeManager.setTheme(type: .white)

[ZDThemeManager setTheme:ZDThemeTypeWhite];

ZDThemeManager.setTheme(type: .dark)

[ZDThemeManager setTheme:ZDThemeTypeDark];

ZDThemeManager.setTheme(type: .system)

[ZDThemeManager setTheme:ZDThemeTypeSystem];

Note

- ZDThemeType.system is available only for iOS 13 and above.

- By default, system theme will be applied for iOS 13 and above, and light theme will be applied for earlier versions.

ZDThemeManager.updateTheme(theme: <#ZDThemeProtocol#>)

[ZDThemeManager updateThemeWithTheme:<#ZDThemeProtocol#>];

ZDThemeManager.updateDarkTheme(theme: <#ZDThemeProtocol#>)

[ZDThemeManager updateDarkThemeWithTheme:<#ZDThemeProtocol#>];

Note : Updating the SDK's theme is different from setting a theme type. At any point of time, the SDK will be in dark or light theme, based on the theme type you have set.

1. Add the font(s) to your project.
   
2. Edit the info.plist file of your app to include the Fonts provided by application key.
   
3. Under this key, list the file names of all the fonts you want to use in the SDK UI.
   

ZDPortalConfiguration.customFontName = <#String#>

ZDPortalConfiguration.customFontName = <#NSString#>;

Note : If you do not use a custom font, the add-on displays the system font by default. We have made the font sizes accessible from version 2.0. Accessibility for custom fonts, however, is supported only for iOS 11 and above.

Changing Language Settings

ZDPortalConfiguration.setSDKLanguage(<#String#>)

[ZDPortalConfiguration setSDKLanguage:<#NSString#>];

1. Download the strings bundle from here.
   
2. Remove the lproj files of the languages that are not required for your app.
   
3. Add the bundle to your project.
   
   

1. Create a bundle titled ASAPStrings.bundle in the Xcode project of your app. The path to access this bundle is: Application-bundle/ASAPStrings.bundle.
   
2. Create a new lproj file with the language code as the filename and customize the values of the keys, as required. You can customize the prominent keys listed below or all the keys in the languages bundle.
   
3. Add this new lproj file to the ASAPStrings bundle.
   

Each language needs a unique lproj file. To customize the strings in each language that you want to support in your add-on, repeat steps 2 and 3 as many times as required.

The following table lists some of the prominent keys in the default ASAPLocalizable.strings file.

Enabling Notifications

1. Create and download an APNs certificate from Apple's developer portal.
   
2. Double-click the certificate. This action automatically imports it to the Keychain Access application.
   
3. Locate and expand the certificate in Keychain Access. The corresponding key for the certificate appears.
   
4. Select both the certificate and the key and right-click on them. A context menu appears.
   
5. Click the export option. A dialog box appears.
   
6. In this dialog box, make sure that .p12 is selected in the File Format drop-down list and click Save .
   
7. Enter a password to access the file and click OK . The certificate is now exported as a .p12 file.
   

func application(_ application: UIApplication,didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) { 
let token = deviceToken.reduce("", {$0 + String(format: "%02X", $1)}).uppercased() 
ZohoDeskPortalSDK.enablePushNotification(deviceToken:token, mode: .production) 
}

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken{ 
   NSString * token = [[[[deviceToken description] 
   stringByReplacingOccurrencesOfString: @"<" withString: @""] 
   stringByReplacingOccurrencesOfString: @">" withString: @""] 
   stringByReplacingOccurrencesOfString: @" " withString: @""]; 
   [ZohoDeskPortalSDK enablePushNotificationWithDeviceToken:token isTestDevice:NO mode:APNSModeProduction]; 
}

Note : You can verify if notifications are sent accurately by testing the functionality in development mode. To switch to development mode, replace ".production" in the code snippet above with ".sandbox". Make sure to switch back to production mode before deploying the app for end-customer use.

import ZohoDeskPortalConfiguration 
... 
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { 
   ZDPortalConfiguration.processRemoteNotification(userInfo: userInfo) 
}

@import ZohoDeskPortalConfiguration; 
... 
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler{ 
[ZDPortalConfiguration processRemoteNotificationWithUserInfo:userInfo]; }

Displaying Details of Anonymous Users to Agents

import ZohoDeskPortalChat 
   ... 
   ZDPortalChat.setGuestUser(email:<#Guest_User_Email#>, displayName:<#Guest_User_DisplayName#>", phoneNumber: <#Guest_User_PhoneNumber#>")

@import ZohoDeskPortalChat; 
    ... 
    [ZDPortalChat setGuestUserWithEmail:<#Guest_User_Email#>displayName:<#Guest_User_DisplayName#>phoneNumber:<#Guest_User_PhoneNumber#>];

Programmatically Adding Tickets

import ZohoDeskPortalAPIKit

@import ZohoDeskPortalAPIKit;

ZohoDeskPortalSDK.getDepartments(onCompletion: { (departments, error) in 
    // on success, departments will return an array, error will return nil 
    // on failure, error will return a value, departments will return nil 
    }

ZohoDeskPortalSDK getDepartmentsOnCompletion:^(NSArray * departments, NSError * error) { 
    // on success, departments will return an array, error will return nil 
    // on failure, error will return a value, departments will return nil 
    }];

ZohoDeskPortalSDK.getProducts(inDepartmentID: String, [String: Any]?) { (products, error) in 
    // on success, products will return an array, error will return nil 
    // on failure, error will return a value, products will return nil 
    }

[ZohoDeskPortalSDK getProductsInDepartmentID:<#NSString#>params:<#NSDictionary#>onCompletion:^(NSArray * products, NSError * error) { 
     // on success, products will return an array, error will return nil 
     // on failure, error will return a value, products will return nil 
     }];

ZohoDeskPortalSDK.Ticket.getFields([String: Any]?) { (fields, error) in 
    // on success, fields will return an array, error will return nil 
    // on failure, error will return a value, products will return nil 
    }

[ZohoDeskPortalSDKTicket getFields:<#(NSDictionary * _Nullable)#>onCompletion:^(NSArray * fields, NSError * error) { 
     // on success, fields will return an array, error will return nil 
     // on failure, error will return a value, fields will return nil 
    }];

ZohoDeskPortalSDK.Ticket.addAttachment(with:<#Data#>, andName:<#String#>, using: <#ZDPUploaderDelegate?#>) { (attachment, error) in 
    // on success, attachment will return a value, error will return nil 
    // on failure, error will return a value, attachment will return nil 
    }

[ZohoDeskPortalSDKTicket addAttachmentWith:<#NSData#>andName:<#NSString#>using:<#(id _Nullable)#>onCompletion:^(ZDPortalAttachment * attachment, NSError * error) { 
     // on success, attachment will return a value, error will return nil 
     // on failure, error will return a value, attachment will return nil 
     }];

if ZohoDeskPortalSDK.isUserLoggedIn { 
    ZohoDeskPortalSDK.Ticket.add(withFields:<#T##[String : Any]#>) { (ticket, error) in 
    // on success, ticket will return an object, error will return nil 
    // on failure, error will return a value, ticket will return nil 
    } 
    } else { 
    ZohoDeskPortalSDK.Ticket.addAsGuest(withFields: <#T##[String : Any]#>) { (ticketNumber, error) in 
    // on success, ticketNumber will return a string value, error will return nil 
    // on failure, error will return a value, ticketNumber will return nil 
    } 
    }

if (ZohoDeskPortalSDK.isUserLoggedIn) { 
    [ZohoDeskPortalSDKTicket addWithFields:<#(NSDictionary * _Nonnull)#>onCompletion:^(ZDPTicket * ticket, NSError * error) { 
    // on success, ticket will return an object, error will return nil 
    // on failure, error will return a value, ticket will return nil 
    }]; 
    }else{ 
    [ZohoDeskPortalSDKTicket addAsGuestWithFields:<#(NSDictionary * _Nonnull)#>onCompletion:^(NSString * ticketNumber, NSError * error) { 
    // on success, ticketNumber will return a string value, error will return nil 
    // on failure, error will return a value, ticketNumber will return nil 
    }] 
    }

Note : EmailAddress, Subject, and DepartmentID are mandatory parameters in the method call

Customizing the Community module

ZDPCommunityConfiguration.isTopicEditAllowed = <#Bool#> 
    ZDPCommunityConfiguration.isTopicDeleteAllowed = <#Bool#> 
    ZDPCommunityConfiguration.isReplyAllowed = <#Bool#> 
    ZDPCommunityConfiguration.iReplyEditAllowed = <#Bool#> 
    ZDPCommunityConfiguration.isReplyDeleteAllowed = <#Bool#>

ZDPCommunityConfiguration.isTopicEditAllowed = <#Bool#>; 
    ZDPCommunityConfiguration.isTopicDeleteAllowed = <#Bool#>; 
    ZDPCommunityConfiguration.isReplyAllowed = <#Bool#>; 
    ZDPCommunityConfiguration.iReplyEditAllowed = <#Bool#>; 
    ZDPCommunityConfiguration.isReplyDeleteAllowed = <#Bool#>;

ZohoDeskPortalSDK.Community.getMostPopularTopics(<#[String:Any]?#>) { (result: Result<[ZDPCommunity.TopicDetail], ZDPError>) in 
    // switch on result to get array of topics on success 
    }

[ZohoDeskPortalSDKCommunity getMostPopularTopics:<#(NSDictionary * _Nullable)#>onCompletion:^(NSArray * topics, NSError * error) { 
     // on success, topics will return an array, error will return nil 
     // on failure, error will return a value, topics will return nil 
     }];

1. categoryId - string - ID of the community category from which the topics must be fetched. If you want to include all categories, pass the value "-1".
   
2. filterType - string - Type of forum topic. Values allowed are: QUESTION , IDEA , ANNOUNCEMENT , PROBLEM , and DISCUSSION .
   
3. from - int - Index number, starting from which the topics must be fetched. Value starts from 1.
   
4. limit - int - Number of topics to fetch
   
5. includeCount - Boolean - Parameter that specifies whether the number of topics fetched must be displayed or not
   

ZohoDeskPortalSDK.Community.getMostDiscussedTopics(<#[String:Any]?#>) { (topics, error) in 
    // on success, topics will return an array, error will return nil 
    // on failure, error will return a value, products will return nil 
    }

[ZohoDeskPortalSDKCommunity getMostDisuccedTopics:<#(NSDictionary * _Nullable)#>onCompletion:^(NSArray * topics, NSError * error) { 
     // on success, topics will return an array, error will return nil 
     // on failure, error will return a value, topics will return nil 
     }];

1. categoryId - string - ID of the community category from which the topics must be fetched. If you want to include all categories, pass the value "-1".
   
2. filterType - string - Type of forum topic. Values allowed are: QUESTION , IDEA , ANNOUNCEMENT , PROBLEM , and DISCUSSION .
   
3. from - int - Index number, starting from which the topics must be fetched. Value starts from 1.
   
4. limit - int - Number of topics to fetch
   
5. includeCount - Boolean - Parameter that specifies whether the number of topics fetched must be displayed or not
   

Customizing the Tickets Module

ZDPortalSubmitTicket.setFieldsListTobeShown(fields: <#[ZDVisibleTicketField]#>)

[ZDPortalSubmitTicket setFieldsListTobeShownWithFields:<#(NSArray * _Nonnull)#>];

ZDPortalSubmitTicket.preFillTicketFields(forForms: <#[ZDCustomizedTicketForm]#>)

[ZDPortalSubmitTicket preFillTicketFieldsForForms:<#[ZDCustomizedTicketForm]#>];

1. fieldApiName - string - apiName of the ticket field. You can retrieve the apiName of each field using the getTicketForm() method.
   
2. fieldValue - object
   
   1. For multiselect fields, pass the values allowed, as a comma(,) separated string.
      
   2. For pick list fields, pass one of the values allowed, as a string.
      
   3. For date fields, pass the value as a string in the MM/dd/yyyy format.
      
   4. For dateTime fields, pass the value as a string in the MM-dd-yyyy hh:mm aa format.
      
   5. For Boolean fields, pass a String value("true"/"false").
      
   6. For all other field types, pass the values as string objects.
      
   7. Make sure that the values you pass here to the maxlength and decimal restrictions defined for the field.
      
3. isEditable - Boolean - Key that defines if the value in the field is editable or not
   

Note : For more clarity check the sample here.

ZDPTicketConfiguration.isCommentAllowed = <#Bool#> 
    ZDPTicketConfiguration.isCommentDeleteAllowed = <#Bool#> 
    ZDPTicketConfiguration.isCommentEditAllowed = <#Bool#> 
    ZDPTicketConfiguration.isReplyAllowed = <#Bool#> 
    ZDPTicketConfiguration.isTicketUpdateAllowed = <#Bool#>

ZDPTicketConfiguration.isCommentAllowed = YES; 
    ZDPTicketConfiguration.isCommentDeleteAllowed = YES; 
    ZDPTicketConfiguration.isCommentEditAllowed = YES; 
    ZDPTicketConfiguration.isReplyAllowed = YES; 
    ZDPTicketConfiguration.isTicketUpdateAllowed = YES;

Others

import ZohoDeskPortalAPIKit 
    ... 
    var body = [String : Any]() 
    body["displayName"] = "displayName" 
    body["mobile"] = "123456" 

    ZohoDeskPortalSDK.updateUserInformation(with: body) { (profile, error) in { 
    // on success only profile will return a value, error will return nil 
    // on failure only error will return a value, profile will return nil 
    }

NSMutableDictionary * body = [NSMutableDictionary new]; 
    [body setObject:@"displayName" forKey:@"displayName"]; 
    [body setObject:@"123456" forKey:@"mobile"]; 
    [ZohoDeskPortalSDK updateUserInformationWith:body onCompletion:^(Profile * profile, NSError * error) { 
    // on success only profile will return a value, error will return nil 
    // on failure only error will return a value, profile will return nil 
    }];

SDK Logging

import ZohoDeskPortalAPIKit 
    ... 
    ZohoDeskPortalSDK.disableLogs()

@import ZohoDeskPortalAPIKit; 
     ... 
     [ZohoDeskPortalKit disableLogs]

Release Notes

• Provided support for having a multilingual Knowledge Base. 
  
• Provided support for iOS 14. 
• Included Conditional Layouts and Ticket Templates in the Add Ticket module.
• Added an API provider as a separate lightweight framework containing all APIs available. You can build a custom UI and incorporate the APIs into it.
  
• Incorporated dark mode.
  
• Made the text in the SDK more accessible by configuring the SDK's font size to match that of the system.
  
• Added the option to enable large titles for iOS 11 and above.
  
• Embedded the Search bar within the navigation bar for iOS 11 and above.

SDK v1.0

Introduction

• Customer support team (to raise tickets or chat with support agents)
  
• Knowledge Base (to access help articles)
  
• User community (to interact with other users of the app)
  

Setting Up the SDK in Zoho Desk

1. Go to this path in Zoho Desk:  Setup →  Channels →  ASAP.
   
2. In the  Setup pane on the left, under  ASAP, click the  + button next to  Mobile. The  Create Mobile Add-On page appears. 
   
   
   
3. Under  Add-On Details, configure the following settings:
   
   • Name: Name for the ASAP add-on. This name is only for reference; it does not appear anywhere on the app UI.
     
   • Available for: Departments for which this ASAP add-on must be enabled
     
   • Bundle ID: In the  iOS field, enter the bundle ID of your iOS app. (You can retrieve the bundle ID from the  General tab within the project target of your app settings.)
     
     Note : Bundle ID is mandatory for enabling Live Chat and sending push notifications.
     
   • Live Chat: Toggle switch for enabling/disabling Live Chat.
     
     Note : The Live Chat component reflects the settings configured for the chat channel in your help desk portal. Therefore, any change required must be done via the Setup page in Zoho Desk.
     
   • Push Notifications :Toggle switch for enabling/disabling push notifications. For more details, refer to the Enabling Notifications section in this document.
     
     Note : JWT-based user authentication is mandatory for enabling notifications. Push notifications related to tickets are not sent to anonymous users.
     
   • Authentication Method: User authentication setting for the add-on
     
     • Anonymous - In this method, end-users are considered guest users. They can only submit tickets, view posts in the user community, and chat with a customer support agent. They cannot view the tickets they submitted or actively participate in the user community.
       
     • JWT - In this method, end-users are considered authenticated users. In addition to the activities that guest users can perform, authenticated users can also view and track the status of the tickets they submitted, reply/comment to a ticket, and actively participate in the user community (with rights to perform actions, such as following a topic, adding a topic, and adding a comment to existing posts).
       
4. Click Save.
   

Integrating the SDK with Your App

1. In Terminal, navigate to the top-level folder of your project (the folder with the  xcodeproj file).
   
2. Execute the  $ pod init command.
   
3. Then, open the Podfile in Xcode by executing the  open -a Xcode Podfile command. The content should look as follows:
   

   # Uncomment this line to define a global platform for your project # platform :ios, '9.0' # Uncomment this line if you're using Swift # use_frameworks! target 'My Sample App' do end
   
   

4. If you use Swift, uncomment the  use_frameworks! line.
   

1. Add the following code to the do block of the Podfile.
   

   target 'My Sample App' do pod 'ZohoDeskPortalSDK', :git => 'https://github.com/zoho/ZohoDeskPortalSDK.git' end
   
   

2. Save the Podfile.
   
3. Execute the  $ pod install command in Terminal.
   

Note 

If you use Swift for developing your app, add one of the following lines to the Podfile, based on the Xcode version used.

• For Xcode version 10.0 and 10.1, add the following line:
  
  pod 'ZohoDeskPortalSDK', :git => ' https://github.com/zoho/ZohoDeskPortalSDK.git', :branch => 'Xcode_10.0'
  
• For Xcode version 10.2, add the following line:
  
  pod 'ZohoDeskPortalSDK', :git => ' https://github.com/zoho/ZohoDeskPortalSDK.git'
  

1. Download the ZohoDeskPortalSDK from this link and Mobilisten SDK from this link.
   
2. Decompress both the zip files. Then, drag and drop the ZohoDeskPortalSDK.framework and Mobilisten.framework files to the Embedded Binaries section of your Xcode project bundle.
   
3. Then, create a new run script phase from your app target's  Build Phases tab. Paste the following code snippet in the script text field of the run script that appears. (Make sure that this script appears last in the  Build Phases tab.) 
   

   bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/ZohoDeskPortalSDK.framework/strip-frameworks.sh"
   
   

   This script helps overcome a bug related to archiving universal binaries in apps submitted to the App Store. Make sure that the  VALID_ARCHS build setting of your app does not contain  i386 or  x86_64 in the release configuration. 
   

Note : Make sure to add the  NSPhotoLibraryUsageDescription,  NSCameraUsageDescription, and NSBluetoothPeripheralUsageDescription keys in the info.plist file of your app. 

Initializing the SDK in Your App

• Org ID
  
• App ID
  
• Datacenter
  

1. Import the Zoho Desk Portal SDK framework into the  AppDelegate file in your project.
   
   Swift
   

   import ZohoDeskPortalSDK
   
   

   Objective-C
   

   @import ZohoDeskPortalSDK;
   
   

2. Paste the following initialization code into the application method with the  didFinishLaunchingWithOptions argument.
   
   Swift
   

   func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool { let config = ZDPortalConfiguration() config.enableHelpCenter = true config.enableCreateTicket = true config.enableMyTicket = true config.enableCommunity = false ZohoDeskPortalSDK.initializeSDK(<#ORGID#>, appId: <#APPID#>, dataCenter: <#dataCenterValue#>, configuration: <#config#>) return true }
   
   

   Objective-C
   

   - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { ZDPortalConfiguration * config = [[ZDPortalConfiguration alloc]init]; config.enableHelpCenter = YES; config.enableCommunity = YES; config.enableCreateTicket = YES; config.enableMyTicket = YES; [ZohoDeskPortalSDK initializeSDK:<#ORGID#> appId:<#APPID#> dataCenter:<#dataCenterValue#> configuration:<#config#>]; return YES; }
   
   

Note

: Datacenter values according to the deployment type are as follows:

CN - ZDDataCenter.CN

EU - ZDDataCenter.EU

US - ZDDataCenter.US

IN - ZDDataCenter.IN

Displaying Help Components

Note : Live chat is not enabled by default in the SDK UI. You must first enable live chat in your Zoho Desk portal.

ZohoDeskPortalSDK.showHomePage(controller: self)

[ZohoDeskPortalSDK showHomePageWithController:self];

let config = ZDPortalConfiguration() config.enableHelpCenter = true // disable/enable the Help center (Knowledge Base). config.enableCommunity = false // disable/enable the Community. config.enableCreateTicket = true // disable/enable the CreateTicket. config.enableMyTicket = true // disable/enable My Tickets. ZohoDeskPortalSDK.showHomePage(controller: self, withConfiguration: config)

ZDPortalConfiguration * config = [[ZDPortalConfiguration alloc]init]; config.enableHelpCenter = YES; // disable/enable the Help center (Knowledge Base). config.enableCommunity = NO; // disable/enable the Community. config.enableCreateTicket = YES; // disable/enable the CreateTicket. config.enableMyTicket = YES; // disable/enable My Tickets. [ZohoDeskPortalSDK showHomePageWithController:self withConfiguration:config];

ZohoDeskPortalSDK.showLiveChat(controller: self)

[ZohoDeskPortalSDK showLiveChatWithController:self];

ZohoDeskPortalSDK.showHelpCenter(controller: self)

[ZohoDeskPortalSDK showHelpCenterWithController:self];

ZohoDeskPortalSDK.addTicket(controller: self)

[ZohoDeskPortalSDK addTicketWithController:self];

ZohoDeskPortalSDK.addTicket(controller: self, onCompletion: { (ticketDetail) in // The ticketDetail parameter contains the details of the ticket created. // Your program logic goes here. }) { (error) in // error creating Ticket }

[ZohoDeskPortalSDK addTicketWithController:self onCompletion:^(TicketDetailJsonObject * ticket) { // The ticketDetail parameter contains the details of the ticket created. // Your program logic goes here. } onError:^(NSError * error) { // error creating Ticket }];

Note : If an authenticated user submits a ticket, all ticket details are sent to your app. If a guest user submits a ticket, only the ticket number is sent.

ZohoDeskPortalSDK.ticketList(controller: self)

[ZohoDeskPortalSDK ticketListWithController:self];

ZohoDeskPortalSDK.showCommunity(controller: self)

[ZohoDeskPortalSDK showCommunityWithController:self];

Authenticating Users in the SDK

• Anonymous - In this type, end-users are considered guest users. They can only submit tickets, view posts in the user community, and chat with a customer support agent. They cannot view the tickets they submitted or actively participate in the user community.
  
• JWT - In this type, end-users are considered authenticated users. In addition to the activities that guest users can perform, authenticated users can also view the tickets they submitted and actively participate in the user community (with rights to perform actions, such as following a topic, adding a topic, and adding a comment to existing posts).
  

if !ZohoDeskPortalSDK.isZDUserSignedIn{ ZohoDeskPortalSDK.set(jwtUserIdentifier: <#Remote user Token#>, onCompletion: { }, onError: { (error) in }) }else{ //User already signed into SDK }

if (![ZohoDeskPortalSDK isZDUserSignedIn]){ [ZohoDeskPortalSDK setWithJwtUserIdentifier:<#Remote user Token#> onComplition:^{ } onError:^(NSError * error) { }]; }else{ //User already signed into SDK }

• if the value returned is true, the user can continue performing their task as an authenticated user in the add-on
  
• if the value returned is false,  ZohoDeskPortalSDK.set is called to login the user
  

ZohoDeskPortalSDK.logout()

[ZohoDeskPortalSDK logout];

Clearing Local Data

ZohoDeskPortalSDK.clearAllLocalData()

[ZohoDeskPortalSDK clearAllLocalData];

Hiding Help Components

let config = ZDPortalConfiguration() config.enableHelpCenter = false // disable the Help center (Knowledge Base). config.enableCommunity = false // disable the Community. config.enableCreateTicket = false // disable the CreateTicket. config.enableMyTicket = false // disable My Tickets. config.showLeftMenu = true // enable/disable left Menu

ZDPortalConfiguration * config = [[ZDPortalConfiguration alloc]init]; config.enableHelpCenter = NO; // disable the Help center (Knowledge Base). config.enableCommunity = NO; // disable the Community. config.enableCreateTicket = NO; // disable the CreateTicket. config.enableMyTicket = NO; // disable My Tickets. config.showLeftMenu = YES; // enable/disable left Menu

Note : You must send the configuration object in the ZohoDeskPortalSDK.initializeSDK function. For more details, refer to the Initializing the SDK in Your App section of this document.

Customizing the Add-On UI

ZDTheme.applyTheme(theme: .white)

[ZDTheme applyThemeWithTheme:ZDThemeTypeWhite];

ZDTheme.applyTheme(theme: .dark)

[ZDTheme applyThemeWithTheme:ZDThemeTypeDark];

let articleTheme = ZDThemeArticle.init() articleTheme.tintColor = UIColor.white articleTheme.primaryTextColor = UIColor.white articleTheme.secondryTextColor = UIColor(red:0.12, green:0.13, blue:0.15, alpha:1.00) articleTheme.primaryBackgroundColor = UIColor(red:0.12, green:0.13, blue:0.15, alpha:1.00) articleTheme.secondryBackgroundColor = UIColor(red:0.12, green:0.13, blue:0.15, alpha:1.00) articleTheme.cellSeporatorColor = UIColor(red:0.12, green:0.13, blue:0.15, alpha:1.00) articleTheme.headerColor = UIColor(red:0.13, green:0.18, blue:0.15, alpha:1.00)

ZDThemeArticle * articleTheme = [ZDThemeArticle init]; articleTheme.tintColor = [UIColor whiteColor]; articleTheme.primaryTextColor = [UIColor whiteColor]; articleTheme.secondryTextColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00]; articleTheme.primaryBackgroundColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00]; articleTheme.secondryBackgroundColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00]; articleTheme.cellSeporatorColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00]; articleTheme.headerColor = [UIColor colorWithRed:0.12 green:0.13 blue:0.15 alpha:1.00];

Note : You can similarly customize the articles listing page and ticket submission page. However, keep in mind that such customization will override the SDK theme.

ZDNavigationTheme.navigationBarColor = UIColor.blue ZDNavigationTheme.titleColor = UIColor.white ZDNavigationTheme.barButtonTextColor = UIColor.white ZDNavigationTheme.translucent = false ZDNavigationTheme.statusBarApperance = .lightContent ZDNavigationTheme.backButtonStyle = ZDNavigationBackButtonStyle.icon

[ZDNavigationTheme setNavigationBarColor:[UIColor blueColor]]; [ZDNavigationTheme setTitleColor:[UIColor blueColor]]; [ZDNavigationTheme setBarButtonTextColor:[UIColor blueColor]]; [ZDNavigationTheme setTranslucent:NO]; [ZDNavigationTheme setStatusBarApperance:UIStatusBarStyleLightContent]; [ZDNavigationTheme setBackButtonStyle:ZDNavigationBackButtonStyleIcon];

1. Add the font(s) to your project.
   
2. Edit the info.plist file of your app to include the  Fonts provided by application key.
   
3. Under this key, list the file names of all the fonts you want to use in the SDK UI.
   

let font = ZDCustomFont() font.fontFamilyName = "ProximaNova" font.regularFontName = "ProximaNova-reg" font.lightFontName = "ProximaNova-light" font.boldFontName = "ProximaNova-Bold" font.mediumFontName = "ProximaNova-Bold"

ZDCustomFont * font = [ZDCustomFont init]; font.fontFamilyName = @"ProximaNova"; font.regularFontName = @"ProximaNova-reg"; font.lightFontName = @"ProximaNova-light"; font.boldFontName = @"ProximaNova-Bold"; font.mediumFontName = @"ProximaNova-Bold";

Note : If you do not use a custom font, the add-on displays the system font by default.

Changing Language Settings

ZDPortalConfiguration.setSDKLanguage = "en"

ZDPortalConfiguration.setSDKLanguage = @"en";

Customizing UI Strings

1. Create a bundle titled  ASAPStrings.bundle in the Xcode project of your app. The path to access this bundle is: Application-bundle/ASAPStrings.bundle.
   
2. From  this link, download the lproj file containing the default strings that appear in the SDK UI.
   
3. Add the lproj file you downloaded in the previous step to the  ASAPStrings bundle.
   
4. Open the  ASAPLocalizable.strings file within the lproj file and customize the text as required.
   

Note : Each language has a unique lproj file. To customize the strings in each language that you want to support in the SDK, choose the relevant lproj file while performing step 2 and repeat steps 3 and 4

Enabling Notifications

1. Create and download an APNs certificate from Apple's developer portal.
   
2. Double-click the certificate. This action automatically imports it to the Keychain Access application.
   
3. Locate and expand the certificate in Keychain Access. The corresponding key for the certificate appears.
   
4. Select both the certificate and the key and right-click on them. A context menu appears.
   
5. Click the export option. A dialog box appears.
   
6. In this dialog box, make sure that . p12 is selected in the  File Format drop-down list and click  Save. 
   
7. Enter a password to access the file and click  OK. The certificate is now exported as a .p12 file. 
   

func application(_ application: UIApplication,didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) { let token = deviceToken.reduce("", {$0 + String(format: "%02X", $1)}).uppercased() ZohoDeskPortalSDK.enablePushNotification(deviceToken:token, mode: .production) }

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken{ NSString * token = [[[[deviceToken description] stringByReplacingOccurrencesOfString: @"<" withString: @""] stringByReplacingOccurrencesOfString: @">" withString: @""] stringByReplacingOccurrencesOfString: @" " withString: @""]; [ZohoDeskPortalSDK enablePushNotificationWithDeviceToken:token isTestDevice:NO mode:APNSModeProduction]; }

Note

• You can verify if notifications are sent accurately by testing the functionality in development mode. To switch to development mode, replace ".production" in the code snippet above with ".sandbox".
  
• Make sure to switch back to production mode before deploying the app for end-customer use.
  

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any]) { ZohoDeskPortalSDK.processRemoteNotification(userInfo: userInfo) }

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler{ [ZohoDeskPortalSDK processRemoteNotificationWithUserInfo:userInfo]; }

Displaying Details of Anonymous Users to Agents

ZDPortalConfiguration.setGuestUser(email: <#Guest_User_Email#>, displayName: <#Guest_User_DisplayName#>", phoneNumber: <#Guest_User_PhoneNumber#>")

[ZDPortalConfiguration setGuestUserWithEmail:<#Guest_User_Email#> displayName:<#Guest_User_DisplayName#> phoneNumber:<#Guest_User_PhoneNumber#>];

Programmatically Adding Tickets

ZDProvoider.sharedInstance.getDepartments(onCompletion: { (departments) in // get departments list in departments variable }) { (error) in // error in departments fetch }

[[ZDProvoider sharedInstance] getDepartmentsOnCompletion:^(NSArray * departments) { // get departments list in departments variable } onError:^(NSError * error) { // error in departments fetch }];

ZDProvoider().getProductsFor(<#Department ID#>, from: <#T##Int#>, limit: <#T##Int#>, onCompletion: { (products) in // get products list in products variable }) { (error) in // error in products fetch }

[ZDProvoider sharedInstance] getProductsFor:@"Department ID" from:<#(NSInteger)#> limit:<#(NSInteger)#> onCompletion:^(NSArray products) { // get products list in products variable } onError:^(NSError * error) { // error in products fetch }

ZDProvoider.sharedInstance.getTicketForm(<#Department ID#>, onCompletion: { (ticketFilelds) in // get Ticket Form in ticketFilelds variable }) { (error) in // error in TicketForm fetch }

[[ZDProvoider sharedInstance] getTicketForm:<#Department ID#> onCompletion:^(NSArray * ticketFilelds) { // get Ticket Form in ticketFilelds variable } onError:^(NSError * error) { // error in TicketForm fetch }];

ZDProvoider.sharedInstance.uploadTicketAttachment(<#Your File path#>, onCompletion: { (attachement) in // get uploaded attachement object in attachement variable }) { (error) in // error in Attachement upload }

[[ZDProvoider sharedInstance] uploadTicketAttachment:<#Your File path#> onCompletion:^(AttachmentJsonObject * attachement) { // get Ticket Form in ticketFilelds variable } onError:^(NSError * error) { // error in Attachement upload }];

let ticketForm = ZDTicketForm() ticketForm.emailID = <#User email ID#> ticketForm.contactName = <#Contact Name#> ticketForm.subject = <#Ticket Subject#> ticketForm.departmentID = <#Ticket Department ID#> ticketForm.descriptionText = <#Ticket Description Text#> ZDProvoider.sharedInstance.createTicket(form: ticketForm, onCompletion: { (ticket) in // get created ticket object in ticketDetail variable }) { (error) in // error in ticket submission }

ZDTicketForm * ticketForm = [ZDTicketForm init]; [ticketForm setEmailID:<#User email ID#>]; [ticketForm setContactName:<#Contact Name#>]; [ticketForm setSubject:<#Ticket Subject#>]; [ticketForm setDepartmentID:<#Ticket Department ID#>]; [ticketForm setDescriptionText:<#Ticket Description Text#>]; [[ZDProvoider sharedInstance] createTicketWithForm:ticketForm onCompletion:^(TicketDetailJsonObject * ticket) { // get created ticket object in ticketDetail variable } onError:^(NSError * error) { // error in ticket submission }]

Knowledge Base

ZohoDeskPortalSDK.showCatgoryByPermalink(forPermaLink:"permalink", controller: self)

[ZohoDeskPortalSDK showCatgoryByPermalinkForPermaLink:@"permalink" controller:self];

1. Self is the instance of the UIViewController.
   
2. Permalink is the URL of the Knowledge Base category.
   

ZohoDeskPortalSDK.showHelpPage(forPermaLink: "permalink", controller: self)

[ZohoDeskPortalSDK showHelpPageForPermaLink:@"permalink" controller:self];

1. Self is the instance of the UIViewController.
   
2. Permalink is the URL of the help article.
   

Community

ZDCommunityConfiguration.configure.isTopicDeleteAllowed = true ZDCommunityConfiguration.configure.isTopicEditAllowed = true ZDCommunityConfiguration.configure.isReplyDeleteAllowed = true ZDCommunityConfiguration.configure.isReplyEditAllowed = true ZDCommunityConfiguration.configure.isReplyAllowed = true

[ZDCommunityConfiguration configure].isTopicDeleteAllowed = YES; [ZDCommunityConfiguration configure].isTopicEditAllowed = YES; [ZDCommunityConfiguration configure].isReplyDeleteAllowed = YES; [ZDCommunityConfiguration configure].isReplyEditAllowed = YES; [ZDCommunityConfiguration configure].isReplyAllowed = YES;

ZDProvoider.sharedInstance.getZDMostPopularCommunityTopics(forCategory: "Your Category ID", filterType: "ALL", from: 1, limit: 10, includeCount: false, { (communityTopics) in // get most popular topic list in communityTopics callback }) { (error) in // error }

[[ZDProvoider sharedInstance] getZDMostPopularCommunityTopicsForCategory:@"Your Catehory ID" filterType:@"ALL" from:1 limit:10 includeCount:NO :^(NSArray communityTopics) { // get most popular topic list in communityTopics callback } onError:^(NSError * error) { // error }];

1. categoryId - string - ID of the community category from which the topics must befetched. If you want to include all categories, pass the value "-1".
   
2. filterType - string - Type of forum topic. Values allowed are:  QUESTION,  IDEA,  ANNOUNCEMENT,  PROBLEM, and  DISCUSSION.
   
3. from - int - Index number, starting from which the topics must be fetched. Value starts from 1.
   
4. limit - int - Number of topics to fetch
   
5. includeCount - Boolean - Parameter that specifies whether the number of topics fetched must be displayed or not
   

ZDProvoider.sharedInstance.getZDMostDiscussedCommunityTopics(forCategory: "Your Category ID", filterType: "ALL", from: 1, limit: 10, includeCount: false, { (communityTopics) in // get most discussed topic list in communityTopics callback }) { (error) in // error }

[[ZDProvoider sharedInstance] getZDMostDiscussedCommunityTopicsForCategory:@"Your Catehory ID" filterType:@"ALL" from:1 limit:10 includeCount:NO :^(NSArray communityTopics) { // get most discussed topic list in communityTopics callback } onError:^(NSError * error) { // error }];

1. categoryId - string - ID of the community category from which the topics must befetched. If you want to include all categories, pass the value "-1".
   
2. filterType - string - Type of forum topic. Values allowed are:  QUESTION,  IDEA,  ANNOUNCEMENT,  PROBLEM, and  DISCUSSION.
   
3. from - int - Index number, starting from which the topics must be fetched. Value starts from 1.
   
4. limit - int - Number of topics to fetch
   
5. includeCount - Boolean - Parameter that specifies whether the number of topics fetched must be displayed or not
   

Tickets

1. fieldApiName - string - apiName of the ticket field. You can retrieve the apiName of each field using the  getTicketForm() method.
   
2. fieldValue - object
   
   • For multiselect fields, pass the values allowed, as a comma(,) separated string.
     
   • For pick list fields, pass one of the values allowed, as a string.
     
   • For date fields, pass the value as a string in the MM/dd/yyyy format.
     
   • For dateTime fields, pass the value as a string in the MM-dd-yyyy hh:mm aa format.
     
   • For Boolean fields, pass a String value("true"/"false").
     
   • For all other field types, pass the values as string objects.
     
   • Make sure that the values you pass here to the maxlength and decimal restrictions defined for the field.
     
3. isEditable - Boolean - Key that defines if the value in the field is editable or not
   

Note : For more clarity check the sample here.

ZDTicketConfiguration.configure.isCommentAllowed = true ZDTicketConfiguration.configure.isCommentDeleteAllowed = true ZDTicketConfiguration.configure.isCommentEditAllowed = true ZDTicketConfiguration.configure.isReplyAllowed = true ZDTicketConfiguration.configure.isTicketUpdateAllowed = true

ZDTicketConfiguration.configure.isCommentAllowed = YES; ZDTicketConfiguration.configure.isCommentDeleteAllowed = YES; ZDTicketConfiguration.configure.isCommentEditAllowed = YES; ZDTicketConfiguration.configure.isReplyAllowed = YES; ZDTicketConfiguration.configure.isTicketUpdateAllowed = YES;

Others

var body = [String : Any]() body["displayName"] = "displayName" body["mobile"] = "123456" ZDProvoider.sharedInstance.UpdateUserInformation(userInfo: body, { (userInfo) in // get updated user information in userInfo variable }) { (error) in // error }

NSMutableDictionary * body = [NSMutableDictionary new]; [body setObject:@"displayName" forKey:@"displayName"]; [body setObject:@"123456" forKey:@"mobile"]; [[ZDProvoider sharedInstance] UpdateUserInformationWithUserInfo:body :^(NSDictionary * userInfo) { // get updated user information in userInfo variable } onError:^(NSError * error) { // error }];

SDK Logging

ZDPortalConfiguration.enableLogMessages = true

ZDPortalConfiguration.enableLogMessages = YES;

Release Notes

• Introduced an event callback that helps detect the dismissal of the Chat module.
  
• Fixed an issue that caused a delay in loading the Chat screen for the first time.
  
• Added a provision that lets users display custom UI text/labels.
  
• Added the provision to enable/disable user actions in the ticket submission screen. For more details, click here.
  
• Improved the capabilities related to attaching files.
  

• Introduced an API that helps update user details. For more details, click here.
  

• Fixed a critical issue that sometimes caused the app to crash when users tried to login to the add-on.
  

• Introduced an event callback that helps detect the dismissal of the ZohoDeskPortalSDK view controller.
  
  Swift
  

  ZohoDeskPortalSDK.dismissController {(controller) in // You can find dismissed from ZohoDeskPortalSDK using ZDViewController object switch controller{ case .DashBoard: print("DashBoard") default: break } }
  
  

  Objective-C
  

  [ZohoDeskPortalSDK dismissControllerOnCompletion:^(enum ZDViewController controller) { switch (controller) { case ZDViewControllerDashBoard: NSLog(@"DashBoard"); default: break; } }];
  
  

• Added an event callback to the Logout method.
  
  Swift
  

  ZohoDeskPortalSDK.logout(onComplition: { print("User sucessfully logged out") }) { (error) in print(error) }
  
  

  Objective-C
  

  [ZohoDeskPortalSDK logoutOnComplition:^{ // } onError:^(NSError * error) { // }];
  
  

• Included the All option in the sub-forum filter in the Community module.
  
• Enabled deep-linking for Knowledge Base categories.
  
• Added the provision to enable/disable user actions in the Community module.For more details, check here.
  

• Introduced methods that help custom-configure the fields in the Submit Ticketscreen. For more details, check here.
  
• Tweaked the Submit Ticket form such that the Department field is not displayed if the help desk portal has only one department.
  

• Introduced rich text formatting for ticket comments.
  
• Implemented threaded comments for forum topics in the user community.
  
• Implemented comment actions for comments on forum topics.
  
• Implemented search feature within the user community.
  
• Added APIs related to community categories, most popular topics, and most discussed topics.
  
• Added a method that launches the topic detail screen when a topic ID is passed.
  
• Added the Discussion topic type to the Community module.
  
• Introduced event callbacks. For details, refer to the following sample code.
  
  Swift
  

  ZohoDeskPortalSDK.ZDAnalyticsTracker { (analyticsObject) in if analyticsObject?.getEventAction() == .KBArticleClicked{ print("An Article is clicked.") //An Article is clicked. You can Log or Push this to any of the Analytics tools. }else if analyticsObject?.getEventAction() == .CommunityTopicClicked{ print("A Topic is clicked.") //A topic is clicked. You can Log or Push this to any of the Analytics tools. } }
  
  

  Objective-C
  

  [ZohoDeskPortalSDK ZDAnalyticsTrackerOnCompletion:^(ZDAnalytics * analyticsObject) { if ([analyticsObject getEventAction] == ZDPortalUIActionKBArticleClicked) { NSLog(@"An Article is clicked."); //An Article is clicked. You can Log or Push this to any of the Analytics tools. }else if ([analyticsObject getEventAction] == ZDPortalUIActionCommunityTopicClicked) { NSLog(@"A Topic is clicked."); //A topic is clicked. You can Log or Push this to any of the Analytics tools. } }];
  
  

• Fixed an issue related to the search functionality in the Community module. (If you are a new user starting out with this version of the SDK, you do not have to make any changes to overcome this issue. But if you are upgrading from the previous version of the SDK and have enabled JWT-based authentication in your Zoho Desk portal, make sure to regenerate the user token after upgrading. No functionality or features will be impacted for end-users.) For details, refer to the following sample code.
  
  Swift
  

  if !ZohoDeskPortalSDK.isZDUserSignedIn || !ZohoDeskPortalSDK.isZDSDKMigratedTo1_0{ ZohoDeskPortalSDK.set(jwtUserIdentifier: <#Remote user Token#>, onComplition: { }, onError: { (error) in }) }else{ //User already signed into SDK }
  
  

  Objective-C
  

  if (![ZohoDeskPortalSDK isZDUserSignedIn] || ![ZohoDeskPortalSDK isZDSDKMigratedTo1_0]){ [ZohoDeskPortalSDK setWithJwtUserIdentifier:<#Remote user Token#> onComplition:^{ } onError:^(NSError * error) { }]; }else{ //User already signed into SDK }
  
  

• Added the Follow option for Categories in the Community module.
  
• Enabled custom-configuration of the back button on the navigation bar.
  
  Swift
  

  ZDNavigationTheme.backButtonStyle = ZDNavigationBackButtonStyle.icon
  
  

  Objective-C
  

  [ZDNavigationTheme setBackButtonStyle:ZDNavigationBackButtonStyleIcon];
  
  

• Enabled support for the Indian data center. To host your ASAP add-on on this datacenter, pass the value of the data center key as ZDDataCenter.IN while initializing the SDK.
  
• Included a new method that launches the add-on dashboard with its configuration overridden. For more details, check here
  

• Added the from and limit parameters to Product provider APIs. The from parameter denotes the index number of the resource and the limit parameter denotes the number of resources to return. If these two parameters are not passed in the API request, the first 10 products are returned, by default.
  
• In the Create Ticket provider API, we fixed a critical bug that caused failure of ticket submission when a file was attached to the ticket.
  

• Enabled push notifications for the following ticket actions:
  
  • Agent creates a ticket on behalf of the user.
    
  • Agent sends a new ticket response.
    
  • Priority of the ticket is changed.
    
  • Status of the ticket is changed.
    
  • A new comment is added to a ticket.
    
  • A ticket comment is edited.
    
• Introduced a callback method for the Submit Ticket screen. Through this method, the ASAP add-on can be configured such that ticket details are sent to the app immediately after a ticket is submitted.
  

• Fixed an issue that in some cases caused an app crash when the ASAP framework tried to access Core Data.
  

Migrating from v1.x to v2.0

Integrating the SDK with Your iOS App

Note 

From v2.0:

• The View Controller is not required in any show method.
  
• All show methods have title and style parameters with default values. You can override the parameters, if required.