Embed Live Chat Inside your iOS Mobile App
Configurations in SalesIQ
The Mobile SDK for iOS from SalesIQ is a quick, convenient, and fully native way to get customer support from your mobile apps. With just a few lines of code, you can provide your end users with an easy way to get in touch with any mobile app.
Table Of Contents
How to configure SalesIQ Mobile SDK?
In Settings - >Websites -> Include Live Chat to your Mobile Apps -> Add, click on IOS.
Then, enter your application BundleID in the text box to authenticate your application with SalesIQ and generate the token.
Bundle ID
The ID for your application used by the system as a domain for the IOS which it can store settings and reference your application uniquely. It is represented in reverse DNS notation, and it is recommended to use your company name and application name to create the ID.
The Token will then be generated for your application, and you can now embed SalesIQ in your application using the app key and access key.
What is the App key and Access key?
The App key and the access key are unique for each application which helps you to authenticate the SalesIQ code in your application. Each app can have one app key and three active access key. The app key is unique and common for all the version of your application. However, the access key will differ from one version to the other.
App Key
The App key is unique to each app, which helps you to locate the application library. This key cannot be re-generated.
Access Key
This key is the token to access the SalesIQ SDK on your application. A unique access key can be associated with each version of the application.
Each application can have three active access keys. When you generate the fourth access key, then you will be prompted to delete an existing access key or the fourth key generated will replace the oldest access key for the application.
You can associate the access key in each version of your application. If you wish to release a new version, then you can create a new access key and associate with the application. The old version will also be accessible until you delete or disable the access key. These keys help you to prevent your chat widget from hackers and malfunctioning of the app.
How to get the App key and Access key for your application?
Once the bundle ID is given in the mobile SDK welcome page and the token to access SalesIQ is generated, then the unique app key and the access key will be provided for your application.
You have to copy and paste the key in the code and embed the SalesIQ code in your application. Configure
How to e-mail the App key and Access key to your developers?
You can email the keys to your developer from the mobile SDK operator console by clicking on the email symbol that appears when you hover over the app key and access key.
Where to insert the App key and Access key?
You will have to insert the App key and Access key in the below mentioned code:
ZohoSalesIQ.initWithAppKey(APP_KEY, accessKey: ACCESS_KEY)
Example:
ZohoSalesIQ.initWithAppKey("Jve9A%2FFqxjnTjfT7YjHr3zKHoj4Prq6wXRmnJW1BtAfeh3%2F0hvSx8CyTm%2BwHDCPz",AccessKey:"0al2ab7gufm9s3gjmv1uuggcony166wlukrtkzgysozc0gseeigvedzfptmmm0n8xruy12n5j%2bqwa%2fzndx0kaxlgk07habfru8qbemb7aqtiusftevzhfalr9xrfe4wqrhbyue9awozsl5pp3keklsogy%2bx%2f39gn")
Advanced Settings
Show Live Chat Widget on your application
To display the chat widget on your application, select the "with live chat" option in the "Show Live Chat" section. Using which you can track the visitors accessing your application and also have a live chat conversation with them.
Note:
By default, the "with live chat" option will be enabled.
You can also customize the chat window using the "Custom APIs".
How to hide the chat button in the application?
To hide the chat widget in the application, and use SalesIQ only to track the visitors accessing your application then choose the "Without Live Chat" option in the "Show Live Chat" section.
You can also customize the tracking options using the "Custom APIs".
Register & Unregister Visitor
If your app has login and logout life cycles, you can enroll your visitor to synchronize across your platforms.
//after login
ZohoSalesIQ.registerVisitor(_id:String?)
//after logout
ZohoSalesIQ.unregisterVisitor( )
Note: Unregister visitor will clear the session of the visitor and then identified as anonymous visitor.