Slack

Slack — это средство коммуникации команды, которое объединяет все ваши команды связи в одном месте, мгновенно искомые и доступные везде, где вы идете.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Стандарт	Все регионы Power Automate , кроме следующих: — Облако Китая, управляемое 21Vianet
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Стандарт	Все регионы Power Apps , кроме следующих: — Облако Китая, управляемое 21Vianet
Power Automate	Стандарт	Все регионы Power Automate , кроме следующих: — Облако Китая, управляемое 21Vianet

Контакт
Имя	Microsoft
URL	https://support.microsoft.com/contactus

Метаданные соединителя
Publisher	Microsoft
Веб-сайт	https://slack.com/
Политика конфиденциальности	https://slack.com/privacy-policy
Categories	Сотрудничество; Коммуникация

Известные проблемы и ограничения

Согласно документации по API Slack, некоторые методы API Slack, которые использует соединитель, перестают работать в феврале 2021 года и не будут работать с вновь созданными приложениями после 10 июня 2020 года. Поэтому используйте последние версии следующих действий.

Действия:
Создайте группу не рекомендуется, используйте последнюю версию канала для создания частных каналов.
Максимальное число символов в сообщении ограничено 4000. Дополнительные сведения см. в официальной документации Slack.

Подробное описание соединителя

Дополнительные сведения о соединителе см. в подробном разделе.

Ограничения регулирования

Имя.	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд
Частота опросов триггеров	1	120 секунд

Действия

Вывод списка общедоступных каналов	Список общедоступных каналов в slack.
Вывод списка общедоступных каналов (поддержка разбиения на страницы) (предварительная версия)	Список общедоступных каналов в slack.
Вывод списка ответов на сообщения (предварительная версия)	Вывод списка ответов в потоке сообщений, включая родительское сообщение.
Вывод списка сообщений бесед (предварительная версия)	Вывод списка сообщений, размещенных в беседе (общедоступный канал, частный канал, прямой или групповое прямое сообщение).
Не беспокоиться	Задайте состояние "Не беспокоить" для пользователя.
Получение профиля пользователя (предварительная версия)	Получение сведений профиля для пользователя Slack. Полезно для разрешения автора сообщения, возвращаемого сообщениями беседы list или list messages.
Присоединение к общедоступному каналу	Присоединяйтесь к общедоступному каналу в slack.
Присоединение канала [DEPRECATED]	Это действие устарело. Вместо этого используйте общедоступный канал присоединения . ~~Присоединяйтесь к каналу в slack.~~
Создание группы [DEPRECATED]	Создает группу в slack.
Создание канала	Создайте канал в slack.
Создание канала [DEPRECATED]	Это действие устарело. Используйте вместо этого канал. ~~Создайте канал в slack.~~
Сообщение о публикации (версия 2)	Эта операция используется для публикации сообщения в указанный канал.
Сообщение о публикации [DEPRECATED]	Это действие устарело. Вместо этого используйте сообщение Post (V2 ). ~~Эта операция используется для публикации сообщения в указанный канал.~~
Список каналов [DEPRECATED]	Это действие устарело. Вместо этого используйте общедоступные каналы списка (поддержка разбиения на страницы). ~~Вывод списка каналов в slack.~~

Вывод списка общедоступных каналов

Идентификатор операции:: ListChannels_V2

Список общедоступных каналов в slack.

Параметры

Имя.	Ключ	Тип	Описание
Типы бесед	types	string	Включаемые запятыми типы бесед. По умолчанию используется public_channel. Явно включите private_channel, im или mpim для перечисления других типов бесед.
Исключить архивированный	exclude_archived	boolean	Установите значение true, чтобы исключить архивные беседы.
Максимальные результаты	limit	integer	Максимальное количество возвращаемых бесед.
Идентификатор команды	team_id	string	Кодированный идентификатор команды. Требуется только для токена на уровне организации.
Cursor	cursor	string	Курсор разбиения на страницы, возвращаемый предыдущим запросом.

Возвращаемое значение

Тело: ListChannels_Response

Вывод списка общедоступных каналов (поддержка разбиения на страницы) (предварительная версия)

Идентификатор операции:: ListChannels_V3

Список общедоступных каналов в slack.

Возвращаемое значение

Тело: ListChannels_ResponseV3

Вывод списка ответов на сообщения (предварительная версия)

Идентификатор операции:: ListMessageReplies

