LogMeIn Rescue is a service that gives support staff remote access to users' computers to troubleshoot problems. The LogMeIn Rescue app in Zendesk lets agents start a remote session from a Zendesk ticket and then capture the session's details in the ticket afterwards. See the announcement post for more information about the integration.
To use LogMeIn Rescue with Zendesk, you must have a valid LogMeIn Rescue license or trial account.
Here's the general workflow:
- While corresponding with a end-user through a ticket or over the phone, a support agent decides to initiate a remote session with the user to troubleshoot the problem.
- From the ticket in Zendesk, the agent generates and sends a link and a PIN number to the end-user to start the remote session.
- The agent conducts the remote session with the user. The agent can view information about the Zendesk ticket in the LogMeIn interface used to conduct the session.
- When the remote session ends, details about the session are added to the Zendesk ticket.
This article provides instructions for completing the following tasks:
Configuring the LogMeIn Rescue integration
Configuring the LogMeIn Rescue integration consists of the following steps:
Defining a global single sign-on password
You need to obtain a global single sign-on (SSO) password as well as a unique company ID from LogMeIn Rescue to configure Zendesk.
- Open the LogMeIn Rescue Administrator Center.
- Under Global Settings > Single Sign-On, define a global SSO password.
- Write down both the SSO password and the unique company ID. You need both to configure Zendesk later.
Defining a single sign-on ID for each technician
For each LogMeIn Rescue technician who is a Zendesk agent and who will be using the LogMeIn app from Zendesk, do the following:
- Select the technician in the LogMeIn Rescue Administrator Center, under Organization.
- In the Technician Configuration screen, enter the technician's Zendesk email address as his or her Single Sign-On ID.
Linking LogMeIn Rescue to Zendesk
To post the details of remote sessions to Zendesk, LogMeIn Rescue must be linked to Zendesk as follows.
- In the LogMeIn Rescue Administration Center, click your Technician Group.
- In Settings > Exporting session data, enter the following URL in Post session details to URL when session is ended by technician: https://yoursubdomain.zendesk.com/api/v2/integrations/log_me_in.json
Replace yoursubdomain with your Zendesk account's subdomain.
- Click Save Changes.
- In Zendesk, click Manage () at the bottom of the sidebar and then click the Browse link under Apps.
You can install and configure the LogMeIn app in Zendesk only if you're a Zendesk administrator.
- Move your mouse over the LogMeIn Rescue app and click Install.
- Enter a Title for the app. The title appears in the Apps tray on ticket pages.
- Enter the Company ID and Single Sign-On Password you got from LogMeIn Rescue. See Define a global single sign-on password.
- If you want, click Enable public comments to post the details of remote sessions as public comments in tickets.
Session details are displayed as private comments by default.
- Enter any Tags you'd like to set on tickets with the remote sessions details.
- Select Install.
Once installed, the app appears on the right side of the ticket interface. If you don't see the app, click Refresh in the top-right corner of the Apps tray.
Using LogMeIn Rescue with Zendesk
Topics covered in this section:
Before you can use the app, you must log in to LogMeIn Rescue from a Zendesk ticket. On a ticket page, enter your LogMeIn Rescue credentials into the app. The app remembers your authorization for the current session.
If you get an error that your single sign-on ID must match your Zendesk email address, see Troubleshooting.
Launching the Technician Console
The LogMeIn Rescue Technician Console is the interface used by support technicians to conduct remote sessions with users.
To open the Technician Console from a Zendesk ticket, click Open the Technician Console link in the app. Zendesk uses your single sign-on information to launch the Console directly from the ticket.
Initiating a remote session from a ticket
When corresponding with an end-user about a problem through a ticket or over the phone, you may want to initiate a remote session with the user to troubleshoot the problem. The remote session must be started by the end-user with a link and a PIN number. You can provide the user with the information from a ticket as follows.
- Click Get a PIN in the LogMeIn Rescue app on the Zendesk ticket.
Note: To receive LogMeIn session data back on a Zendesk ticket, the PIN must be created using the LogMeIn Rescue app in Zendesk.
- Click the generated PIN number to create a ticket comment that contains both the PIN number and a link for the end-user to launch the remote session.
- Submit the ticket to email the information to the user.
Viewing ticket information during the remote session
The following Zendesk ticket data is available in the Technician Console during a remote session initiated from a Zendesk ticket:
- The name of the Zendesk ticket requester, which is listed as the session requester in LogMeIn Rescue.
- Values of ticket fields that you mapped in your Zendesk LogMeIn Rescue app configuration.
Ending a remote session
When you end a remote session initiated from a Zendesk ticket, LogMeIn Rescue posts data about the session to the ticket. You can confirm that the information was posted by reviewing the event log in the Technician Console.
Reviewing information about a remote session in a ticket
You can review details about a remote session in the ticket that initiated the session. Comments from LogMeIn Rescue are displayed as speech bubbles with the LogMeIn Rescue icon. Available details include:
- Session and technician details such as session ID, technician name, and technician e-mail address
- Session timestamps such as wait time, work time, and last action time
- Chat transcript
- Technician survey answers
Problem: The app displays the error, "Your Rescue Single Sign-On ID must match your Zendesk primary email address."
Solution: The email address on your Zendesk profile must match the single sign-on ID in your LogMeIn Rescue Technician configuration. Make sure all of the values below match:
Below are common problems you may encounter when using LogMeIn Rescue with Zendesk, and things you should try to troubleshoot them.
The app displays the error, "Your Rescue Single Sign-On ID must match your Zendesk primary email address."
The email address on your Zendesk profile must match the single sign-on ID in your LogMeIn Rescue Technician configuration. Make sure all of the values below match:
Session details were not added to the Zendesk ticket after session completion
- Make sure that your session PIN was generated from within Zendesk, from a new or existing ticket page. This is required in order for session details to post back to a ticket.
- Check the eventlog in your Rescue Technician Console. If you see an error such as: "Posting details of session <session ID> to the specified URL failed. Status code returned by server: 400", try renaming the AppData folder for LogMeIn located at C:\Users<User Name>\AppData\LocalLow\LogMeIn Rescue to LogMeIn Rescue old. Then, check to see if this resolves the issue.
- If the above did not resolve the issue, you will need to gather some logs from your machine for inspection by Zendesk Support. Go to the AppData folder mentioned above that you just renamed and collect the following:
- Failure log from the day the error occurred. This file is prefixed with "LMIRescue."
- Data folder from the session post, identified by "sessiondatapost_<session ID>."
- ZIP and attach the files to your support ticket.