Yandex Cloud
  • Services
  • Solutions
  • Why Yandex Cloud
  • Pricing
  • Documentation
  • Contact us
Get started
Language / Region
© 2022 Yandex.Cloud LLC
Yandex Tracker
  • Getting started
    • Activating Yandex Tracker
    • Logging in to Yandex Tracker
    • Adding users
    • Configuring access to Yandex Tracker
    • Setting up Yandex Tracker
    • Working with Yandex Tracker
      • Home page
      • My issues
      • Working with issues
      • Favorite issues, boards, and dashboards
      • Personal settings
    • Migrating to Yandex Tracker
    • Disabling paid services
  • Yandex Tracker mobile app
  • Practical guides
    • Setting up Yandex Tracker for a development team
      • Overview
      • Creating a queue for a development team
      • Structuring issues
      • Using Agile methodologies
      • Configuring issue templates
      • Connecting repositories
      • Automating recurring actions
      • Integrating Yandex Tracker with other platforms
    • Setting up Yandex Tracker for a support team
      • Overview
      • Creating a queue for the support team
      • Accepting requests by mail and via forms
      • Configuring multi-tiered support
      • Sending emails from the issue page
      • Grouping requests by topic
      • Tracking the time it takes to process a request
      • Collecting requests statistics
      • Configuring integration with third-party platforms
  • Concepts
    • Service overview
    • Concepts
    • Roles and access rights
  • Configuring queues
    • Overview
    • Creating a queue
    • Queue templates
    • Viewing issues in a queue
    • Changing basic queue settings
    • Configuring issue types and statuses
      • Overview
      • Configuring issue types
      • Create a workflow
      • Setting up statuses
      • Configuring transitions
      • Configuring resolutions
    • Local issue fields
    • Adding a queue team
    • Setting access rights for queues
    • Advanced queue features
    • Viewing the history of queue changes
    • Deleting a queue
  • Working with issues
    • Creating an issue
      • Overview
      • Creating an issue via email
      • Creating an issue from a form
      • Cloning an issue
    • Editing an issue
      • Overview
      • Adding comments to issues
      • Creating a checklist
      • Editing issue links
      • Attaching images and files to an issue
      • Formatting text in issues
      • Executing macros
      • Voting for an issue
      • Moving an issue to another queue
      • Changing multiple issues
    • Setting up an issue reminder
    • Specifying time spent
    • Adding issue fields
    • Viewing the history of issue changes
    • Getting access to an issue
    • Deleting an issue
  • Structuring issues
    • Overview
    • Links between issues
    • Projects
    • Components
    • Versions
  • Projects (beta)
    • Overview
    • Create a project
    • List of project issues
    • Gantt charts
  • Agile development tools
    • Overview
    • Creating a board
    • Working with an agile board
    • Editing and deleting a board
    • Sprints
    • Epics
    • Collaborative workload estimation
    • Burn down chart
  • Issue boards (beta)
    • Overview
    • Creating a board
    • Working with an agile board
    • Configuring boards
  • Searching for issues
    • Searching for issues by key or name
    • Searching for my issues
    • Searching for issues in queues
    • Creating an issue filter
    • Query language
  • Notifications and subscriptions
    • Overview
    • Subscribing to notifications
    • Receiving update reports
    • Subscribing other users to queue updates
    • Notification settings
      • Overview
      • Notifications about your issues
      • Notifications about your subscriptions
  • Statistics and dashboards
    • Dashboards
      • Overview
      • Creating a dashboard
      • Widgets
      • Editing a dashboard
      • Shared access to dashboards
      • Making a dashboard your home page
    • Queue statistics
    • Gantt charts
  • Automation and templates
    • Overview
    • Triggers
      • Overview
      • Creating a trigger
      • Setting trigger conditions
      • Configuring trigger actions
      • Editing and deleting triggers
      • Examples
    • Auto actions
      • Overview
      • Automatic issue updates
      • Scheduled issue creation
      • Editing or deleting auto actions
    • Macros
    • Templates
      • Overview
      • Creating a template in Yandex Forms (beta)
      • Creating a template
      • Editing a template
      • Deleting a template
      • Using shared templates
    • Variables
    • Using a form as a template for creating issues
  • Configuring an SLA for issues
    • Overview
    • Configuring rules
    • Work schedules
  • Integration with other services
    • Mail
    • Yandex Forms
    • Yandex Wiki
    • Messengers
      • Overview
      • Slack
      • Telegram
    • Setting up links to external applications
      • Overview
      • Setting up an external application
      • Sending your application data to the Tracker team
  • Developer tools
    • Plugin for IDE
    • API
    • Python client
    • Connecting repositories
  • Pricing
    • Pricing
    • Setting up a billing account
    • Topping up your personal account
    • Viewing service detalization
  • API reference
    • Overview
    • API access
    • General query format
    • Issues
      • Get issue parameters
      • Edit an issue
      • Create an issue
      • Moving an issue to another queue
      • Find out the number of issues
      • Search for issues
      • Release scroll view resources
      • Get priorities
      • Get transitions
      • Make a status transition
      • Get the history of issue changes
      • Issue links
        • Link issues
        • Get issue links
        • Remove issue links
    • Checklists
      • Create a checklist or add items to it
      • Get checklist parameters
      • Edit a checklist
      • Delete a checklist
    • Projects
      • Create a project
      • Get project parameters
      • Get a list of all projects
      • Get a list of project queues
      • Edit a project
      • Delete a project
    • Comments
      • Add comment
      • Get issue comments
      • Edit a comment
      • Delete a comment
    • Macros
      • Get queue macros
      • Get a macro
      • Create a macro
      • Edit a macro
      • Delete a macro
    • External links
      • Get a list of external applications
      • Get a list of issue external links
      • Add an external link
      • Delete an external link
    • Attached files
      • Get a list of attached files
      • Download a file
      • Download a thumbnail
      • Attach a file
      • Upload a temporary file
      • Delete a file
    • Queues
      • Create a queue
      • Get queue parameters
      • Get a list of queues
      • Get queue versions
      • Get required fields for the queue
      • Delete a queue
      • Restore a queue
      • Remove a tag from a queue
      • Automation
        • Auto actions
          • Create an auto action
          • Get auto action parameters
        • Triggers
          • Creating a trigger
          • Get trigger parameters
    • Issue boards
      • Get parameters of all boards
      • Get board parameters
      • Create a board
      • Edit a board
      • Delete a board
      • Columns
        • Get parameters of all columns
        • Get column parameters
        • Create a column
        • Edit a column
        • Delete a column
      • Sprints
        • Get all sprints of a board
        • Get a sprint
        • Create a sprint
    • Components
      • Get a list of components
    • Import
      • Import an issue
      • Import files
      • Import comments
      • Import links
    • Bulk operations
      • Perform a bulk move of issues to a different queue
      • Bulk changes to issues
      • Make bulk changes to issue statuses
    • Time tracking
      • Add a record of time spent
      • Edit a record of time spent
      • Delete a record of time spent
      • Get records of time spent
        • Get all records for an issue
        • Select records by parameters
    • Issue fields
      • Get global issue fields
      • Create an issue field
      • Get issue field parameters
      • Edit issue field names
      • Edit possible values of issue fields
      • Create an issue field category
      • Local fields
        • Create a local queue field
        • Get local queue fields
        • Get information about a local queue field
        • Edit a local queue field
    • Get information about the current user
    • Possible response codes
  • FAQ
    • General questions
    • Payments
  • Support
  1. Automation and templates
  2. Triggers
  3. Examples

