Setting up the SDK  

     You need to integrate the GC widget within your iOS app to create and register the add-on in Zoho Desk.

      1.      In Zoho Desk, go to Setup > GENERAL > Guided Conversations.

 

      2.      In the Setup pane, on the left, under General, click Guided Conversations. Click GC Widgets.

                  The GC Widgets pane will appear. It displays the created widgets.

                  See more: how to create the widget.

 

      3.      Click the Share button () on the right side of the widget you want to embed.

                     A Share Options window will appear.

A new section called Code Snippet will appear. This section displays the following:

• Org ID - Specifies the unique ID of the organization.

• Widget ID - Specifies the unique ID of the selected widget.

• Domain - Specifies the unique URL of your organization. 

Integrating the SDK within the iOS app 

                  The content appears as follows:

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

      1.      Include the SDK of your choice in the Podfile. Include the following code in the do block of the Podfile to integrate the ZohoGCSDK.  

target 'My Sample App' do 
	pod  'ZohoGCSDK'
	end  

      2.      Save the Podfile.

The following keys are essential to call the methods for displaying the conversation AI in your app.

• orgId

• widgetId

• domain

The values of these keys appear under the Code Snippet section on the setup page of the ASAP add-on in Zoho Desk.

SHOW BOT:

Swift

import ZohoGCSDK

Objective-C

  @import ZohoGCSDK;

The following methods display the Guided Conversations.

Swift

 ZohoGC.show(orgId: <#T##String#>, 
widgetId: <#T##String#>, domain: <#T##String#>) 

Objective-C

[ZohoGC showWithOrgId:<#(NSString * _Nonnull)#> 
widgetId:<#(NSString * _Nonnull)#> domain:<#(NSString * _Nonnull)#>]

Session Variables:   

These variables are dynamically retrieved during the conversation. These variables are org-specific and accessible across flows.

You can perform the following actions with the session variable:

Set Session Variable:   

ZohoGC.setSessionVariables(sessionVariables: <#T##[String : String]#>)

Update Session Variable:

ZohoGC.updateSessionVariables(sessionVariables: <#T##[String : String]#>)

Customizing the theme:  

            .                                   

Methods for applying the white theme (Default)

Swift

 ZDThemeManager.setTheme(type: .white)

Objective-C

[ZDThemeManager setTheme:ZDThemeTypeWhite];

Methods for applying the black theme

Swift

ZDThemeManager.setTheme(type: .dark)

Objective-C

 [ZDThemeManager setTheme:ZDThemeTypeDark];

[ZDThemeManager setTheme:ZDThemeTypeSystem];

Customized themes: You can customize the default light and dark themes to make the SDK look more like your application.

To update the default light theme,

Swift

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

Objective-C

 [ZDThemeManager updateThemeWithTheme:<#ZDThemeProtocol#>];

To update the default dark theme,

Swift

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

Objective-C

 [ZDThemeManager updateDarkThemeWithTheme:<#ZDThemeProtocol#>];

ZDThemeProtocol provides a list of properties, such as primaryTextColor and navigationBarTextColor, for additional color customization. All properties in the protocol are optional. You can create any class conforming to this protocol, implement one or more properties, and pass an object of that class to the updateTheme or updateDarkTheme method. The colors you set in the class will override the default theme.

Release Notes

1.2.1

​1.1