Slack

Slack — корпоративный мессенджер: каналы, личные сообщения, файлы и совместные документы (canvas).

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

Отправлять, править и удалять сообщения бота (разметка mrkdwn)
Читать историю канала, одно сообщение и всю ветку
Добавлять реакции, создавать canvas, скачивать файлы
Смотреть каналы, участников и профили
Запускать процесс как триггер при сообщении в канале (вебхук — входящий HTTP-запрос)

Вход: OAuth (вход по разрешению сервиса) или Bot Token в расширенном режиме. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. URL вебхука не публикуйте.

Инструменты

`slack_message`

Отправить сообщение в канал или личку. Поддерживается разметка Slack mrkdwn.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`channel`	string	Нет	Канал (например #general)
`userId`	string	Нет	ID пользователя для лички (например U1234567890)
`text`	string	Да	Текст (разметка Slack mrkdwn)
`thread_ts`	string	Нет	Метка времени ветки — ответ в тред
`files`	file[]	Нет	Вложения

Выход

Параметр	Тип	Описание
`message`	object	Полный объект сообщения от Slack
`ts`	string	Метка времени сообщения
`channel`	string	ID канала
`fileCount`	number	Число загруженных файлов (если были вложения)

`slack_canvas`

Создать и опубликовать canvas (совместный документ Slack) в канале.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`channel`	string	Да	Канал (например #general)
`title`	string	Да	Заголовок canvas
`content`	string	Да	Содержимое в markdown
`document_content`	object	Нет	Структурированное содержимое документа

Выход

Параметр	Тип	Описание
`canvas_id`	string	ID созданного canvas
`channel`	string	Канал, где создан canvas
`title`	string	Заголовок canvas

`slack_message_reader`

Прочитать последние сообщения канала. История с фильтрами по времени.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`channel`	string	Нет	Канал (например #general)
`userId`	string	Нет	ID пользователя для лички (например U1234567890)
`limit`	number	Нет	Сколько сообщений (по умолчанию 10, макс. 15)
`oldest`	string	Нет	Начало диапазона (метка времени)
`latest`	string	Нет	Конец диапазона (метка времени)

Выход

Параметр	Тип	Описание
`messages`	array	Сообщения канала
↳ `type`	string	Тип сообщения
↳ `ts`	string	Метка времени правки
↳ `text`	string	Текст
↳ `user`	string	ID пользователя, который правил
↳ `bot_id`	string	ID бота, если писал бот
↳ `username`	string	Отображаемое имя
↳ `channel`	string	ID канала
↳ `team`	string	ID команды
↳ `thread_ts`	string	Метка времени родительского сообщения ветки
↳ `parent_user_id`	string	ID автора родительского сообщения
↳ `reply_count`	number	Число ответов в ветке
↳ `reply_users_count`	number	Сколько человек ответило
↳ `latest_reply`	string	Метка времени последнего ответа
↳ `subscribed`	boolean	Подписка на ветку
↳ `last_read`	string	Метка последнего прочтения
↳ `unread_count`	number	Непрочитанных сообщений
↳ `subtype`	string	Подтип сообщения
↳ `reactions`	array	Реакции на сообщение
↳ `name`	string	Имя эмодзи
↳ `count`	number	Число реакций
↳ `users`	array	ID пользователей, поставивших реакцию
↳ `name`	string	Имя файла
↳ `count`	number	Число реакций
↳ `users`	array	ID пользователей, поставивших реакцию
↳ `is_starred`	boolean	Сообщение в избранном
↳ `pinned_to`	array	ID каналов, где сообщение закреплено
↳ `files`	array	Файлы сообщения
↳ `id`	string	ID файла
↳ `name`	string	Имя файла
↳ `mimetype`	string	MIME-тип
↳ `size`	number	Размер в байтах
↳ `url_private`	string	Приватный URL скачивания
↳ `permalink`	string	Постоянная ссылка на файл
↳ `mode`	string	Режим файла
↳ `id`	string	ID файла
↳ `mimetype`	string	MIME-тип
↳ `size`	number	Размер в байтах
↳ `url_private`	string	Приватный URL скачивания
↳ `permalink`	string	Постоянная ссылка на сообщение
↳ `mode`	string	Режим файла
↳ `attachments`	array	Устаревшие вложения
↳ `blocks`	array	Блоки Block Kit
↳ `edited`	object	Данные о правке, если сообщение меняли
↳ `user`	string	ID пользователя, который правил
↳ `ts`	string	Метка времени правки

`slack_get_message`

Получить сообщение по метке времени. Удобно для родительского сообщения ветки.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`channel`	string	Да	ID канала (например C1234567890)
`timestamp`	string	Да	Метка времени сообщения (например 1405894322.002768)

Выход

Параметр	Тип	Описание
`message`	object	Полученное сообщение
↳ `type`	string	Тип сообщения
↳ `ts`	string	Метка времени правки
↳ `text`	string	Текст
↳ `user`	string	ID пользователя, который правил
↳ `bot_id`	string	ID бота, если писал бот
↳ `username`	string	Отображаемое имя
↳ `channel`	string	ID канала
↳ `team`	string	ID команды
↳ `thread_ts`	string	Метка времени родительского сообщения
↳ `parent_user_id`	string	ID автора родительского сообщения
↳ `reply_count`	number	Число ответов в ветке
↳ `reply_users_count`	number	Сколько человек ответило
↳ `latest_reply`	string	Метка времени последнего ответа
↳ `subtype`	string	Подтип сообщения
↳ `reactions`	array	Реакции
↳ `name`	string	Имя эмодзи
↳ `count`	number	Число реакций
↳ `users`	array	ID пользователей, поставивших реакцию
↳ `name`	string	Имя файла
↳ `count`	number	Число реакций
↳ `users`	array	ID пользователей, поставивших реакцию
↳ `is_starred`	boolean	Сообщение в избранном
↳ `pinned_to`	array	ID каналов, где сообщение закреплено
↳ `files`	array	Файлы сообщения
↳ `id`	string	ID файла
↳ `name`	string	Имя файла
↳ `mimetype`	string	MIME-тип
↳ `size`	number	Размер в байтах
↳ `url_private`	string	Приватный URL скачивания
↳ `permalink`	string	Постоянная ссылка на файл
↳ `id`	string	ID файла
↳ `mimetype`	string	MIME-тип
↳ `size`	number	Размер в байтах
↳ `url_private`	string	Приватный URL скачивания
↳ `permalink`	string	Постоянная ссылка на сообщение
↳ `attachments`	array	Устаревшие вложения
↳ `blocks`	array	Блоки Block Kit
↳ `edited`	object	Данные о правке, если сообщение меняли
↳ `user`	string	ID пользователя, который правил
↳ `ts`	string	Метка времени правки

`slack_get_thread`

Вся ветка: родительское сообщение и ответы.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`channel`	string	Да	ID канала (например C1234567890)
`threadTs`	string	Да	Метка времени ветки thread_ts (например 1405894322.002768)
`limit`	number	Нет	Максимум сообщений (по умолчанию 100, макс. 200)

Выход

Параметр	Тип	Описание
`parentMessage`	object	Родительское сообщение ветки
↳ `type`	string	Тип сообщения
↳ `ts`	string	Метка времени
↳ `text`	string	Текст
↳ `user`	string	ID автора
↳ `bot_id`	string	ID бота, если писал бот
↳ `username`	string	Отображаемое имя
↳ `reply_count`	number	Всего ответов в ветке
↳ `reply_users_count`	number	Сколько человек ответило
↳ `latest_reply`	string	Метка времени последнего ответа
↳ `reactions`	array	Реакции на родительское сообщение
↳ `name`	string	Имя эмодзи
↳ `count`	number	Число реакций
↳ `users`	array	ID пользователей, поставивших реакцию
↳ `name`	string	Имя файла
↳ `count`	number	Число реакций
↳ `users`	array	ID пользователей, поставивших реакцию
↳ `files`	array	Файлы родительского сообщения
↳ `id`	string	ID файла
↳ `name`	string	Имя файла
↳ `mimetype`	string	MIME-тип
↳ `size`	number	Размер в байтах
↳ `id`	string	ID файла
↳ `mimetype`	string	MIME-тип
↳ `size`	number	Размер в байтах
`replies`	array	Ответы в ветке (без родителя)
↳ `ts`	string	Метка времени
↳ `text`	string	Текст ответа
↳ `user`	string	ID автора ответа
↳ `reactions`	array	Реакции на ответ
↳ `files`	array	Файлы ответа
`messages`	array	Все сообщения ветки (родитель + ответы) по времени
`replyCount`	number	Число ответов в этом ответе API
`hasMore`	boolean	Есть ещё сообщения (нужна следующая страница)

`slack_list_channels`

Список каналов рабочего пространства. Публичные и приватные, к которым есть доступ у бота.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`includePrivate`	boolean	Нет	Включить приватные каналы, где бот участник (по умолчанию true)
`excludeArchived`	boolean	Нет	Исключить архивные (по умолчанию true)
`limit`	number	Нет	Максимум каналов (по умолчанию 100, макс. 200)

Выход

Параметр	Тип	Описание
`channels`	array	Каналы пространства
↳ `id`	string	ID канала (например C1234567890)
↳ `name`	string	Имя без префикса #
↳ `is_private`	boolean	Приватный канал
↳ `is_archived`	boolean	Канал в архиве
↳ `is_member`	boolean	Бот состоит в канале
↳ `num_members`	number	Число участников
↳ `topic`	string	Тема канала
↳ `purpose`	string	Назначение / описание
↳ `created`	number	Unix-время создания
↳ `creator`	string	ID создателя
`ids`	array	ID каналов
`names`	array	Имена каналов
`count`	number	Сколько каналов вернули

`slack_list_members`

Список участников канала (ID пользователей). Имена — через Get User Info.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`channel`	string	Да	ID канала
`limit`	number	Нет	Максимум участников (по умолчанию 100, макс. 200)

Выход

Параметр	Тип	Описание
`members`	array	ID участников (например U1234567890)
`count`	number	Сколько участников вернули

`slack_list_users`

Список пользователей пространства: профили, имена, аватары.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`includeDeleted`	boolean	Нет	Включить деактивированных (по умолчанию false)
`limit`	number	Нет	Максимум пользователей (по умолчанию 100, макс. 200)

Выход

Параметр	Тип	Описание
`users`	array	Пользователи пространства
↳ `id`	string	ID пользователя (например U1234567890)
↳ `name`	string	Ник (handle)
↳ `real_name`	string	Полное имя
↳ `display_name`	string	Отображаемое имя в Slack
↳ `is_bot`	boolean	Это бот
↳ `is_admin`	boolean	Администратор пространства
↳ `is_owner`	boolean	Владелец пространства
↳ `deleted`	boolean	Пользователь деактивирован
↳ `timezone`	string	Идентификатор часового пояса
↳ `avatar`	string	URL аватара
↳ `status_text`	string	Текст статуса
↳ `status_emoji`	string	Эмодзи статуса
`ids`	array	ID пользователей
`names`	array	Ники
`count`	number	Сколько пользователей вернули

`slack_get_user`

Подробности о пользователе по ID.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`userId`	string	Да	ID пользователя (например U1234567890)

Выход

Параметр	Тип	Описание
`user`	object	Профиль пользователя
↳ `id`	string	ID пользователя
↳ `name`	string	Ник (handle)
↳ `real_name`	string	Полное имя
↳ `display_name`	string	Отображаемое имя в Slack
↳ `first_name`	string	Имя
↳ `last_name`	string	Фамилия
↳ `title`	string	Должность
↳ `phone`	string	Телефон
↳ `skype`	string	Логин Skype
↳ `is_bot`	boolean	Это бот
↳ `is_admin`	boolean	Администратор пространства
↳ `is_owner`	boolean	Владелец пространства
↳ `is_primary_owner`	boolean	Основной владелец
↳ `is_restricted`	boolean	Гость (restricted)
↳ `is_ultra_restricted`	boolean	Гость одного канала
↳ `deleted`	boolean	Пользователь деактивирован
↳ `timezone`	string	Часовой пояс (например America/Los_Angeles)
↳ `timezone_label`	string	Подпись часового пояса
↳ `timezone_offset`	number	Смещение от UTC в секундах
↳ `avatar_24`	string	URL аватара 24px
↳ `avatar_48`	string	URL аватара 48px
↳ `avatar_72`	string	URL аватара 72px
↳ `avatar_192`	string	URL аватара 192px
↳ `avatar_512`	string	URL аватара 512px
↳ `status_text`	string	Текст статуса
↳ `status_emoji`	string	Эмодзи статуса
↳ `status_expiration`	number	Unix-время истечения статуса
↳ `updated`	number	Unix-время последнего обновления профиля

`slack_download`

Скачать файл из Slack.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`fileId`	string	Да	ID файла
`fileName`	string	Нет	Подставить своё имя файла

Выход

Параметр	Тип	Описание
`file`	file	Скачанный файл в файлах выполнения процесса

`slack_update_message`

Изменить сообщение, которое отправил бот.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`channel`	string	Да	ID канала (например C1234567890)
`timestamp`	string	Да	Метка времени сообщения (например 1405894322.002768)
`text`	string	Да	Новый текст (разметка Slack mrkdwn)

Выход

Параметр	Тип	Описание
`message`	object	Обновлённое сообщение от Slack
`content`	string	Сообщение об успехе
`metadata`	object	Метаданные обновлённого сообщения
↳ `channel`	string	ID канала
↳ `timestamp`	string	Метка времени
↳ `text`	string	Обновлённый текст

`slack_delete_message`

Удалить сообщение, которое отправил бот.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`channel`	string	Да	ID канала (например C1234567890)
`timestamp`	string	Да	Метка времени сообщения (например 1405894322.002768)

Выход

Параметр	Тип	Описание
`content`	string	Сообщение об успехе
`metadata`	object	Метаданные удалённого сообщения
↳ `channel`	string	ID канала
↳ `timestamp`	string	Метка времени

`slack_add_reaction`

Поставить эмодзи-реакцию на сообщение.

Вход

Параметр	Тип	Обязательный	Описание
`authMethod`	string	Нет	Способ входа: oauth или bot_token
`botToken`	string	Нет	Токен бота (Custom Bot)
`channel`	string	Да	ID канала (например C1234567890)
`timestamp`	string	Да	Метка времени сообщения (например 1405894322.002768)
`name`	string	Да	Имя эмодзи без двоеточий (например thumbsup, heart, eyes)

Выход

Параметр	Тип	Описание
`content`	string	Сообщение об успехе
`metadata`	object	Метаданные реакции
↳ `channel`	string	ID канала
↳ `timestamp`	string	Метка времени
↳ `reaction`	string	Имя эмодзи

Slack

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