This article describes the features and configuration for the integration with Bomgar Remote Support.

Overview

Analysts and end users can launch a Bomgar Remote Support session from a ticket in Cloud Intelligent Service Management. This allows interaction through secure chat and screen sharing between analysts and end users. This integration helps reduce time to resolution and improve customer satisfaction by seeing the customer issue and even taking control to resolve the issue.

Integration Points:

• From a ticket in Cloud in Intelligent Service Management an analyst can trigger an email to the requester and launch a Bomgar Remote Support chat session. The requester will receive an email with a link to download the Bomgar Remote Support client and begin the secure chat session with the analyst and optionally allow the analyst to take control of their machine.

• Self-service users can initiate a chat session with the Service Desk directly from a ticket in self-service. They will be added to the chat queue and any available analyst can take the request and begin the chat and screen sharing session.

• Upon completion of the remote support session, the Bomgar remote support client is automatically deleted from the user's machine and a full log of the chat interaction and a video recording (.mp4 file) of the screen sharing session are linked to the activity history of the ticket.

Configuration

The Bomgar Remote Support integration requires configuration within the Bomgar portal as well as within Intelligent Service Management.

Bomgar Portal Integration Setup

Step 1

Login with admin credentials to the Bomgar portal and click on MANAGEMENT and then on API CONFIGURATION

Image RemovedImage Added

Step 2

Once Clicked Next go to API :: Configuration section and enable the following options as shown in following screenshot.:

• Enable XML API
• Enable Real-time State API
• Enable Archive API

Step 3

In On the same screen in , go to the section API :: Accounts and click on create new API AccountsAccount

Step 4

Once clicked On the following screen will appear. Perform perform the following actions:

1. Provide Enter the Name of the account
2. Give full permission to command APIGive
3. Select all check boxes under Reporting API to give full permission to reporting API

 Image Removed

1. Copy the OAuth Client ID and OAuth Client Secret field values to a text

...

Step 5

...

1. file for later use. These values are used in the Serviceaide Intelligent Service Management Integrations module.

2. Add the account.

 Image Added

Step 5

On the API :: Configuration page go to the API :: Custom Fields section and click Create New Field as shown in screen below:

Image RemovedImage Added 

Step 6

Create a new custom field with the following values:
a.

1. Display Name as ticketId

...

1. Code Name as ticketid (Make sure in the code name ticketid should be all lower case)

...

1. Check the checkbox

...

1. for Show in Rep Console

...

1. .
2. Click on Save Changes

Step 7

On the top menu click on MANAGEMENT and then click on OUTBOUND EVENTS

Once the screen renders then in Navigate to the section “Outbound Events :: HTTP Recipients” and click on Add new HTTP Recipient.

...

Add a new recipient, with the following details

1. Name: <name of event> Enter any name for the event, you could use CSM_Session_Response as an example.
2. URL: https:// <csm url>/NimsoftServiceDesk/servicedesk/odata/integrationListener?slice=<slice>&$format=JSON
   Need to provide the values of token <csmurl> and <slice> in above url.
3. Check on event Support Session End and provide reentry
4. Provide Retry intervals as shown below

   Image Removed

   ...

   1. 1. Retry Interval: Every 1 Minute
      2. Retry Duration: After 2 Minutes
   2. Save Changes

   Image Added

   
   

   Step 9

   Next you need to create a user account for every Intelligent Service Management user that will also be using Bomgar. For example if you have 10 analysts that will be taking chat requests, you need to create all 10 of them in Bomgar.

   Click on USERS & SECURITY and then click on then Create New User

   
   

    

   Step 10

   Once the create new screen appears provide the following details:

   1. Username: <user name>
   2. Private display Name: <This must be match the user name of the “Service Aide CSM agent” Username of the Intelligent Service Management Analyst, otherwise there will be an error in BOMGAR session sharing scenarios>
   3. Public display name: <public display name in Bomgar>

   Image RemovedImage Added

    

   
   

   The configuration from the Bomgar portal side is now complete.

   
   

   Intelligent Service Management Portal Integration Setup

   Step 1

   Login as an Administrator in Intelligent Service Management and navigate to MENU > MANAGE > Tools.

   Step 2

   Scroll down to locate the Integrations workspace from the Tools list or use the  search bar on to search for “Integrations”. Open the Integrations Workspace.

   Step 3

   Select Bomgar from the list of integrations. Provide the following values for the integration:

   1. domainURL: This will be the URL of the bomgar portal e.g. https://<DEMOORG>.bomgar.com

   2. OAuthToken: The value of this field will can be obtained from Step 4 of Bomgar Portal Integration.
      The OAuthToken value is combination of OAuth Client ID and OAuth Client Secret to be provided together separated by a colon(:) for example: 

      Code Block
      title Example
      OAuth Client ID:OAuth Client Secret b8696ab9d2asfdasfasfdasdfasdfasf:asdfqrasdfqasdfSDEDSfsd2134SDSsds

      
      

   Step 4

   Once you have the domainURL and OAuthToken populated you can test the integration.

   If the Intelligent Service Management properly authenticates to Bomgar, you will receive a message "Authentication Successful".

   If the authentication attempt fails you will receive a message of "Failed to Authenticate". If this happens validate your DomainURL and the format of your OAuthToken. Refer back to Step 4 of the Bomgar Portal Integration Setup.

   Once done you can make this integration active by clicking on the Active slider on the top and test the integration with “Test Integration” Button.

   Integration Use Cases

   Agent initiates a session with the requester of a ticket

   Step 1

   Login to Intelligent Service Management as a user who has the Bomgar Remote Support integration configured for their Intelligent Service Management username. See step 9 and 10 under the Bomgar Portal configuration above.

   Open a ticket.

   If the Bomgar integration is active, a button at the bottom of ticket summary section will appear.

   Image Added

   
   

   Step 2

   Click the "Start Bomgar Session with client" button

   If you are not logged in, a message will notify you that you need to login to the Bomgar client.

   Image Added

   
   

   When you are properly logged into the Bomgar representative console, an email notification will be sent to the Requester of the ticket with a link to open a secure chat session directly with the agent.

   Image Added

   Image Added

   Step 3

   The email sent to the requester of the ticket will have the subject "Request for BOMGAR session" and will have a URL to download the Bomgar Client.

   By clicking on the URL an executable will be download based on the requester's operating system.

   Once the download completes, the requester needs to click on the executable to complete the installation.

   Once the Bomgar client is ready, the requester will be directly linked to the agent who sent triggered the request for the session from the ticket.

   Step 4

   Once the session completes, the details of the Bomgar session will be stored in the activity history of the ticket as worklog update. This includes links to the chat session and a video recording of the screen sharing session.

   Image Added

   
   

   Self Service Initiated Session

   Session can also be initiated by a Self-Service User with an existing ticket that wants to reach out for assistance from the Support team.

   Step 1

   The Self-Service user logs a new ticket or goes to an existing ticket in the Service Center workspace.

   If the Bomgar integration is active, a button will appear on the bottom on the ticket summary panel.
                    

   Image Added 

   
   

   Step 2

   When clicking on this button a Bomgar chat screen will appear. The user will be added to a chat queue where an agent will automatically be assigned based on the currently online Bomgar agents.

   Image Added

   
   

   This chat session can be converted to a screen sharing or remote control session based on a request from the Bomgar agent. The self-service user must accept the request before the session proceeds.

   Once the session completes, the Bomgar client software is removed from the self-service user's machine. All session details are captured and added as a worklog update in the activity history of the Intelligent Service Management ticket that this session was initiated from.