Объекты действий триггера

Для управления действиями триггера укажите один или несколько объектов.

Изменить статус задачи

Параметр Описание Допустимые значения Тип данных
type Тип действия Transition Строка
status Статус задачи Ключ, идентификатор или имя статуса Строка

Пример: Перевести задачу в статус «В работе».

{ "type": "Transition", "status": "В работе" }

Вычислить значение

Параметр Описание Допустимые значения Тип данных
type Тип действия CalculateFormula Строка
formula Формула Математическое выражение Строка
resultField Поле, в котором вычисляется значение Ключ или имя поля Строка

Пример: Вычислить дату через 3 месяца после текущей и добавить полученное значение в поле «Начало».

{ "type": "CalculateFormula", "formula": "now()+3M", "resultField": "start" }

Изменить значения в полях

Параметр Описание Допустимые значения Тип данных
type Тип действия Update Строка
update Объект со списком полей задачи, которые требуется изменить. Полный список полей задачи Пара «ключ поля – значение».

Чтобы очистить поле, укажите значение null.
Также допустимо использовать операторы set, add, remove (см. Редактирование параметров)		 Объект

Пример: Изменить значение полей задачи.

  • Описание задачи изменить на «Новая задача»;
  • Добавить тег «Новый тег»;
  • Очистить значение поля «Резолюция».
{
   "type": "Update",
   "update": {
       "description": "Новая задача",
       "tags": { "add": "Новый тег" },
       "resolution": null
   }
}

Переместить задачу

Параметр Описание Допустимые значения Тип данных
type Тип действия Move Строка
queue Очередь Ключ очереди Строка

Пример: Перенести задачу в очередь «TESTQUEUE».

{ "type": "Move", "queue": "TESTQUEUE"}

Добавить комментарий

Параметр Описание Допустимые значения Тип данных
type Тип действия CreateComment Строка
text Текст комментария Текст Строка
fromRobot Отправлять от имени робота или от имени пользователя, запустившего триггер
  • true — отправить от имени робота;
  • false — отправить от имени пользователя, который запустил триггер.
 Логический

Пример: Отправить комментарий от имени пользователя, запустившего триггер. Текст комментария: Обращение создано <дата сегодня>.

{ "type": "CreateComment", "text": "Обращение создано {{currentDateTime.date}}", "fromRobot": false }

Создать чеклист

Параметр Описание Допустимые значения Тип данных
type Тип действия CreateChecklist Строка
checklistItems Список пунктов чеклиста Массив объектов с полями:
  • text — описание (обязательное поле);
  • assignee — исполнитель;
  • deadline — дедлайн в формате объекта {"date": "YYYY-MM-DD"}.
 Массив объектов

Пример: Создать чеклист с тремя пунктами.

  • Пункт 1: «Сделать то»;
  • Пункт 2: «Сделать это».
  • Пункт 3: «Отчитаться за все».

В первых двух пунктах заданы одинаковые дедлайн (26 октября 2025) и исполнитель (пользователь с логином @username). В последнем пункте задан только заголовок.

{
   "type": "CreateChecklist",
   "checklistItems": [
         {
            "text": "Сделать то",
            "assignee": "username",
            "deadline": {"date": "2025-05-23"}
         },
         {
            "text": "Сделать это",
            "assignee": "username",
            "deadline": {"date": "2025-05-23"}
         },
         {   "text": "Отчитаться за все"}
   ]
}

HTTP-запрос

Параметр Описание Допустимые значения Тип данных
type Тип действия Webhook Строка
endpoint Адрес URL запроса Строка
authContext Способ авторизации Объект с данными авторизации Строка
method Метод запроса Одно из значений:
  • GET
  • POST
  • PUT
  • DELETE
 Строка
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;
  • В теле запроса передается сообщение с текстом «Успех».
{
   "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":"Успех"}
}

Создать задачу

Параметр Описание Допустимые значения Тип данных
type Тип действия CreateIssue Строка
queue Очередь Ключ очереди Строка
summary Название Текст Строка
fieldTemplates Параметры задачи Объект с параметрами задачи Объект
linkWithInitialIssue Связать с задачей, которая запустила триггер
  • true — связать;
  • false — не связывать.
 Логический
fromRobot Создавать задачи от имени робота Объект с полями задачи
  • true — создавать от имени робота;
  • false — создавать от имени пользователя, который запустил триггер.

Параметры объекта с полями задачи

Параметр Описание Допустимые значения Тип данных
followers Наблюдатели Массив с идентификаторами пользователей Массив строк
dueDate Дедлайн Дата Строка
description Описание Текст Строка
assignee Исполнитель Идентификатор пользователя Строка
priority Приоритет Ключ или имя приоритета Строка
type Тип задачи Ключ или имя типа Строка
tags Список тегов Массив строковых элементов Массив строк

Пример: В очереди «TESTQUEUE» от имени робота создать задачу «Новая задача».

  • Наблюдатели — пользователи с логинами @user1 и @user2;
  • Исполнитель — пользователь с логином @user3;
  • Дедлайн — 31 октября 2024;
  • Текст описания — Создано триггером <дата сегодня>;
  • Приоритет — «Критичный»;
  • Тип — «Веха»;
  • Теги — new task и by trigger.
{
   "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
}
Предыдущая
Изменить триггер
Следующая
Объекты условий срабатывания триггера