Add Zoho Sprints app
- Sign in to Zoho Desk.
- Choose Settings in the upper-right corner.
- Select Marketplace.
- Choose Zoho Sprints in All category.
- Select Profiles and Agents.
- Enable the consent.
- Click Install.
- Authorize the Zoho Desk account for the Zoho Oauth service to activate the extension. Upon authorization, you will view a pop-up from Zoho Sprints to enable access to transfer data between both the applications.
- Click Accept.
Now, you have to Authorize the Zoho Desk account for the Zoho Oauth service to activate the extension. Upon authorization, you will view a pop-up from Zoho Sprints to enable access to transfer data between both the applications.
Map departments to projects
You can now map the departments in your Zoho Desk to the projects in Zoho Sprints.
- Choose Preference.
- Select your Zoho Sprints workspace.
- Select required projects for the respective Zoho Desk department.
- Click Save.
This integration will help you do the following:
- Add tickets in Zoho Desk and link it as work items in Zoho Sprints.
- View the ticket details in Zoho Sprints.
- Manage comments and attachments from both the applications.
Teams for which you're an owner will only be listed here.
Add tickets as work items from Zoho Desk
- Create a new ticket in Zoho Desk.
- Open the ticket details.
- Click Marketplace app icon in the right corner.
- Fill in the required details under Zoho Sprints application.
- Choose the Project.
- Enter the Item Name.
- Type a Description.
- Choose the Item Type and Priority.
- Click Add.
View tickets added as work items in Zoho Sprints
- Sign in to Zoho Sprints.
- Choose the project that you have mapped with the Zoho Desk.
- Go to detail view of the required work item.
- Select Zoho Desk icon in the right panel.
- View the ticket details.
- Click View in Zoho Desk to view the ticket in the Zoho Desk platform.
If you want to navigate to the work item details page from Zoho Desk directly, you can click the Issue ID after adding the ticket.
- You can add conversations to your tickets in Zoho Desk and view them under the Comments section in the respective work item details page.
- If you want to add comments to the tickets directly from Zoho Sprints, add a quick comment. It will be reflected in the conversation section in Zoho Desk.
- You will receive a feed notification in Zoho Sprints when you add or update a comment for the work item in Zoho Desk. You can also view the modifications in the comments added in the activity stream.
Note: We will announce comments added via Zoho Desk in the comments section in Zoho Sprints Manage attachments
You can add attachments to tickets in Zoho Desk or work items in Zoho Sprints. Attachments can be viewed and accessed from both the applications.
Note: We will notify the attachments added via Zoho Desk in the comments section in Zoho Sprints. Delink tickets
If you want to delink tickets added as work items, you can directly click the Delink button at the bottom of the pop-up.
Note: The items will be delinked if the Zoho Sprints extension is removed in the marketplace.
Once you delink the ticket, you can view the respective ticket added as work item in Zoho Sprints. But, you cannot view the ticket details in Zoho Sprints. You can see only the label pointing that the work item is added via Zoho Desk. To link the ticket back again, you need to add the ticket as a new work item. This will be created with a new issue ID.
- When you delete a ticket, the corresponding work item that is linked to the ticket will automatically be delinked.
- When the work item is delinked from Zoho Desk, it is pushed to the activity stream in Zoho Sprints.
Errors and troubleshoot
Case 1: "Looks like you have delinked the work item from Zoho Desk"
When you delink the ticket added as work item in Zoho Desk, you cannot access the ticket details from Zoho Sprints. Instead, you can see a Zoho Desk label tagged next to the work item name. This indicates that the work item is added via Zoho Desk.
Troubleshoot: You have to add the ticket as a work item in Zoho Desk. The corresponding ticket will be added as a new work item in Zoho Sprints. The previous work item will just indicate that the work item is added via Zoho Desk.
Case 2: "You don't have permission to view the ticket details."
The assignee of the ticket should be a user in Zoho Sprints. If the user is not a part of any one of the applications, then the user cannot access the ticket details from Zoho Sprints.
Troubleshoot: Make sure that the user is added in both the applications. Remove integration
You can disable the integration only from Zoho Desk.
- Navigate to Settings in Zoho Desk.
- Select All in Marketplace.
- Choose Installed Extensions. This will list all the extensions installed in Zoho Desk.
- Select Zoho Sprints from the list of installed extensions.
- Click in the upper-right corner.
- Select Uninstall Extension.
Once you uninstall the extension, all the mapped work items will be delinked in Zoho Sprints. You cannot retain the mapping once you install the extension back in Zoho Desk. You have to link it again.