Examples

Written by
Yandex Cloud
  • Picking assignees automatically
  • Inviting assignees automatically
  • Changing an issue's status after creating a link
  • Sending a notification when an issue is created from an email
  • Sending a notification when an issue is created based on a form
  • Automatically adding a form to the issue comments
  • Automatically adding issues to the board
  • Sending notifications to instant messengers

Let's look at some examples of how triggers work in Tracker:

  • How to automatically pick assignees based on their status or component.

  • How to automatically invite assignees based on the status or field value.

  • How to automatically change an issue's status after adding a certain type of link to it.

  • How to automatically notify a user after an issue was created based on a request sent to the support team via email.

  • How to automatically notify a user after an issue was created based on a request sent to the support team via Yandex Forms.

  • How to automatically add a form to the issue comment.

  • How to automatically add issues to the board.

  • How to set up notifications in messengers via HTTP requests.

Picking assignees automatically

Different stages of a project are often handled by different employees. When an employee does their part, they transfer the issue to another assignee. In Tracker, each issue stage has its own status. When an issue receives a status update, a new employee can be automatically assigned to work on the issue with a trigger.

However, sometimes employees only handle issues related to their field of expertise and don't collaborate on a single issue. For example, each support team member only processes requests related to the product they were assigned to. To manage this kind of workflow, you can configure components so that they correspond to specific products. When a specific component is added to the issue, the employee responsible for the corresponding product is automatically assigned to work on it via a trigger.

