import ZohoDeskPortalTicket

@import ZohoDeskPortalTicket;

ZDPortalSubmitTicket.show()

[ZDPortalSubmitTicket showWithTitle:<#(NSString * _Nullable)#> navigationMode:<#(enum ZDPNavigationMode)#>];

ZDPortalTicket.show()

[ZDPortalTicket showWithTitle:<#(NSString * _Nullable)#> navigationMode:<#(enum ZDPNavigationMode)#>];

import ZohoDeskPortalCommunity

@import ZohoDeskPortalCommunity;

ZDPortalCommunity.show()

[ZDPortalCommunity showWithTitle:<#(NSString * _Nullable)#> navigationMode:<#(enum ZDPNavigationMode)#>];

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

[ZDPortalCommunity showTopicWithID:<#(NSString * _Nonnull)#> withTitle:<#(NSString * _Nullable)#>];

  

                                                 

When you enable Guided Conversations and Zia together, Guided Conversations gets loaded by default, and you can switch to Zia if necessary. Note that you cannot switch between Zia and Guided Conversation in the middle of the flow unless you reset the flow by clicking Restart Conversation in the bottom menu.

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 
} 

if !ZohoDeskPortalSDK.isUserLoggedIn
{ 
    ZohoDeskPortalSDK.login(withJWTToken: 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 loginWithJWTToken:
    <#(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 ZohoDeskPortalConfiguration

@import ZohoDeskPortalConfiguration;

ZDPThemeManager.setTheme(type: .light)

[ZDPThemeManager setThemeWithType:ZDPThemeTypeLight];

ZDPThemeManager.setTheme(type: .dark)

[ZDPThemeManager setThemeWithType:ZDPThemeTypeDark];

ZDPThemeManager.setTheme(type: .system)

[ZDPThemeManager setThemeWithType:ZDPThemeTypeSystem];

- ZDPThemeType.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.

ZDPThemeManager.updateLightTheme(theme: <#ZDPThemeProtocol#>)

[ZDPThemeManager updateLightThemeWithTheme:<#ZDPThemeProtocol#>];

ZDPThemeManager.updateDarkTheme(theme: <#ZDPThemeProtocol#>)

[ZDPThemeManager updateDarkThemeWithTheme:<#ZDPThemeProtocol#>];

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 fonts 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#>;

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.
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 will appear.
   
5. Click the export option. A dialog box will appear.
   
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:<#(NSString * _Nonnull)#> isTestDevice:<#(BOOL)#> mode:<#(enum APNSmode)#>];
}

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];
}

You cannot configure Push notifications for only Android or only iOS in the live implementation. We need to configure both.
If you get any of the below errors:

1. FCM token is invalid - The FCM key should be reviewed.
2. Password incorrect - The iOS certificate's password should be checked.
3. Invalid Certificate: The iOS.p12 file is invalid. Please recheck the certificate.

 

Steps to upload the .p12 file for using the APNS Certificate:

1. The .p12 file is generated using the APNS certificate in the keychain application.
2. If you run your application using your Development certificate, you have to choose the Sandbox mode; for the Distribution/Production certificate, you have to select the Production mode in the ASAP setup.
3. .Enter the created password while completing the p12 process in the password section
   

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: <#T##String#>, params: <#T##[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(<#T##params: [String : Any]?##[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
        }]
}

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.isReplyEditAllowed = <#Bool#>; 
    ZDPCommunityConfiguration.isReplyDeleteAllowed = <#Bool#>;

ZohoDeskPortalSDK.Community.getMostPopularTopics(<#T##params: [String : Any]?##[String : Any]?#>)
{ topics, error 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.getMostDisuccedTopics(<#T##params: [String : Any]?##[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. deptId - ID of the department for which you want to configure the Ticket Fields list.
2. layoutId - ID of the particular layout for which you want to configure the Ticket Fields.
3. fieldApiName - string - apiName of the ticket field. You can retrieve the apiName of each field using the getTicketForm() method.
   
4. 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.
      
5. isEditable - Boolean - Key that defines if the value in the field is editable or not
   

For more clarity check the sample here.

ZDPortalSubmitTicket.getCallbackOnCreateTicket 
{ ticket in
// will get ticket object on success
} 
onError: 
{ error in
// will get error on failure
}

[ZDPortalSubmitTicket getCallbackOnCreateTicketWithCompletion:^(ZDPTicket * ticket) 
{
// will get ticket object on success
} onError:^(NSError * error)
{
// will get error on failure
}];

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

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

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

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 
}];

Dictionary [String : Any] data - Key and value pair. The following keys are included: twitter, phone, facebook, name, displayName, mobile, countryLocale, and timeZone.

ASAP configuration

You can enable/disable the following options from the application end:

1. SideMenu
2. Language chooser
   
3. Zoho footer, "powered by ASAP label."
   

By default, all the options are enabled.

To disable the above mentioned options, include the following code snippet:

Swift

let configuration = ZDPConfiguration()
configuration.disableSidemenu = true
configuration.disableLanguageChooser = true
configuration.disablePoweredByZoho = true
ZDPortalConfiguration.set(configuration: configuration)

Objective-C

ZDPConfiguration * configuration = [ZDPConfiguration init];
configuration.disableSidemenu = YES;
configuration.disableLanguageChooser = YES;
configuration.disablePoweredByZoho = YES;
[ZDPortalConfiguration setWithConfiguration:configuration];

SDK Logging

import ZohoDeskPortalAPIKit 
    ... 
    ZohoDeskPortalSDK.enableLogs()

@import ZohoDeskPortalAPIKit;
...

[ZohoDeskPortalSDK enableLogs];

Release Notes

3.0.0-beta-17

1. We implemented the Text-To-Speech and the In-Article Search features for the KB Articles.
   

3.0.0-beta-16

• We handled the Nested pick list in the ASAP SDK Tickets module.

3.0.0-beta-15

• We have provided module-level configuration; you can now easily enable or disable modules throughout the mobile SDK.

3.0.0-beta-14

• Handled the miscellaneous bug issue in the SalesIQ Livechat for a single department.

3.0.0-beta-13

• We integrated the latest SalesIQ SDK version 5.4.1.
• Highlighted the search text.
  

3.0.0-beta-12

• Supported the theme APIs in Objective-C language.

3.0.0-beta-11

1. Provided an option to edit the Ticket Properties within the ASAP SDK.
   

3.0.0-beta-10

1. Implemented login support with JWT token in Objective-C language. For more information, refer "JWTToken " under Authenticating Users in the SDK

3.0.0-beta-9

1. Included arm64 architecture for simulator.
   

3.0.0-beta-8

1. Handled issues faced in the dark theme for the Article detail, Topic detail, and conversation screens.
2. Handled the issue with the bot's customised name reflection in Guided Conversation.
3. Error logs are disabled by default. To enable the error log, refer SDK Logging.
   

3.0.0-beta-7

1. Performance tuning. 
   

3.0.0-beta-6

1. A new independent method has been introduced to receive a callback on create ticket. The old call method has been deprecated. For more information, refer "Submit Ticket event with subscription" under Customizing the Tickets module.
2. Provided an option to disable the side-menu, language chooser, and Zoho footer, "powered by ASAP label." For more information, refer ASAP configuration.

3.0.0-beta-5

• Fixed the problem of uploading attachments faced in iOS 13.
  

• Resolved the problem with the custom title in the Community module.
  

• Handled Configuration for customer happiness thread. For more information, refer "Custom-Configuring Ticket Actions" under Customizing the Tickets module.

• Handled the miscellaneous bug fixes.

3.0.0-beta-4      

• Fixed the navigation issue in Submit Ticket case.

3.0.0-beta-3

1. Supported ASAP switch within your application: While switching to a new ASAP, the customer initializes a new session with a new set of ASAP keys (OrgID, AppID). The new session is established by killing the current session and initialize a new one based on the new keys(OrgID, AppID).
   
2. Supported login using JWT token: You can now allow users to log in using a JWT token in the new authentication flow. For more information, refer "JWTToken " under Authenticating Users in the SDK.
3. UI enhancement and performance tuning.

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#>];

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 
    }] 
    }

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 
     }];

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 
     }];

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

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

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

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

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;

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 
    }];

import ZohoDeskPortalAPIKit 
    ... 
    ZohoDeskPortalSDK.disableLogs()

@import ZohoDeskPortalAPIKit; 
     ... 
     [ZohoDeskPortalKit disableLogs]