Configuring in SalesIQ

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

Push Notification Settings

You can send the Push notification alerts to the app user with a message on the mobile device about the chat messages from the visitor or an upcoming event, when the user is not in the SalesIQ application or using the mobile.

You have two environments available for the push notifications settings:

  • Production: You can use the production setup to reflect the changes in the application directly. The modifications made and saving in this environment will get reflected in the application.

  • Sandbox: You can use the sandbox environment to test and debug the modifications before moving the changes to the application.

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?

  1. Log in to the iPhone Developer Connection Portal and click on the iOS Provisioning Portal on the right side of the page.
  2. In welcome page, click on the Identifiers section, to open the list with identifiers.
  3. 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.
  4. Ensure you have created an App ID without a wildcard. Wildcard IDs cannot use the push notification service.
  5. Then, click on the Submit button.

APNs Password

The APNs certificate would demand 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 experiment the push notification services, you can register your testing mobile devices here. And then, you can enter a test message in the text box and click "Test Now". The message will be sent as a push notification to all the registered devices.

How to register your mobile device?

  1. First, call the ZohoSalesIQ.enablePush(String regid, boolean istestdevice); code from your iOS device.
  2. You will have to use the registration id obtained from Apple for receiving push notifications in the “regid” of the code.

You can enter the notification text in the message and click send button to test. The Registered mobile devices will receive your test notification message. 

You also have an option to delete the registered test devices.

Note:

If you delete the test device here, then the test message notifications alone will not be sent to those devices. Other notification will be received/sent on the registered mobile devices. 

Share this post :

FacebookTwitter

Still can't find what you're looking for?

Write to us: support@zohosalesiq.com