Microsoft Teams

Microsoft Teams — чаты и каналы организации. Блок читает и пишет сообщения, ставит реакции и смотрит состав команды.

С Microsoft Teams в Pailot вы можете:

Читать и писать сообщения в чат и канал, в том числе с файлами
Править и мягко удалять сообщения
Отвечать в тред канала
Ставить и снимать эмодзи-реакции
Смотреть участников команды и канала
Запускать процесс по новому сообщению в чате или канале

Чтобы упомянуть человека в тексте, оберните имя в теги <at>имя</at>.

Нужен вход по OAuth (вход по разрешению сервиса) Microsoft 365. Если сервис шлёт события, включите режим триггера и скопируйте URL вебхука (входящего HTTP-запроса). Не публикуйте URL.

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

Параметр	Тип	Обязательный	Описание
`chatId`	string	Да	ID чата
`includeAttachments`	boolean	Нет	Скачать вложения сообщений в хранилище

Выход

Параметр	Тип	Описание
`success`	boolean	Успешность чтения чата
`messageCount`	number	Сколько сообщений получено
`chatId`	string	ID прочитанного чата
`messages`	array	Сообщения чата
`attachmentCount`	number	Всего вложений
`attachmentTypes`	array	Типы вложений
`content`	string	Отформатированный текст сообщений
`attachments`	file[]	Вложения одним списком

`microsoft_teams_write_chat`

Написать или обновить сообщение в чате Microsoft Teams.

Вход

Параметр	Тип	Обязательный	Описание
`chatId`	string	Да	ID чата
`content`	string	Да	Текст сообщения
`files`	file[]	Нет	Файлы-вложения

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли отправить сообщение
`messageId`	string	ID отправленного сообщения
`chatId`	string	ID чата
`createdTime`	string	Время создания
`url`	string	Ссылка на сообщение
`updatedContent`	boolean	Удалось ли обновить содержимое

`microsoft_teams_read_channel`

Прочитать сообщения канала Microsoft Teams.

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Да	ID команды
`channelId`	string	Да	ID канала
`includeAttachments`	boolean	Нет	Скачать вложения сообщений в хранилище

Выход

Параметр	Тип	Описание
`success`	boolean	Успешность чтения канала
`messageCount`	number	Сколько сообщений получено
`teamId`	string	ID команды
`channelId`	string	ID канала
`messages`	array	Сообщения канала
`attachmentCount`	number	Всего вложений
`attachmentTypes`	array	Типы вложений
`content`	string	Отформатированный текст сообщений
`attachments`	file[]	Вложения одним списком

`microsoft_teams_write_channel`

Отправить сообщение в канал Microsoft Teams.

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Да	ID команды
`channelId`	string	Да	ID канала
`content`	string	Да	Текст сообщения
`files`	file[]	Нет	Файлы-вложения

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли отправить сообщение
`messageId`	string	ID отправленного сообщения
`teamId`	string	ID команды
`channelId`	string	ID канала
`createdTime`	string	Время создания
`url`	string	Ссылка на сообщение
`updatedContent`	boolean	Удалось ли обновить содержимое

`microsoft_teams_update_chat_message`

Изменить существующее сообщение в чате.

Вход

Параметр	Тип	Обязательный	Описание
`chatId`	string	Да	ID чата
`messageId`	string	Да	ID сообщения
`content`	string	Да	Новый текст

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли обновить сообщение
`messageId`	string	ID сообщения
`updatedContent`	boolean	Удалось ли обновить содержимое

`microsoft_teams_update_channel_message`

Изменить существующее сообщение в канале.

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Да	ID команды
`channelId`	string	Да	ID канала
`messageId`	string	Да	ID сообщения
`content`	string	Да	Новый текст

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли обновить сообщение
`messageId`	string	ID сообщения
`updatedContent`	boolean	Удалось ли обновить содержимое

`microsoft_teams_delete_chat_message`

Мягко удалить сообщение в чате.

Вход

Параметр	Тип	Обязательный	Описание
`chatId`	string	Да	ID чата
`messageId`	string	Да	ID сообщения

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли удалить сообщение
`deleted`	boolean	Подтверждение удаления
`messageId`	string	ID удалённого сообщения

`microsoft_teams_delete_channel_message`

Мягко удалить сообщение в канале.

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Да	ID команды
`channelId`	string	Да	ID канала
`messageId`	string	Да	ID сообщения

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли удалить сообщение
`deleted`	boolean	Подтверждение удаления
`messageId`	string	ID удалённого сообщения

`microsoft_teams_reply_to_message`

Ответить на сообщение в канале.

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Да	ID команды
`channelId`	string	Да	ID канала
`messageId`	string	Да	ID сообщения, на которое отвечаете
`content`	string	Да	Текст ответа

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли отправить ответ
`messageId`	string	ID ответа
`updatedContent`	boolean	Удалось ли отправить содержимое

`microsoft_teams_get_message`

Одно сообщение из чата или канала.

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Нет	ID команды (для сообщений канала)
`channelId`	string	Нет	ID канала (для сообщений канала)
`chatId`	string	Нет	ID чата (для сообщений чата)
`messageId`	string	Да	ID сообщения

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли получить сообщение
`content`	string	Текст сообщения
`metadata`	object	Служебные данные: отправитель, время и др.
↳ `messageId`	string	ID сообщения
↳ `content`	string	Текст сообщения
↳ `createdTime`	string	Время создания
↳ `url`	string	Ссылка на сообщение
↳ `teamId`	string	ID команды
↳ `channelId`	string	ID канала
↳ `chatId`	string	ID чата
↳ `messages`	array	Детали сообщений
↳ `messageCount`	number	Число сообщений

`microsoft_teams_set_reaction`

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

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Нет	ID команды (для сообщений канала)
`channelId`	string	Нет	ID канала (для сообщений канала)
`chatId`	string	Нет	ID чата (для сообщений чата)
`messageId`	string	Да	ID сообщения
`reactionType`	string	Да	Эмодзи (например ❤️, 👍, 😊)

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли поставить реакцию
`reactionType`	string	Поставленный эмодзи
`messageId`	string	ID сообщения

`microsoft_teams_unset_reaction`

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

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Нет	ID команды (для сообщений канала)
`channelId`	string	Нет	ID канала (для сообщений канала)
`chatId`	string	Нет	ID чата (для сообщений чата)
`messageId`	string	Да	ID сообщения
`reactionType`	string	Да	Эмодзи, который снять (например ❤️, 👍, 😊)

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли снять реакцию
`reactionType`	string	Снятый эмодзи
`messageId`	string	ID сообщения

`microsoft_teams_list_team_members`

Все участники команды Microsoft Teams.

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Да	ID команды

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли получить список
`members`	array	Участники команды
`memberCount`	number	Всего участников

`microsoft_teams_list_channel_members`

Все участники канала Microsoft Teams.

Вход

Параметр	Тип	Обязательный	Описание
`teamId`	string	Да	ID команды
`channelId`	string	Да	ID канала

Выход

Параметр	Тип	Описание
`success`	boolean	Удалось ли получить список
`members`	array	Участники канала
`memberCount`	number	Всего участников

Microsoft Teams

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