Jira Service Management

Заявки, очереди, SLA и согласования Jira Service Management в процессах Pailot

Jira Service Management — ITSM (IT Service Management — управление ИТ-услугами) Atlassian: заявки, очереди, SLA (Service Level Agreement — соглашение об уровне сервиса), клиенты и согласования.

С Jira Service Management в Pailot вы можете:

Смотреть service desk (сервис-деск — портал поддержки) и типы заявок, создавать и читать заявки
Комментировать заявку (публично или внутренне)
Работать с клиентами и организациями service desk
Смотреть очереди, SLA и доступные переходы статуса
Добавлять участников, читать и отвечать на согласования (approve / decline)

Нужен вход по OAuth (вход по разрешению сервиса) или API-токен Atlassian и домен вида yourcompany.atlassian.net.

Блок ставят на холст как отдельный шаг или прикрепляют к агенту.

Инструменты

`jsm_get_service_desks`

Все service desk в Jira Service Management.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`serviceDesks`	json	Список service desk
`total`	number	Всего service desk
`isLastPage`	boolean	Это последняя страница

`jsm_get_request_types`

Типы заявок service desk.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`serviceDeskId`	string	Да	ID service desk
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`requestTypes`	json	Типы заявок
`total`	number	Всего типов
`isLastPage`	boolean	Это последняя страница

`jsm_create_request`

Создать заявку.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`serviceDeskId`	string	Да	ID service desk
`requestTypeId`	string	Да	ID типа заявки
`summary`	string	Да	Краткое название заявки
`description`	string	Нет	Описание заявки
`raiseOnBehalfOf`	string	Нет	Account ID клиента, от чьего имени создаётся заявка

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueId`	string	ID созданной заявки
`issueKey`	string	Ключ заявки (например SD-123)
`requestTypeId`	string	ID типа заявки
`serviceDeskId`	string	ID service desk
`success`	boolean	Удалось ли создать заявку
`url`	string	URL заявки

`jsm_get_request`

Одна заявка.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`request`	json	Объект заявки

`jsm_get_requests`

Несколько заявок с фильтрами.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`serviceDeskId`	string	Нет	Фильтр по ID service desk
`requestOwnership`	string	Нет	Владение: OWNED_REQUESTS, PARTICIPATED_REQUESTS, ORGANIZATION, ALL_REQUESTS
`requestStatus`	string	Нет	Статус: OPEN, CLOSED, ALL
`searchTerm`	string	Нет	Строка поиска
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`requests`	json	Список заявок
`total`	number	Всего заявок
`isLastPage`	boolean	Это последняя страница

`jsm_add_comment`

Добавить комментарий к заявке: публичный или внутренний.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)
`body`	string	Да	Текст комментария
`isPublic`	boolean	Да	Публичный (виден клиенту) или внутренний

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueIdOrKey`	string	ID или ключ задачи
`commentId`	string	ID комментария
`body`	string	Текст комментария
`isPublic`	boolean	Публичный ли комментарий
`success`	boolean	Удалось ли добавить комментарий

`jsm_get_comments`

Комментарии заявки.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)
`isPublic`	boolean	Нет	Только публичные комментарии
`internal`	boolean	Нет	Только внутренние комментарии
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueIdOrKey`	string	ID или ключ задачи
`comments`	json	Список комментариев
`total`	number	Всего комментариев
`isLastPage`	boolean	Это последняя страница

`jsm_get_customers`

Клиенты service desk.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`serviceDeskId`	string	Да	ID service desk
`query`	string	Нет	Поиск по клиентам
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`customers`	json	Список клиентов
`total`	number	Всего клиентов
`isLastPage`	boolean	Это последняя страница

`jsm_add_customer`

Добавить клиентов в service desk.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`serviceDeskId`	string	Да	ID service desk
`emails`	string	Да	Email клиентов через запятую

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`serviceDeskId`	string	ID service desk
`success`	boolean	Удалось ли добавить клиентов

`jsm_get_organizations`

Организации service desk.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`serviceDeskId`	string	Да	ID service desk
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`organizations`	json	Список организаций
`total`	number	Всего организаций
`isLastPage`	boolean	Это последняя страница

`jsm_create_organization`

Создать организацию.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`name`	string	Да	Название организации

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`organizationId`	string	ID созданной организации
`name`	string	Название
`success`	boolean	Успешность операции

`jsm_add_organization`

Привязать организацию к service desk.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`serviceDeskId`	string	Да	ID service desk
`organizationId`	string	Да	ID организации

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`serviceDeskId`	string	ID service desk
`organizationId`	string	ID добавленной организации
`success`	boolean	Успешность операции

`jsm_get_queues`

Очереди service desk.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`serviceDeskId`	string	Да	ID service desk
`includeCount`	boolean	Нет	Включить число задач в каждой очереди
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`queues`	json	Список очередей
`total`	number	Всего очередей
`isLastPage`	boolean	Это последняя страница

`jsm_get_sla`

Сведения SLA по заявке.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueIdOrKey`	string	ID или ключ задачи
`slas`	json	Сведения SLA
`total`	number	Всего SLA
`isLastPage`	boolean	Это последняя страница

`jsm_get_transitions`

Доступные переходы статуса заявки.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueIdOrKey`	string	ID или ключ задачи
`transitions`	json	Доступные переходы

`jsm_transition_request`

Перевести заявку в другой статус.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)
`transitionId`	string	Да	ID перехода
`comment`	string	Нет	Необязательный комментарий при переходе

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueIdOrKey`	string	ID или ключ задачи
`transitionId`	string	Применённый ID перехода
`success`	boolean	Удалось ли выполнить переход

`jsm_get_participants`

Участники заявки.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueIdOrKey`	string	ID или ключ задачи
`participants`	json	Список участников
`total`	number	Всего участников
`isLastPage`	boolean	Это последняя страница

`jsm_add_participants`

Добавить участников к заявке.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)
`accountIds`	string	Да	Account ID через запятую

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueIdOrKey`	string	ID или ключ задачи
`participants`	json	Добавленные участники
`success`	boolean	Успешность операции

`jsm_get_approvals`

Согласования заявки.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)
`start`	number	Нет	Индекс начала страницы (по умолчанию 0)
`limit`	number	Нет	Максимум результатов (по умолчанию 50)

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueIdOrKey`	string	ID или ключ задачи
`approvals`	json	Список согласований
`total`	number	Всего согласований
`isLastPage`	boolean	Это последняя страница

`jsm_answer_approval`

Одобрить или отклонить согласование.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Jira (например yourcompany.atlassian.net)
`cloudId`	string	Нет	Jira Cloud ID инстанса
`issueIdOrKey`	string	Да	ID или ключ задачи (например SD-123)
`approvalId`	string	Да	ID согласования
`decision`	string	Да	Решение: approve или decline

Выход

Параметр	Тип	Описание
`ts`	string	Время операции
`issueIdOrKey`	string	ID или ключ задачи
`approvalId`	string	ID согласования
`decision`	string	Решение (approve/decline)
`success`	boolean	Успешность операции

На этой странице

На этой странице

Получить доступ

Копилот собирает процесс. Менеджер запускает сам. Можно поставить в контур компании.

Получить доступ