--- metadata: - name: generator content: Diplodoc Platform v5.66.1 - property: og:type content: article - property: article:section content: Справочник API - property: og:title content: Объекты действий триггера - property: article:tag content: Техническая инструкция alternate: - https://yandex.ru/support/tracker/en/api/queues/change-trigger-actions.md - https://yandex.ru/support/tracker/ru/api/queues/change-trigger-actions.md - href: https://yandex.ru/support/tracker/ru/api/queues/change-trigger-actions.md type: text/markdown title: Markdown version - href: https://yandex.ru/support/tracker/ru/llms.txt?revision=r22077802 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt?revision=r22077802 # Объекты действий триггера Для управления действиями триггера укажите один или несколько объектов. ## Изменить статус задачи {#change-status} Параметр | Описание | Допустимые значения | Тип данных ----- | ----- | ----- | ----- type | Тип действия | `Transition` | Строка status | Статус задачи | Ключ, идентификатор или имя статуса | Строка > Пример: Перевести задачу в статус «В работе». > ```json translate=no > { "type": "Transition", "status": "В работе" } > ``` ## Вычислить значение {#calculate} Параметр | Описание | Допустимые значения | Тип данных ----- | ----- | ----- | ----- type | Тип действия | `CalculateFormula` | Строка formula | Формула | Математическое выражение | Строка resultField | Поле, в котором вычисляется значение | Ключ или имя поля | Строка > Пример: Вычислить дату через 3 месяца после текущей и добавить полученное значение в поле «Начало». > ```json translate=no > { "type": "CalculateFormula", "formula": "now()+3M", "resultField": "start" } > ``` ## Изменить значения в полях {#change-fields} Параметр | Описание | Допустимые значения | Тип данных ----- | ----- | ----- | ----- type | Тип действия | `Update` | Строка update | Объект со списком полей задачи, которые требуется изменить. [Полный список полей задачи](https://tracker.yandex.ru/admin/fields) | Пара «ключ поля – значение».

