Embed Engagement Messenger in a native iOS app using Now Mobile SDK - Support and Troubleshooting

Embed Engagement Messenger in a native iOS app using Now Mobile SDK This topic provides steps to embed Engagement Messenger in a native iOS Mobile App built with Swift.

Pre-requisite:

To embed Engagement Messenger in the native applications, the developer or user needs to configure the following:

Now Mobile SDK libraries in the application. For more information, see Mobile SDK Libraries – iOS in the ServiceNow® store. Mobile SDK Plugin and OAuth JWT Authentication on your ServiceNow Instance. For more details, see Mobile SDK API reference - iOS . Install and configure the latest version of Engagement Messenger (Support v5.2 onwards) in your ServiceNow instance. For more details, see Setting up Engagement Messenger . Copy the Engagement Messenger module ID, as you need it to embed messenger in the mobile app. Procedure

Copy “EngagementMessengerUtil.swift” file to your application project from the SampleApp project. In the View Controller file where Engagement Messenger needs to be embedded, configure EngagementMessengerUtil in the init function. private var emUtils : EngagementMessengerUtil!

init() {

let instanceUrl = “” //specify the Url of your instance e.g. https://instancename.service-now.com

let moduleId = “” //specify the sys_id of Engagement Messenger module or copy the module Id from Engagement Messenger embed code

let emUtils = EngagementMessengerUtil(instanceUrl: instanceUrl, moduleId: moduleId, parentViewController: self)

emUtils.initializeWebService()

}

On any click event or function, the loadEMfeature() function can launch Engagement Messenger on the View Controller. // Open Engagement Messenger Home

emUtils.loadEMfeature()

Use the Deep linking functionality to launch specific features on Engagement Messenger by passing the feature name as a parameter in the loadEMfeature function. For more details, see Deep Linking Features in Engagement Messenger. // Open Engagement Messenger feature

emUtils.loadEMfeature("CHAT")

// Open Engagement Messenger feature with parameters

var params : [String: String] = [ "sys_kb_id" : sys_kb_id ]

emUtils.loadEMfeature(feature: "VIEW_ARTICLE", params: params)

To see how Engagement Messenger works in the mobile application, developers can refer to the SampleApp Project that is available with <a href="https://store.servicenow.com/sn_appstore_store.do#!/store/application/1539a1f087ea3014970e2178cebb3564/2.0.0?referer=%2Fstore%2Fsearch%3Flistingtype%3Dallintegrations%25253Bancillary_app%25253Bcertified_apps%25253Bcontent%25253Bindustry_solution%25253Boem%25253Butility%25253Btemplate%25253Bgenerative_ai%25253Bsnow_solution%26q%3DMobile%2520SDK%2520Libraries%2520-%2520iOS&sl=sh" target="_blank" rel="noopener noreferrer">Mobile SDK Libraries as SampleApp.zip and check how Engagement Messenger is implemented and configured in the Sample App.