# Managing Intercom conversation links

{% hint style="info" %}
**This feature is also available in the Intercom Inbox app**

This page explains how to create and remove a link to an Intercom conversation from the Jira work item view. If you wish to do these actions directly from Intercom, have a look at the [docs for the Intercom companion app](https://docs.toolsplus.io/intercom/jira-cloud-for-intercom/guides/intercom-teammates/linking-existing-jira-issues).
{% endhint %}

## Creating a link <a href="#creating-a-link" id="creating-a-link"></a>

To associate an Intercom conversation with a Jira work item, you have to know the URL to the Intercom conversation that you would like to link.

Open Intercom, select the conversation in your Inbox, and copy the URL from your browser's address bar.

<figure><img src="https://3976155500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGUXywqOAgHcx2c0YGM%2Fuploads%2F3kc03MsF5ZMmnj84OBWQ%2Fimage.png?alt=media&#x26;token=a0175b15-6a20-4d43-a25f-be9fe68e89e7" alt=""><figcaption></figcaption></figure>

Then, create a new Jira work item or open an existing one.

With the work item open, click on the **Intercom: Linked conversations (1)** context panel in the right-side column of the work item view.

<figure><img src="https://3976155500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGUXywqOAgHcx2c0YGM%2Fuploads%2FdfGrzTcyoWQSyhoQhZcd%2FLink%20conversation%20-%20start.jpg?alt=media&#x26;token=d62a7973-e743-4777-96ff-ce2378d69430" alt=""><figcaption></figcaption></figure>

In the context panel, click on the **link icon button (1)** and then **paste the conversation URL (2)** into the input field, then click **Link (3)**.

<figure><img src="https://3976155500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGUXywqOAgHcx2c0YGM%2Fuploads%2FHkfXpILcdYX0CCcC60Rb%2FLink%20conversation%20-%20paste%20URL.jpg?alt=media&#x26;token=8ef0f920-62f8-4807-b7fe-3ee19366e44d" alt=""><figcaption></figcaption></figure>

Your conversation is now linked, and you can find a note with the work item reference posted to the Intercom conversation. Refer to the [documentation on inspecting linked Intercom conversations](https://docs.toolsplus.io/atlassian-cloud/intercom-for-jira/guides/jira-users/inspecting-linked-intercom-conversations) for details on browsing conversation details.

## Removing a link <a href="#removing-a-link" id="removing-a-link"></a>

On the Jira work item view, click the **Intercom: Linked conversations (1)** context panel in the right-side column. This will open the panel and show all linked Intercom conversations.

<figure><img src="https://3976155500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGUXywqOAgHcx2c0YGM%2Fuploads%2FPgUTV2DQvXbzoIQo6DGP%2FLink%20conversation%20-%20start.jpg?alt=media&#x26;token=a37f223a-12c4-4259-8d2c-5ccd9d788bb4" alt=""><figcaption></figcaption></figure>

Find the conversation that you would like to unlink, then click the **context menu button ⋯** on that conversation and select **Unlink (1)**.

<figure><img src="https://3976155500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGUXywqOAgHcx2c0YGM%2Fuploads%2FF5DlMclv9zwE0SzqW9GJ%2Ftoolsplus-production.atlassian.net_browse_ENG-47%20(3)%201.png?alt=media&#x26;token=540930a0-99d6-48e8-8c62-40d3d848f1ea" alt=""><figcaption></figcaption></figure>

## Linking and unlinking in the Jira Service Management request view

If your [Jira administrator has enabled conversation linking on the Jira Service Management request view](https://docs.toolsplus.io/atlassian-cloud/intercom-for-jira/jira-administrators/managing-app-features#enable-jira-service-management-support), then JSM users with access to the request portal can link and unlink Intercom conversations on JSM requests they have access to.

In the request view, JSM users can link a conversation by clicking on the **link icon button (1),** **pasting an Intercom conversation URL (2)**, and then clicking **Link (3)**.

If one or more conversations are associated with a request, the app will render a **card for each linked Intercom conversation (4)**. Users can then **open linked conversations in Intercom (5)** or **unlink (6)** using the action menu on the card.

![](https://3976155500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LGUXywqOAgHcx2c0YGM%2Fuploads%2FAj5iTAXaBhcg6Hh9SOCW%2FEnable%20JSD%20support%20-%20request%20portal.jpg?alt=media\&token=bb071bec-a60e-45e3-96ce-135d58581434)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolsplus.io/atlassian-cloud/intercom-for-jira/guides/jira-users/managing-intercom-conversation-links.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
