Configuring Zoho Desk for JIRA
The JIRA integration allows your customer support team and the product team to work together for greater productivity. Your agents can submit tickets as issues in Zoho Desk, while engineers can manage its R&D in JIRA. For example, an issue filed in a Zoho Desk Department gets added to its mapped project in JIRA. The comments and status updates are synced both-way in real-time.
The integration supports both on-premise and on-demand (cloud) versions of JIRA. If you're using the on-demand version, please keep in mind that your JIRA URL should be accessible to the help desk server.
Note
- The Atlassian JIRA integration is available only for the paid editions.
Benefits
- Provides a clear view of the life cycle of tickets regardless of whether part of it is managed in Zoho Desk or JIRA.
- Map your departments in Zoho Desk to one or more JIRA projects. This allows you to file issues under related projects in JIRA quickly.
- Agents and engineers can collaborate over comments. They can ask questions, suggest ideas, or report concerns that will assist in fixing an issue or closing a ticket.
- Keep your agents informed about their issue's progress. They will receive notifications every time someone updates the status or leaves a comment in JIRA.
- View JIRA issue details like assignee, status, etc., from inside a ticket.
Configuration Overview
Setting up JIRA integration involves the following five steps:
- Generate a Public Key in Zoho Desk.
- Create an Application Link in JIRA.
- Add a Custom Field in JIRA.
- Complete the Authentication in Zoho Desk.
- Customize the Sync Actions and Department-to-Project Mapping.
STEP 1: Generating a Public Key
The first step in setting up the integration is to generate a public key in Zoho Desk.
To generate a public key:
- Log in to Zoho Desk with Administrator privileges.
- Click the Setup icon (
) > Integrations > Others.
- Click JIRA on the Others page.
- Select your Version of JIRA on the JIRA Integration page.
You can choose between Cloud and On-premise. - Enter your JIRA Portal URL (without the https:// prefix).
Note: The URL for on-premise variants should be configured with HTTPS and exposed to the internet. - Click Generate Public Key.
STEP 2: Creating an Application Link in JIRA
The second step is to create the application link in your JIRA application. The application link authorizes your JIRA instance with your Zoho Desk account. Without the application link, you cannot make a connection to Zoho Desk.
To create an application link:
- Log in to JIRA as a user with Administrator permissions.
- Click Jira settings in the left side panel, then click Products.
- Next, click on Application links, under Integrations.
- On the Configure Application Links screen, enter your Zoho Desk URL (i.e., https://desk.zoho.com/).
- When you're done, click Create new link.
- Next, you may receive a message that says no response was received from the URL you entered. Don't be alarmed, this is actually OK. Ignore this message and click Continue.
- On the Link applications window, do the following:
- Enter "Zoho Desk" as the Application Name, and choose Generic Application.
- Check the Create incoming link option.
Note: You do not need to fill in the other fields. - Click Continue.
- The Link Applications window will reappear, this time asking for more information. Also refer to JIRA REST API documentation
- Enter the Consumer Key, Consumer Name, Public Key, Request token URL, Authorization URL, Access token URL, OAuth signing type, and Consumer Key displayed on completing Step 1 in Zoho Desk.
- Click Continue.
If the configuration is successful, you should be able to see the application link successfully created.
STEP 3: Adding a Custom Field in JIRA
You must add a custom field to view the details of your Zoho Desk tickets in JIRA. The field displays a link to the corresponding Zoho Desk ticket which can be accessed by your engineers on JIRA. You may skip this step if you don't want your engineers to view the linked Zoho Desk tickets on JIRA.
To create a custom field in JIRA:
- Log in to JIRA as a user with Administrator permissions.
- Click the Administration icon (
) and then click Issues.
- From the left-side menu, select Custom Fields.
- Click Add Custom Field.
- Select Text Field (Multi-line) on the Field Type window and click Next.
- Enter "Zoho Desk Ticket" as the Field Name and click Create.
- Now, you must associate the custom field to the screens in JIRA.
Select all the check boxes alongside the screens and click Update.
Tip: You can select only the screens of those projects you map with Zoho Desk.
You are now ready to view the URL of your linked Zoho Desk tickets in JIRA.
STEP 4: Completing the Authentication in Zoho Desk
Back in Zoho Desk, you must complete the authentication to be able to file issues. During authentication, Zoho Desk issues an OAuth access token to establish a trusted communication link with JIRA. We recommend that you stay signed in to your JIRA account during authentication.
Note:
- Do not proceed with authentication until you have created an application link in JIRA (see, Step 2).
To complete the authentication:
- Go to Setup > Integrations > Others.
- Click JIRA on the Others page.
- Click Authenticate on the JIRA Integration page.
Note: Log in to JIRA if you have not already done so. - You will be prompted with a Request for Access message.
Alert: Make sure the pop-up blocker on your browser is turned off to receive this prompt.
Click Allow to grant access to your JIRA data.
You have now completed the integration of Zoho Desk with JIRA.
STEP 5: Customizing Sync Actions and Mapping
The sync actions and mappings are auto-configured when you complete the integration in Zoho Desk. Typically, all sync actions will come enabled, and your departments are mapped out with JIRA projects on a many-to-many relationship. Nevertheless, you can customize how you want your sync updates to work or the project you wish to create issues in.
To customize the sync actions:
- Click the Configure Sync Actions tab on the JIRA Integration page.
- Click the toggle corresponding to a sync action to enable or disable it.
Your actions will be saved instantaneously.
To customize the mapping:
- Click the Map Zoho Desk Departments with JIRA Projects tab on the JIRA Integration page.
- Click the toggle corresponding to a department to enable or disable it for filing issues.
- Under the JIRA Projects column, you can choose to file issues in all JIRA projects or only the specified projects from the drop-down menu.
To customize the mapping, do one of the following:
(OR)) alongside the drop-down menu.
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Zoho DataPrep Resources
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Configuring Zoho BugTracker Integration
Efficient issue management is the key to the success of any engineering team. In fact, your customers expect a lot from the software you develop, and they provide the best possible feedback. Unless the bugs (read feedback) are resolved and managed ...Filing Tickets as Bugs - Zoho BugTracker
Zoho Desk agents can submit tickets as new bugs. When you file a bug, it gets routed to the associated project in the Zoho BugTracker. The bugs can then be worked upon by your engineers in the Zoho BugTracker portal. To file a bug: Go to the ...Filing Tickets as Issues - JIRA
On most occasions, you will lose track of the issues once customers raise them. But not anymore when you integrate the JIRA app into Zoho Desk. As an agent, you can submit tickets as JIRA issues from inside Zoho Desk tickets. Once created, you can ...FAQs: Zoho Desk integration with Zoho CRM
What is Zoho Desk? A company is customer-centric if it can provide timely and efficient customer support. To provide support, they need help desk software using which support agents can resolve customers' problems. The help desk software ensures that ...Setting up Zoho Projects Integration
Encourage collaboration between your customer support and product teams by integrating with Zoho Projects. The integration enables you to automatically create tasks and submit issues in Zoho Projects from inside support tickets. For example, if your ...
New to Zoho LandingPage?
Zoho LandingPage Resources