YouTrack Cloud 2023.1 Help

Helpdesk

This workflow is used to automate common use cases that are relevant to a helpdesk project.

Name

@jetbrains/youtrack-workflow-helpdesk

Auto-attached

no

Rules

  • Merge duplicate tickets (on-change)

  • Merge tickets manually (action)

  • Reopen ticket when reporter adds a comment (on-change)

  • New ticket from comment (action)

  • Remind reporters and close pending tickets automatically (on-schedule)

Use Case

This workflow provides extended functionality that is relevant to helpdesk projects.

When a helpdesk agent encounters a ticket that matches a support request that was previously submitted by the same reporter, they can mark one of the tickets as a duplicate. This helps to consolidate communication in a single thread and prevent agents from providing conflicting answers. Agents can either mark the ticket as a duplicate using the Duplicates link or by using the Merge ticket manually option in the action menu for the ticket.

When an agent receives a reply from a reporter that should be handled as a separate support request, they can use the New ticket from comment action. This takes the comment text and copies it to the description field in the new ticket and prompts the agent to enter provide the summary.

When an agent has replied to a reporter in a ticket, they can move it to a Pending state to pause the SLA timer. This state indicates that the agent is waiting for the reporter to answer a question or confirm the action taken.

  • If the reporter doesn't reply within a specified timeframe, a reminder is sent to the reporter.

  • If the agent doesn't hear back from the reporter after a certain amount of time, the ticket is closed automatically. An additional message is sent to the reporter to inform them that the ticket was closed.

When a reporter adds a comment to a ticket that is set as Pending, it is reopened automatically. This helps to ensure that the resolution time is tracked according to the active SLA policy.

Modules

This workflow supports the following rules:

Title

Description

Merge duplicate tickets

When a ticket is marked as a duplicate of another ticket, this on-change rule checks whether both tickets were reported by the same user.

  • If the tickets were reported by different people, an error message is shown to the agent and the operation is reverted.

  • When the same person reported both tickets, a public comment is posted in the ticket that is marked as a duplicate. The comment includes a link to the currently active ticket.

Merge tickets manually

This action rule lets an agent merge duplicate tickets using the merge with command. When an agent specifies this command, they are prompted to provide the ID of the ticket that want to merge with.

This action then applies the Duplicates link to the current ticket, which triggers the Merge duplicate tickets workflow rule described above.

Reopen ticket when reporter adds a comment

This on-change rule automatically changes the value for the State field from Pending to Open whenever a comment is added by the reporter.

New ticket from comment

This action rule lets agents use the text from a comment in a ticket as the basis for reporting another ticket in the helpdesk project. The agent is prompted to provide a summary for the new ticket.

When this action is applied, a comment that references the new ticket is posted in the original ticket. A comment that contains a link to the original comment is also added to the new ticket.

Remind reporters and close pending tickets automatically

This on-schedule rule checks for tickets where the value for the State field are Pending.

  • If the ticket has been pending for more than 7 days, a reminder is sent to the reporter.

  • A second reminder is sent after 14 days.

  • If the ticket is still pending after 21 days, a comment is posted to the ticket and its state is set as Solved.

Last modified: 31 March 2023