Вывод списка ответов в потоке сообщений, включая родительское сообщение.

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
ИД разговора	channel	True	string	Беседа, содержащая поток.
Метка времени родительского сообщения	ts	True	string	Метка времени родительского сообщения, запускающего поток. Доступно в качестве `ts` поля сообщения, возвращаемого сообщениями беседы списка.
Максимальные результаты	limit		integer	Максимальное количество сообщений, возвращаемых на страницу.
Старейшая метка времени	oldest		string	В результаты будут включены только сообщения после этого метки времени Unix.
Последняя метка времени	latest		string	В результаты будут включены только сообщения до этого метки времени Unix.
полное сообщение;	inclusive		boolean	Включите сообщения со старыми или последними метками времени в результаты.

Возвращаемое значение

Тело: ListMessages_Response

Вывод списка сообщений бесед (предварительная версия)

Идентификатор операции:: ListConversationMessages

Вывод списка сообщений, размещенных в беседе (общедоступный канал, частный канал, прямой или групповое прямое сообщение).

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
ИД разговора	channel	True	string	Беседа для получения сообщений.
Максимальные результаты	limit		integer	Максимальное количество сообщений, возвращаемых на страницу.
Старейшая метка времени	oldest		string	В результаты будут включены только сообщения после этого метки времени Unix.
Последняя метка времени	latest		string	В результаты будут включены только сообщения до этого метки времени Unix.
полное сообщение;	inclusive		boolean	Включите сообщения со старыми или последними метками времени в результаты.
Включение всех метаданных	include_all_metadata		boolean	Возвращает все метаданные, связанные с каждым сообщением.

Возвращаемое значение

Тело: ListMessages_Response

Не беспокоиться

Идентификатор операции:: SetDND

Задайте состояние "Не беспокоить" для пользователя.

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Количество минут	num_minutes		string	Количество минут, которые нужно задать, не беспокоит.

Возвращаемое значение

Имя.	Путь	Тип	Описание
Отсохнуть включено	snooze_enabled	boolean	Включена ли функция отсознания.

Получение профиля пользователя (предварительная версия)

Идентификатор операции:: GetUserProfile

Получение сведений профиля для пользователя Slack. Полезно для разрешения автора сообщения, возвращаемого сообщениями беседы list или list messages.

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Идентификатор пользователя	user	True	string	Идентификатор пользователя, для получения сведений о профиле.

Возвращаемое значение

Тело: GetUserProfile_Response

Присоединение к общедоступному каналу

Идентификатор операции:: JoinChannel_V2

Присоединяйтесь к общедоступному каналу в slack.

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Имя канала	channel		string	Имя канала.

Возвращаемое значение

Тело: JoinChannel_ResponseV2

Присоединение канала [DEPRECATED]

Идентификатор операции:: JoinChannel

Это действие устарело. Вместо этого используйте общедоступный канал присоединения .

~~Присоединяйтесь к каналу в slack.~~

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Имя	name		string	Имя канала.

Возвращаемое значение

Тело: JoinChannel_Response

Создание группы [DEPRECATED]

Идентификатор операции:: CreateGroup

Создает группу в slack.

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Имя	name		string	Имя группы.

Возвращаемое значение

Имя.	Путь	Тип	Описание
Идентификатор	group.id	string	Идентификатор группы.
Имя	group.name	string	Имя группы.

Создание канала

Идентификатор операции:: CreateChannel_V2

Создайте канал в slack.

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Имя	name		string	Имя нового канала.
Частный канал?	is_private		boolean	Канал является частным или нет

Возвращаемое значение

Тело: CreateChannel_Response

Создание канала [DEPRECATED]

Идентификатор операции:: CreateChannel

Это действие устарело. Используйте вместо этого канал.

~~Создайте канал в slack.~~

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Имя	name		string	Имя нового канала.

Возвращаемое значение

Тело: CreateChannel_Response

Сообщение о публикации (версия 2)

Идентификатор операции:: PostMessage_V2