Let's set up a trigger that automatically picks an assignee for our issue:

  1. Make sure every employee you might want to assign has full access to Tracker.

  2. Go to the queue settings, open the Triggers section, and click Create trigger.

  3. Enter the trigger name.

  4. Set the trigger to fire when the issue's Status or Components change:

    1. Choose Conditions to be met → All.

    2. Add the condition Event type → Issue changed.

    3. If you want a new assignee to be picked after a status update, add the following condition: System → Status → Field value became equal to and specify the status. The available statuses depend on the workflow set up for the queue.

      If you want a new assignee to be picked after a component changes, add the following condition: System → Components → Field value became equal to and specify the components.

      Note

      This trigger only works if only one component is specified in the issue.

  5. Set a trigger action:

    1. Add the action Update fields.

    2. Choose System → Assignee → Set value and specify who should be picked as the assignee after the trigger is fired.

  6. Save your trigger.
    To see if you trigger works, pick any issue from the queue with the added trigger and change the issue's status or components.

Inviting assignees automatically

After completing an issue, the assignee may forget to specify some important information, such as time spent. In this case, you can configure a trigger that will automatically invite the assignee if the issue is closed and the time spent is not specified:

  1. Go to the queue settings, open the Triggers section, and click Create trigger.

  2. Enter the trigger name.

  3. Set the trigger to react when the issue is closed with the Time spent field being empty:

    1. Choose Conditions to be met → All.

    2. Add the condition System → Status → Field value became equal to → Closed. The available statuses depend on the workflow set up for the queue.

    3. Add the condition Time Spent → Time spent → Field value is empty.

  4. Set trigger actions:

    1. Add the Add comment action.

    2. Tap , find the line Invite users from a field, and enter Assignee.

    3. Enter the comment to be displayed to the assignee and choose Send as robot.

  5. Click Create to save the trigger.

When closing any issue that does not specify the time spent, the robot will create a comment and invite the assignee.

Changing an issue's status after creating a link

In many projects, issues depend on each other even if different people are working on them. If an issue affects the progress of one or more other issues, it's important to notify other team members if any problems arise. For example, you can link such issues to each other and set the link type Blocker to.

Let's set up a trigger that will change an issue's status and add a comment for its reporter when the Blocker to link is added:

  1. Go to the queue settings, open the Triggers section, and click Create trigger.

  2. Enter the trigger name.

  3. Set the trigger to fire when the Blocker to link appears:

    1. Choose Conditions to be met → All.

    2. Add the following condition: Action with link → Link created → Blocking issue.

  4. Set trigger actions:

    1. Add the action Change issue status.

    2. In the Next status field, select the status to switch the issue to when the condition is met. For example, Need info. The available statuses depend on the workflow set up for the queue.

    3. Add the Add comment action.

    4. Tap , find the line Invite users from a field, and enter Reporter.

    5. Enter the comment to be displayed to the issue reporter and choose Send as robot. Otherwise, the comment is sent on behalf of the user who initiates the trigger action by adding the link.

  5. Click Create to save the trigger.

