Links
Comment on page

Searching and reporting

As you link more and more Intercom conversations to Jira issues it becomes more and more important to be able to search and report on those links. Maybe you would like to understand which Jira issues have the most links such that you can prioritize your work. Or, you want to find issues that are linked to a specific Intercom conversation.
Intercom for Jira provides a Jira Query Language (JQL) integration that allows you to search, filter, and report issues based on linked Intercom conversation ids or the number of linked Intercom conversations.
Follow the steps in the Jira documentation on how to open advanced search. After that, paste any of the following example queries into the query editor.

Finding issues by Intercom conversation id

You can find Jira issues linked to one or more Intercom conversation ids by using the linkedIntercomConversationId field.
Different query syntax between Jira 7.x and 8.x
Due to a change in Jira's internals between Jira 7.x and 8.x you will have to use a different JQL syntax to query linkedIntercomConversationId in Jira 7.x to 8.x.
Jira 7.x
Jira 8.x

Field Properties

Syntax
linkedIntercomConversationId
Field Type
STRING
Auto-complete
Yes
Supported operators
= , != , IS , IS NOT, IN , NOT IN

Examples

Find all Jira issues linked to Intercom conversation with id 42
linkedIntercomConversationId = 42
Find all Jira issues linked to Intercom conversation with id 42, 43 or 44
linkedIntercomConversationId IN (42, 43, 44)
Find all Jira issues that have no Intercom conversation links
linkedIntercomConversationId = EMPTY

Field Properties

Syntax
linkedIntercomConversationId
Field Type
TEXT
Auto-complete
No
Supported operators
~ , !~ , IS , IS NOT

Examples

Find all Jira issues linked to Intercom conversation with id 42
linkedIntercomConversationId ~ 42
Find all Jira issues linked to Intercom conversation with id 42 or 43
linkedIntercomConversationId ~ 42 OR
linkedIntercomConversationId ~ 43
Find all Jira issues linked to Intercom conversation with id 42 and 43
linkedIntercomConversationId ~ "42 43"
Find all Jira issues that have no Intercom conversation links
linkedIntercomConversationId IS EMPTY

Finding issues by the number of linked conversations

This JQL field allows you to find Jira issues based on the number of Intercom conversations linked to an issue.

Field Properties

Syntax
linkedIntercomConversationCount
Field Type
NUMBER
Auto-complete
No
Supported operators
= , != , < , <= , > , >= , IS , IS NOT, IN , NOT IN

Examples

Find all Jira issues with more than 5 Intercom conversation links
linkedIntercomConversationCount > 5

Creating more complex queries

You can further refine the query examples shown above by combining them with standard JQL query features.

Examples

List all Jira issues of project ENG ordered by the number of linked Intercom conversations
project = ENG ORDER BY linkedIntercomConversationCount DESC
Find all Jira issues of project ENG that are linked to Intercom conversation with id 42
Jira 7.x
Jira 8.x
project = ENG AND linkedIntercomConversationId = 42
project = ENG AND linkedIntercomConversationId ~ 42
Find all Jira issues of project ENG that are resolved and have linked Intercom conversations
project = ENG AND linkedIntercomConversationId IS NOT EMPTY