Эта операция используется для публикации сообщения в указанный канал.

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Имя канала	channel	True	string	Канал, частная группа или канал обмена мгновенными сообщениями для отправки сообщения. Может быть именем (например, #general) или кодированным идентификатором.
Текст сообщения	text	True	string	Текст сообщения для отправки. API Slack усекает сообщения, содержащие более 40 000 символов. Параметры форматирования см. в разделе https://api.slack.com/docs/formatting
Метка времени родительского сообщения	thread_ts		string	Метка времени родительского сообщения при публикации ответа в потоке.
Трансляция в канал	reply_broadcast		boolean	Передайте true, чтобы отправить потокованный ответ каналу.
Имя бота	username		string	Имя бота.
Публикация от имени пользователя	as_user		boolean	Передайте сообщение в качестве пользователя, прошедшего проверку подлинности, а не как бот.
Режим синтаксического анализа	parse		string	Измените способ обработки сообщений. Дополнительные сведения см. в разделе https://api.slack.com/docs/formatting
Синтаксический анализ разметки Slack	mrkdwn		boolean	Параметр синтаксического анализа разметки Slack. Включено по умолчанию.
Имена ссылок	link_names		integer	Поиск и связывание имен каналов и имен пользователей.
Распакуть ссылки	unfurl_links		boolean	Передайте true, чтобы включить отмену форматирования в основном текстового содержимого.
Разблокировка мультимедиа	unfurl_media		boolean	Передайте значение false, чтобы отключить отмену очистки содержимого мультимедиа.
URL-адрес значка	icon_url		uri	URL-адрес изображения, который будет использоваться в качестве значка для этого сообщения.
Значок Эмодзи	icon_emoji		string	Эмодзи, используемый в качестве значка для этого сообщения.

Возвращаемое значение

Сведения о сообщении, размещенном в канале Slack.

Тело: PostMessageResponse

Сообщение о публикации [DEPRECATED]

Идентификатор операции:: PostMessage

Это действие устарело. Вместо этого используйте сообщение Post (V2 ).

~~Эта операция используется для публикации сообщения в указанный канал.~~

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Имя канала	channel	True	string	Канал, частная группа или канал обмена мгновенными сообщениями для отправки сообщения. Может быть именем (например, #general) или кодированным идентификатором.
Текст сообщения	text	True	string	Текст сообщения для отправки (менее 4000 символов). Параметры форматирования см. в разделе https://api.slack.com/docs/formatting.
Имя бота	username		string	Имя бота.
Публикация от имени пользователя	as_user		boolean	Передайте сообщение в качестве пользователя, прошедшего проверку подлинности, а не как бот.
Режим синтаксического анализа	parse		string	Измените способ обработки сообщений. Дополнительные сведения см. в https://api.slack.com/docs/formatting.
Имена ссылок	link_names		integer	Поиск и связывание имен каналов и имен пользователей.
Распакуть ссылки	unfurl_links		boolean	Передайте true, чтобы включить отмену форматирования в основном текстового содержимого.
Разблокировка мультимедиа	unfurl_media		boolean	Передайте значение false, чтобы отключить отмену очистки содержимого мультимедиа.
URL-адрес значка	icon_url		uri	URL-адрес изображения, который будет использоваться в качестве значка для этого сообщения.
Значок Эмодзи	icon_emoji		string	Эмодзи, используемый в качестве значка для этого сообщения.

Возвращаемое значение

Имя.	Путь	Тип	Описание
Результат успешного выполнения	ok	boolean	Указывает, выполнена ли операция успешно.
Channel	channel	string	Канал, в который было отправлено сообщение.
Создан Date-Time	ts	string	гггг-ММ-ддTHH:мм:ss.fffZ
Текст сообщения	message.text	string	Текст сообщения.
Идентификатор сообщения	message.id	string	Уникальный идентификатор сообщения.
Идентификатор создателя	message.user	string	Уникальный идентификатор пользователя, который опубликовал сообщение.
Время создания	message.created	integer	Метка времени Unix для создания сообщения.
Удаляется	message.is_user-deleted	boolean	Независимо от того, было ли удалено сообщение.
Сообщения об ошибках	error	string	Сведения об сообщениях об ошибках, если таковые есть.

Список каналов [DEPRECATED]

Идентификатор операции:: ListChannels

Это действие устарело. Вместо этого используйте общедоступные каналы списка (поддержка разбиения на страницы).

~~Вывод списка каналов в slack.~~

Возвращаемое значение

Тело: ListChannels_Response

Триггеры

При создании файла

Идентификатор операции:: OnNewFile

При создании файла

Параметры

Имя.	Ключ	Обязательно	Тип	Описание
Channel	channel	True	string	Имя канала.

Возвращаемое значение

Имя.	Путь	Тип	Описание
Идентификатор	id	string	Идентификатор файла
Создано	created	integer	Когда файл был создан.
Имя	name	string	Имя файла.
Название	title	string	Заголовок файла.

Определения

Channel

Канал

Имя.	Путь	Тип	Описание
Идентификатор	id	string	Идентификатор канала.
Имя	name	string	Имя канала.
Общедоступный канал	is_channel	boolean	Является ли эта беседа общедоступным каналом.
Частный канал	is_group	boolean	Является ли этот разговор частным каналом.
Является прямым сообщением	is_im	boolean	Указывает, является ли этот диалог прямым сообщением между двумя пользователями.
Группировать прямое сообщение	is_mpim	boolean	Указывает, является ли этот диалог прямым сообщением группы.
Является частным	is_private	boolean	Является ли этот разговор частным.
архивирован	is_archived	boolean	Архивирована ли эта беседа.
Является членом	is_member	boolean	Является ли прошедший проверку подлинности пользователем членом этой беседы.
Идентификатор пользователя	user	string	Для прямых сообщений идентификатор другого пользователя в беседе.
Member Count (количество участников)	num_members	integer	Количество участников в этой беседе.

ListChannels_Response

Имя.	Путь	Тип	Описание
channels	channels	array of Channel
Следующий курсор	response_metadata.next_cursor	string	Курсор для передачи следующему запросу. Пусто, если нет дополнительных результатов.

ListChannels_ResponseV3

Имя.	Путь	Тип	Описание
value	value	array of Channel

SlackMessage

Сообщение, размещенное в беседе Slack.

Имя.	Путь	Тип	Описание
Идентификатор сообщения	ts	string	Уникальный идентификатор метки времени сообщения.
Идентификатор автора	user	string	Идентификатор пользователя, который опубликовал сообщение. Используйте профиль пользователя, чтобы разрешить это пользователю.
Текст сообщения	text	string	Текст сообщения.
Тип сообщения	type	string	Тип сообщения.
Идентификатор потока	thread_ts	string	Метка времени родительского сообщения, если это сообщение является частью потока.
Число ответов	reply_count	integer	Число ответов на это сообщение, если он запускает поток.

ListMessages_Response

Имя.	Путь	Тип	Описание
value	value	array of SlackMessage

SlackUserProfile

Дополнительные сведения о профиле для пользователя Slack.

Имя.	Путь	Тип	Описание
Отображаемое имя	display_name	string	Отображаемое имя, выбранное пользователем для своего профиля.
Реальное имя	real_name	string	Имя и фамилия пользователя.
Email	email	string	Адрес электронной почты пользователя.
URL-адрес аватара	image_72	string	URL-адрес версии 72x72 пикселя аватара пользователя.

SlackUser

Пользователь Slack.

Имя.	Путь	Тип	Описание
Идентификатор	id	string	Идентификатор пользователя.
Имя пользователя	name	string	Имя пользователя Slack пользователя.
Реальное имя	real_name	string	Имя и фамилия пользователя.
Является ботом	is_bot	boolean	Является ли пользователь ботом.
Деактивирован	deleted	boolean	Деактивирована ли учетная запись пользователя.
Часовой пояс	tz	string	Часовой пояс пользователя, доступный для чтения.
Profile	profile	SlackUserProfile	Дополнительные сведения о профиле для пользователя Slack.

GetUserProfile_Response

Имя.	Путь	Тип	Описание
Результат успешного выполнения	ok	boolean	Указывает, выполнена ли операция успешно.
Пользователь	user	SlackUser	Пользователь Slack.
Сообщения об ошибках	error	string	Сведения об сообщениях об ошибках, если таковые есть.

CreateChannel_Response

Имя.	Путь	Тип	Описание
Channel	channel	Channel	Канал

JoinChannel_Response

Имя.	Путь	Тип	Описание
Уже в канале	already_in_channel	boolean	Указывает, находится ли пользователь в канале или нет.
Channel	channel	Channel	Канал

JoinChannel_ResponseV2

Имя.	Путь	Тип	Описание
Channel	channel	Channel	Канал
Предупреждение	warning	string	Указывает, находится ли пользователь в канале или нет.

PostMessageResponse

Сведения о сообщении, размещенном в канале Slack.

Имя.	Путь	Тип	Описание
Результат успешного выполнения	ok	boolean	Указывает, выполнена ли операция успешно.
Channel	channel	string	Канал, в который было отправлено сообщение.
Время создания	ts	string	Метка времени Unix для момента создания сообщения.
Тип сообщения	message.type	string	Тип сообщения.
Текст сообщения	message.text	string	Текст сообщения.
Время создания	message.ts	string	Метка времени Unix для момента создания сообщения.
Сообщения об ошибках	error	string	Сведения об сообщениях об ошибках, если таковые есть.