Sending a notification when an issue is created from an email

Let's say the support team is processing user requests in Tracker. Users contact the support team via email, and those emails are used as the basis for issues in Tracker.

Let's set up a trigger that automatically sends an email to the user telling them that their request has been registered:

Step 1. Configure email integration

You need to set up email integration if you want to send emails right from Tracker and create issues from incoming emails:

  1. Set up an email address for the queue to store issues created based on user requests.

    If you can't create such an address, this means your organization doesn't have its own domain. You need a domain to create mailboxes and newsletters. This includes creating queue addresses. A domain is free to add in Yandex 360 for Business.

  2. Set up sender names and signatures if needed.

  3. If users aren't your organization's employees:

    1. Allow receiving emails from external addresses.

    2. Allow sending emails from issue pages to external addresses.

Step 2. Set up a trigger for sending email

Set up a trigger that automatically notifies users by mail when a new issue is created based on an email:

  1. Go to the queue settings, open the Triggers section, and click Create trigger.

  2. Enter the trigger name.

  3. Set the trigger to fire when a new issue is created based on an incoming email:

    1. Choose Conditions to be met → All.

    2. Add the condition Event type → Issue created.

    3. Add the condition Email → Created by email to → Equals string and enter the email address to your queue.

    4. Enable Ignore case so that the queue address isn't case sensitive.

  4. Set sending a message as the trigger action:

    1. Choose the Add comment action.

    2. Enable the Email option.

    3. In the To field, add the variable with the address of the user who sent the request. To do this, select the To field, click Add variable, and choose Email → From.

    4. Write the email. You can add issue parameters to the email by clicking the Add variable button.

  5. Save your trigger.

    To see if the trigger works, send an email to the queue address.

Sending a notification when an issue is created based on a form

Let's say the support team is processing user requests in Tracker. Users contact the support team via a feedback form created in Yandex Forms. A Tracker issue is then created based on that form.

Let's set up a trigger that automatically sends an email to the user telling them that their request has been registered:

Step 1. Configure email integration

You need to set up email integration if you want to send emails from Tracker:

  1. Set up an email address for the queue to store issues created based on user requests.

    If you can't create such an address, this means your organization doesn't have its own domain. You need a domain to create mailboxes and newsletters. This includes creating queue addresses. A domain is free to add in Yandex 360 for Business.

  2. Set up sender names and signatures if needed.

  3. If the users aren't your organization's employees, allow sending emails from issue pages to external addresses.

Step 2. Set up a form to register requests

To create issues from requests sent through forms:

  1. Go to Yandex Forms and create a new form.

  2. Add questions that let users provide relevant information necessary to register their request.

    If you want to know the user's email address, add the Email question and make it a required field.

  3. Set up your form's integration with Tracker:

    1. Specify your queue and other issue parameters.

    2. Use the Issue description field to add answers to the questions included in your form.

    3. To save the user's email address in the issue settings, add the From field and select Variables → Answer to question → Email.

    4. Save your integration settings.

    image

  4. Publish your form.

Step 3. Set up a trigger for sending email

Set up a trigger that sends automatic email notifications via a form when a new issue is created:

  1. Go to the queue settings, open the Triggers section, and click Create trigger.

  2. Enter the trigger name.

  3. Set the trigger to fire when a new issue is created based on an incoming email:

    1. Choose Conditions to be met → All.

    2. Add the condition Event type → Issue created.

    3. Add the condition Email → From → Field value became not empty..

  4. Set sending a message as the trigger action:

    1. Choose the Add comment action.

    2. Enable the Email option.

    3. In the To field, add the variable with the address of the user who sent the request. To do this, select the To field, click Add variable, and choose Email → From.

    4. Write the email. You can add issue parameters to the email by clicking the Add variable button.

  5. Save your trigger.

    To see if your trigger works, fill out the form you integrated with Tracker.

