Действия для коннектора Slack

Материал из Документация Ключ-АСТРОМ

Действия для коннектора Slack

Коннектор Slack предоставляет следующие действия для Workflows. Каждое действие требует определённых областей действия OAuth, которые вы настраиваете при создании соединения Slack.

Отправить сообщение

Отправляйте сообщения Slack в каналы с богатым форматированием, реакциями и вложениями файлов.

Разрешения Slack

Действие Отправить сообщение требует разных разрешений в зависимости от запрашиваемой функциональности.

Область действия Что включает Обязательно
chat:write Отправка сообщений в каналы и личные сообщения. Да
chat:write.public Отправка в публичные каналы без необходимости быть участником бота. Нет
channels:read Поиск публичных каналов по имени для выбора канала. Да
channels:join Автоматическое присоединение к публичному каналу, если бот ещё не является участником. Нет
groups:read Поиск приватных каналов по имени для выбора канала. Нет
files:write Загрузка вложений файлов в сообщения. Нет
files:read Получение информации о файле после загрузки (требуется вместе с files:write). Нет
reactions:write Добавление emoji-реакций к отправленным сообщениям. Нет

Входные данные

Поле Описание Обязательно
Соединение ID соединения. Да
Канал ID канала Slack или имя канала. Да
messageFormat Должно быть slack_format или astromkey_markdown. По умолчанию: slack_format. Да
Сообщение Если messageFormat — slack_format, обрабатываются входные данные Slack Markdown или Slack Block Kit. Если messageFormat — astromkey_markdown, поддерживается только Markdown. Да
Реакции Массив JavaScript имён реакций. Нет
appendToThread Значение thread_ts Slack для добавления сообщения в цепочку. Нет
replyBroadcast true, если сообщение также должно быть отправлено в канал. Можно установить только если appendToThread содержит допустимый ID сообщения. Нет
Вложение Объект JavaScript вложения. Нет

Вложение

Поле Описание Обязательно
title Заголовок или имя вложения в Slack. Да
Content Содержимое вложения. Да
File type MIME-тип вложения. Поддерживаемые значения: csv, json, markdown, text, xml, yaml. Да

Результат

Поле Пример результата
threadTs 123456789.01234
channelID ABCDEF012345
messageTs 123456789.01234
permalink https://your-environment.slack.com/archives/ABCDEFG/p12345679890

Запрос на одобрение

Отправьте запрос на одобрение в канал Slack и приостановите Workflow до получения ответа. Когда Workflow достигает этого действия, оно отправляет сообщение с кнопками Approve и Decline в указанный канал и приостанавливает Workflow. Когда одобряющий отвечает или достигается настроенный тайм-аут, Workflow возобновляется и публикует результат ответом в исходной цепочке сообщений. Настройте тайм-аут на вкладке Опции действия.

Разрешения Slack

Область действия Что включает Обязательно
chat:write Отправка запросов на одобрение в каналы. Да
chat:write.public Отправка в публичные каналы без необходимости быть участником бота. Нет
channels:read Поиск публичных каналов по имени для выбора канала. Да
groups:read Поиск приватных каналов по имени для выбора канала. Нет

Входные данные

Поле Описание Обязательно
connection ID соединения. Да
channel ID канала Slack или имя канала. Да
Message Сообщение, отправляемое с запросом на одобрение. Поддерживается только Slack Markdown. Да

Результат

Поле Пример результата
approvalType internal
result[0].channelID ABCDEF012345
result[0].messageTs 123456789.01234
result[0].threadTs 123456789.01234
result[0].permalink https://your-environment.slack.com/archives/ABCDEFG/p12345679890