Confluence

Страницы, комментарии и вложения Confluence в процессах Pailot

Confluence — база знаний Atlassian: пространства, страницы и комментарии. Блок ходит в API (Application Programming Interface — программный интерфейс) Cloud по домену (yourcompany.atlassian.net).

С Confluence в Pailot вы можете:

Читать, создавать, обновлять и удалять страницы (удаление — в корзину)
Искать по страницам и записям блога
Работать с комментариями и вложениями
Смотреть метки страницы, карточку пространства и список пространств

cloudId можно не указывать — блок возьмёт его по домену. Подключение — через OAuth (вход по разрешению сервиса) или токен. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства.

Инструменты

`confluence_retrieve`

Текст страницы Confluence (HTML снят).

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`pageId`	string	Да	ID страницы
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время чтения
`pageId`	string	ID страницы
`content`	string	Текст страницы без HTML-тегов
`title`	string	Заголовок страницы

`confluence_update`

Обновить страницу Confluence.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`pageId`	string	Да	ID страницы
`title`	string	Нет	Новый заголовок
`content`	string	Нет	Новое содержимое в формате storage Confluence
`version`	number	Нет	Номер версии (нужен, чтобы не перезаписать чужие правки)
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время обновления
`pageId`	string	ID страницы
`title`	string	Обновлённый заголовок
`success`	boolean	Обновление удалось

`confluence_create_page`

Создать страницу в пространстве.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`spaceId`	string	Да	ID пространства
`title`	string	Да	Заголовок страницы
`content`	string	Да	Содержимое в формате storage Confluence (HTML)
`parentId`	string	Нет	ID родительской страницы
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время создания
`pageId`	string	ID созданной страницы
`title`	string	Заголовок
`url`	string	URL страницы

`confluence_delete_page`

Удалить страницу (в корзину, можно восстановить).

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`pageId`	string	Да	ID страницы
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время удаления
`pageId`	string	ID удалённой страницы
`deleted`	boolean	Страница удалена

`confluence_search`

Поиск по страницам, записям блога и другому содержимому.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`query`	string	Да	Поисковый запрос
`limit`	number	Нет	Максимум результатов (по умолчанию 25)
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время поиска
`results`	array	Результаты поиска

`confluence_create_comment`

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

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`pageId`	string	Да	ID страницы
`comment`	string	Да	Текст комментария в формате storage Confluence
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время создания
`commentId`	string	ID комментария
`pageId`	string	ID страницы

`confluence_list_comments`

Список комментариев страницы.

Вход

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

Выход

Параметр	Тип	Описание
`ts`	string	Время чтения
`comments`	array	Список комментариев

`confluence_update_comment`

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

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`commentId`	string	Да	ID комментария
`comment`	string	Да	Новый текст в формате storage Confluence
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время обновления
`commentId`	string	ID комментария
`updated`	boolean	Комментарий обновлён

`confluence_delete_comment`

Удалить комментарий.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`commentId`	string	Да	ID комментария
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время удаления
`commentId`	string	ID комментария
`deleted`	boolean	Комментарий удалён

`confluence_upload_attachment`

Загрузить файл как вложение страницы.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`pageId`	string	Да	ID страницы
`file`	file	Да	Файл вложения
`fileName`	string	Нет	Своё имя файла
`comment`	string	Нет	Комментарий к вложению
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время загрузки
`attachmentId`	string	ID вложения
`title`	string	Имя файла
`fileSize`	number	Размер в байтах
`mediaType`	string	MIME-тип
`downloadUrl`	string	Ссылка на скачивание
`pageId`	string	ID страницы

`confluence_list_attachments`

Список вложений страницы.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`pageId`	string	Да	ID страницы
`limit`	number	Нет	Максимум вложений (по умолчанию 25)
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время чтения
`attachments`	array	Список вложений

`confluence_delete_attachment`

Удалить вложение (в корзину).

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`attachmentId`	string	Да	ID вложения
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время удаления
`attachmentId`	string	ID вложения
`deleted`	boolean	Вложение удалено

`confluence_list_labels`

Список меток страницы.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`pageId`	string	Да	ID страницы
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время чтения
`labels`	array	Список меток

`confluence_get_space`

Карточка пространства.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`spaceId`	string	Да	ID пространства
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время чтения
`spaceId`	string	ID пространства
`name`	string	Название пространства
`key`	string	Ключ пространства
`type`	string	Тип пространства
`status`	string	Статус пространства
`url`	string	URL пространства

`confluence_list_spaces`

Список доступных пространств.

Вход

Параметр	Тип	Обязательный	Описание
`domain`	string	Да	Домен Confluence (например, yourcompany.atlassian.net)
`limit`	number	Нет	Максимум пространств (по умолчанию 25)
`cloudId`	string	Нет	Cloud ID инстанса. Если пусто — запросится по домену

Выход

Параметр	Тип	Описание
`ts`	string	Время чтения
`spaces`	array	Список пространств

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

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

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

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

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