Automatically adding a form to the issue comments

Using a trigger, you can add a form with auto-prefilled fields to the issue comments. To do this, add a special code with a link to the form in the comment text. Values can be passed to the form fields via GET parameters. For example, you can send issue parameters via variables available in triggers.

Let's set up a trigger that adds a feedback form to the comments and invites an assignee after the issue is closed:

Step 1. Create a feedback form

  1. Go to Yandex Forms and create a form.

  2. Add questions to the form so that the assignee can provide necessary information.

Step 2. Create a trigger to add the form

  1. Go to the queue settings, open the Triggers section, and click Create trigger.

  2. Set the trigger to fire when the issue is closed:

    1. Choose Conditions to be met → All.

    2. Add the condition Status → Field value became equal to → Closed.

  3. Add the Add comment action.

  4. In the comment text, insert the code:

    {{=<% %>=}}/iframe/(src="https://forms.yandex.ru/surveys/<form_id>/?iframe=1&<question_id>=<value>" frameborder=0 width=500)
    
    • <form id> is the ID of the form to be added.

    • <question_id>is the ID of the question.

    • <value> is the value to populate the form field.

      To transfer issue parameters to the form, use variables as values: click Add variable and choose your issue parameter. Then replace the {{ }} characters around the name of the variable with <% %>.

      For example, to pass an issue key, use the <%issue.key%> value. To pass the username of an assignee, use the <%issue.assignee.login%> value.

    Code example where an issue key is passed to the form field:

    {{=<% %>=}}/iframe/(src="https://forms.yandex.ru/surveys/68417/?iframe=1&answer_short_text_584943=<%issue.key%>" frameborder=0 width=100% height=660px scrolling=no}}
    
  5. Click , find the line Invite users from a field, and enter Assignee.

  6. Enable the Send as robot option.

  7. Click Create to save the trigger.

Step 3. Add yndx-forms-cnt-robot@ to the queue

To ensure the form is inserted correctly, provide access to the queue for the yndx-forms-cnt-robot@ robot. To learn more about configuring access, see Setting access rights for queues.

Once the issue is closed, the robot will create a comment with the form and invite the assignee.

Automatically adding issues to the board

The new version of the issue board currently doesn't support filters that let you add issues to the board automatically. However, you can set up a trigger as a substitute for the feature.

You can also set up an auto action with similar conditions and outcomes. When using an auto action, issues that fit your desired conditions will be added to the board at preset intervals rather than all at once.

Warning

Triggers and auto actions work only for issues within the queue they were configured in.

Let's look at an example of a trigger that adds an issue to the board once a specific user is selected as the assignee for the issue:

  1. Go to the queue settings, open the Triggers section, and click Create trigger.

  2. Enter the trigger name.

  3. Set the condition: Assignee → equals → <User's name>.

    Note

    A trigger with this condition will also activate when a new issue with the selected assignee is created.

  4. Set the action:

    1. Select the action Update fields.

    2. Select the Boards field.

    3. Select Add to list and choose the board to add the issue to.

  5. Save your trigger.

Sending notifications to instant messengers

Messengers are a great way to quickly notify employees about important events. If a messenger has an API, you can use Tracker to set up a trigger that sends HTTP requests to the messenger's API when certain events occur. For instance, a request can be triggered once an error with the critical priority status is added to the queue.

To view examples for setting up triggers that send notifications to Slack and Telegram, see Messenger integration.

Was the article helpful?

Language / Region
© 2022 Yandex.Cloud LLC
In this article:
  • Picking assignees automatically
  • Inviting assignees automatically
  • Changing an issue's status after creating a link
  • Sending a notification when an issue is created from an email
  • Sending a notification when an issue is created based on a form
  • Automatically adding a form to the issue comments
  • Automatically adding issues to the board
  • Sending notifications to instant messengers