# Jira Service Management

## JSM Integration Guide for Wrangle

Jira Service Management is a service desk platform designed to help teams manage requests, incidents, and changes. Wrangle’s JSM integration lets you link your Wrangle inboxes with JSM Service Desks to create a seamless experience for ticket handling across teams who may prefer to work in different platforms.

### What you can do with JSM and Wrangle

Once connected, Wrangle and JSM can sync tickets in both directions. When you link a Wrangle inbox to a JSM project, here’s what happens:

* **Create**: New tickets created in Wrangle will also appear in JSM.
* **Update**: Updates to tickets (e.g., name, description, comments) will sync between Wrangle and JSM.

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2F8Bym3JNGys7QmmoJG8Cd%2Fjsm_chat_sync.gif?alt=media&#x26;token=12e84d8b-5327-4004-a84e-8ade496ae434" alt=""><figcaption><p>Comments syncing back and forth between JSM and Slack using Wrangle</p></figcaption></figure>

###

### How to setup a Wrangle & JSM Integration:

1. First, you will need to create a dedicated user in Atlassian for your Wrangle integration. Ask your IT admin to create a new user via <https://admin.atlassian.com> with the following details:
   1. Name: "Wrangle". **This is required.**
   2. Product Role:  Jira Service Management - User (agent).
   3. Avatar: Use this image to ensure request comments are posted clearly from Wrangle:

      <figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FmY9pmRxVuxXeKkop3HuZ%2Fwrangle.png?alt=media&#x26;token=12301c1b-2621-4699-972a-87a50f65d3ea" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The specific email address you use doesn't matter but it needs to be something you can access to confirm the account. We suggest something like <wrangle-jsm-bot@yourcompany.com>.
{% endhint %}

2. For each of the Service Desk projects you want to connect to Wrangle, ensure the **Wrangle** user you created in Step 1 [has Service Desk Team permissions](https://confluence.atlassian.com/servicemanagementserver/adding-service-project-agents-939926159.html) for each of the Service Desk projects you want to use with Wrangle.
3. Now head over to the [JSM Integrations page](https://slack.wrangle.io/integrations/jsm) in Wrangle. Click Login to JSM, and make sure you **Login as the user you just created in Step 1:**

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2F0itXNNufYUyZKckoQYDA%2Fjsm_step_1.png?alt=media&#x26;token=72a46f87-ed28-4f07-9cbb-2ced73ee6202" alt="" width="375"><figcaption></figcaption></figure>

You will be redirected to JSM, and prompted to Authorize Wrangle. Authorizing Wrangle allows Wrangle to create and update tickets and ticket comments within your account. Scroll to the bottom and click "Accept" to continue:

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FIbH0U8iaTaG0ywbhbIv9%2Fjsm_oauth.png?alt=media&#x26;token=90a746fc-c18b-4289-95ad-0b2d930e3375" alt=""><figcaption></figcaption></figure>

3. You will be redirected back to Wrangle and now you should see your Wrangle account is connected to your JSM account:

   <figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FBao7jsjSTuTXcCwZ2Z0n%2Fjsm_connected.png?alt=media&#x26;token=f4b47601-036d-4e67-b225-d366fe0fe7fa" alt="" width="375"><figcaption></figcaption></figure>
4. Now you're ready to link your Wrangle Inboxes to JSM Service Desks! Click "Add Inbox" and select the inbox and Service Desk you want to link. You'll also be asked to select a default JSM Request Type, which will be used when creating requests from Wrangle:

<figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FeD2L6JbuXNVew6otizQ2%2Flink_to_jsm.png?alt=media&#x26;token=10733ad1-49ac-41e3-b355-0bd52f2ab38b" alt="" width="375"><figcaption><p>Connecting your Wrangle Inbox to a JSM Service Desk</p></figcaption></figure>

Now, you're ready to create linked tickets. Try creating a ticket in Wrangle in your linked inbox. You'll notice that in Slack and the Web's Ticket View there's a link to JSM:\ <br>

<div><figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2F3w6Luf0umby76Fv5D8TK%2Fdd.png?alt=media&#x26;token=81f82377-199d-4f51-ae25-7e4d56445604" alt=""><figcaption><p>Link to JSM in Slack Ticket View</p></figcaption></figure> <figure><img src="https://3500333410-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8Mly5TzbK30rAk6_PN%2Fuploads%2FUQEsg9Wl8zIyWkvbiCbV%2Flinked_in_ticket_view.png?alt=media&#x26;token=9cdf411b-a815-4d99-a60b-d5bbaad1323e" alt=""><figcaption><p>Link to JSM in Web Ticket View</p></figcaption></figure></div>

When your agents in JSM reply to tickets, you'll see your replies sent back to Slack and vice versa.