Чтобы очистить поле, укажите значение `null`.
Также допустимо использовать операторы `set`, `add`, `remove` (см. [Редактирование параметров](../common-format.md#edit-fields))| Объект > Пример: Изменить значение полей задачи. > - Описание задачи изменить на «Новая задача»; > - Добавить тег «Новый тег»; > - Очистить значение поля «Резолюция». > ```json translate=no > { > "type": "Update", > "update": { > "description": "Новая задача", > "tags": { "add": "Новый тег" }, > "resolution": null > } > } > ``` ## Переместить задачу {#move-task} Параметр | Описание | Допустимые значения | Тип данных ----- | ----- | ----- | ----- type | Тип действия | `Move` | Строка queue | Очередь | Ключ очереди | Строка > Пример: Перенести задачу в очередь «TESTQUEUE». > ```json translate=no > { "type": "Move", "queue": "TESTQUEUE"} > ``` ## Добавить комментарий {#add-comment} Параметр | Описание | Допустимые значения | Тип данных ----- | ----- | ----- | ----- type | Тип действия | `CreateComment` | Строка text | Текст комментария | Текст | Строка fromRobot | Отправлять от имени робота или от имени пользователя, запустившего триггер | | Логический > Пример: Отправить комментарий от имени пользователя, запустившего триггер. Текст комментария: `Обращение создано ДАТА_СЕГОДНЯ`. > ```json translate=no > { "type": "CreateComment", "text": "Обращение создано {{currentDateTime.date}}", "fromRobot": false } > ``` ## Создать чеклист {#add-checklist} Параметр | Описание | Допустимые значения | Тип данных ----- | ----- | ----- | ----- type | Тип действия | `CreateChecklist` | Строка checklistItems | Список пунктов чеклиста | Массив объектов с полями: | Массив объектов > Пример: Создать чеклист с тремя пунктами. > - Пункт 1: «Сделать то»; > - Пункт 2: «Сделать это». > - Пункт 3: «Отчитаться за все». > > В первых двух пунктах заданы одинаковые дедлайн (26 октября 2025) и исполнитель (пользователь с логином `@username`). В последнем пункте задан только заголовок. > ```json translate=no > { > "type": "CreateChecklist", > "checklistItems": [ > { > "text": "Сделать то", > "assignee": "username", > "deadline": {"date": "2025-05-23"} > }, > { > "text": "Сделать это", > "assignee": "username", > "deadline": {"date": "2025-05-23"} > }, > { "text": "Отчитаться за все"} > ] > } > ``` ## HTTP-запрос {#webhook} Параметр | Описание | Допустимые значения | Тип данных ----- | ----- | ----- | ----- type | Тип действия | `Webhook` | Строка endpoint | Адрес | URL запроса | Строка authContext | Способ авторизации | Объект с данными авторизации | Строка method | Метод запроса | Одно из значений: | Строка contentType | Тип содержимого | `application/json` | Строка headers | Заголовки | Объект с полями в формате ключ-значение | Объект body | Тело запроса | Объект с данными или строка | Объект или Строка **Допустимые объекты авторизации** Тип авторизации | Объект ----- | ----- NoAuth | `{ "type": "noauth" }` Basic | `{ "password": "********", "type": "basic", "login": "ЛОГИН" }` OAuth 2 | `{ "headerName": "Authorization", "type": "oauth", "accessToken": "********", "tokenType": "Bearer"}` > Пример: Выполнить HTTP-запрос методом `GET`. > - Адрес запроса — `https://api.example.com/messenger/sendMessage`; > - Тип содержимого — `application/json; charset=UTF-8`; > - Тип авторизации — «Basic»; > - В заголовке передается значение параметра `Content-Language` — `ru-RU`; > - В теле запроса передается сообщение с текстом «Успех». > ```json translate=no > { > "type": "Webhook", > "endpoint": "https://api.example.com/messenger/sendMessage", > "method": "GET", > "contentType": "application/json; charset=UTF-8", > "headers": { "Content-Language": "ru-RU" }, > "authContext": { "password": "********", "type": "basic", "login": "user1" }, > "body": {"message":"Успех"} > } > ``` ## Создать задачу {#create-task} Параметр | Описание | Допустимые значения | Тип данных ----- | ----- | ----- | ----- type | Тип действия | `CreateIssue` | Строка queue | Очередь | Ключ очереди | Строка summary | Название | Текст | Строка fieldTemplates | Параметры задачи | Объект с параметрами задачи | Объект linkWithInitialIssue | Связать с задачей, которая запустила триггер | | Логический fromRobot | Создавать задачи от имени робота | Объект с полями задачи | | Логический **Параметры объекта с полями задачи** Параметр | Описание | Допустимые значения | Тип данных ----- | ----- | ----- | ----- followers | Наблюдатели | Массив с идентификаторами пользователей | Массив строк dueDate | Дедлайн | Дата | Строка description | Описание | Текст | Строка assignee | Исполнитель | Идентификатор пользователя | Строка priority | Приоритет | Ключ или имя приоритета | Строка type |Тип задачи | Ключ или имя типа | Строка tags | Список тегов | Массив строковых элементов | Массив строк > Пример: В очереди «TESTQUEUE» от имени робота создать задачу «Новая задача». > - Наблюдатели — пользователи с логинами `@user1` и `@user2`; > - Исполнитель — пользователь с логином `@user3`; > - Дедлайн — 31 октября 2024; > - Текст описания — `Создано триггером ДАТА_СЕГОДНЯ`; > - Приоритет — «Критичный»; > - Тип — «Веха»; > - Теги — `new task` и `by trigger`. > ```json translate=no > { > "type": "CreateIssue", > "queue": "TESTQUEUE", > "summary": "Новая задача", > "fieldTemplates": { > "followers": ["user1", "user2"], > "assignee": "user3", > "dueDate": "2024-10-31", > "description": "Создана триггером {{currentDateTime.date}}", > "priority": "critical", > "type": "milestone", > "tags": ["new task", "by trigger"] > }, > "fromRobot": true > } > ```