Почта групп Office 365

Соединитель Office 365 Groups Mail позволяет пользователям работать с данными, расположенными в почтовом ящике группы Office 365. Функциональные возможности этого соединителя работают независимо от личного почтового ящика одного пользователя и позволяют пользователям работать с любой группой, к которым они могут обращаться в организации. Соединитель работает с API Microsoft Graph и использует терминологию, указанную в документации по группам Office 365 в API Graph. Дополнительные сведения см. в документации по соединителю.

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

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate
Логические приложения Стандарт Все регионы Logic Apps
Power Apps Стандарт Все регионы Power Apps
Power Automate Стандарт Все регионы Power Automate
Контакт
Имя Microsoft
URL Поддержка Microsoft LogicApps
Поддержка Microsoft Power Automate
Поддержка Microsoft Power Apps
Метаданные соединителя
Publisher Microsoft
Website https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
Категории Продуктивность

Предпосылки

Чтобы использовать этот соединитель, вам потребуется учетная запись пользователя с доступом к группам Office 365 в организации.

Мы также рекомендуем ознакомиться с документацией по API Microsoft Graph для групп Microsoft 365, чтобы понять, как данные структурированы в API. Существует ключевая терминология, которая должна быть рассмотрена перед использованием этого соединителя, например "беседа", "поток" и "post".

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

Для устранения неполадок с ошибкой "Указанный объект не найден в хранилище", можно выполнить следующее:

  • Проверьте разрешения для учетной записи.
  • Попробуйте удалить текущее подключение Office 365 Groups Mail и создать новый.

Доступ к "общедоступным" группам без членства

Прошедший проверку подлинности пользователь может получить доступ к данным группы из групп, которые они являются членом и любой общедоступной группой в своей организации. В интерфейсе соединителя при выборе группы соединитель предлагает динамический раскрывающийся список групп для выбора. Для более чистого интерфейса этот раскрывающийся список автоматически заполняется только группами, в которые входит пользователь, прошедший проверку подлинности.

Чтобы получить доступ к группам Public в вашей организации, которые не заполнены в раскрывающемся списке, необходимо указать идентификатор группы в раскрывающемся списке соединителя, прокрутив до самого нижнего края и выбрав ввести настраиваемое значение.

Чтобы найти идентификатор группы в организации, выполните следующие действия.

  1. Перейдите в Microsoft Graph Explorer и выполните проверку подлинности с помощью пользователя в левом верхнем углу.

  2. В разделе "Примеры запросов" выберите "Группы" и "ПОЛУЧИТЬ все группы" в моей организации.

  3. В предварительной версии ответа найдите группу в организации, которую вы ищете. Укажите значение в свойстве в качестве настраиваемого значения в id раскрывающемся списке соединителя.

  4. Убедитесь, что видимость группы задана как общедоступная или пользователь не сможет получить доступ к данным в группе.

  5. Если вы не можете найти группу, может потребоваться просмотреть на следующей странице результатов, к которой можно получить доступ, скопировать ссылку @odata.nextLink и запустить ее в качестве запроса в верхней части страницы.

Триггеры почты

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

Сведения об нерекомендуемом состоянии

Операция "Пересылать пост" временно устарела из-за отсутствия поддержки управления кражей электронной почты для этого соединителя. Мы работаем над предоставлением поддержки и обновим операцию после завершения.

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

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

Действия

Вывод списка бесед группы

Получите все беседы в этой группе.
Вывод списка вложений записи

Получение списка вложений, принадлежащих записи.
Вывод списка записей потока беседы

Получение всех записей указанного потока беседы.
Вывод списка потоков беседы

Получите все потоки в групповой беседе.
Запустите новую групповую беседу, создав поток

Запустите новую групповую беседу, сначала создав поток.
Ответ на поток беседы

Ответьте на поток в групповой беседе и добавьте в него новую запись.
Ответ на сообщение

Ответьте на запись и добавьте новую запись в указанный поток в групповой беседе.
Отправка HTTP-запроса

Создайте запрос REST API Microsoft Graph для вызова. Подробнее: https://docs.microsoft.com/en-us/graph/use-the-api
Переадресация записи (предварительная версия)

Переадресация записи получателю.
Переадресация записи [не рекомендуется]

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

Переадресация записи получателю.
Перечисление потоков группы

Получение всех потоков группы.
Получение групповой беседы

Извлекает свойства определенной беседы.
Получение записи потока

Извлекает запись в указанном потоке.
Получение потока беседы

Получите определенный поток, принадлежащий группе.
Создание беседы в группе

Создайте беседу в этой группе.
Создание потока беседы

Создайте новый поток в указанной беседе.
Удаление потока беседы

Удаляет указанный поток беседы.

Вывод списка бесед группы

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

Получите все беседы в этой группе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.

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

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

Вывод списка вложений записи

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

Получение списка вложений, принадлежащих записи.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Идентификатор потока
 threadId True string

Введите идентификатор потока беседы.
Идентификатор публикации
 postId True string

Введите идентификатор записи.

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

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

Массив, содержащий вложения записи.

Вывод списка записей потока беседы

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

Получение всех записей указанного потока беседы.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Идентификатор потока
 threadId True string

Введите идентификатор потока беседы.

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

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

Массив, содержащий записи в указанном потоке.

Вывод списка потоков беседы

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

Получите все потоки в групповой беседе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
ID разговора
 conversationId True string

Введите идентификатор беседы.

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

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

Запустите новую групповую беседу, создав поток

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

Запустите новую групповую беседу, сначала создав поток.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Новый раздел
 topic True string

Тема нового диалога.
Content
 content True html

Содержимое нового диалога.
Категории
 categories array of string

Категории, связанные с записью.
Address
 Address email

Адрес электронной почты.
Имя вложения
 Name True string

Название вложения.
Содержимое вложения
 ContentBytes True byte

Содержимое вложения.

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

Тело
NewConversationThreadResponse

Ответ на поток беседы

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

Ответьте на поток в групповой беседе и добавьте в него новую запись.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Идентификатор потока
 threadId True string

Введите идентификатор потока беседы.
Content
 content True html

Содержимое нового диалога.
Категории
 categories array of string

Категории, связанные с записью.
Address
 Address email

Адрес электронной почты.
Имя вложения
 Name True string

Название вложения.
Содержимое вложения
 ContentBytes True byte

Содержимое вложения.

Ответ на сообщение

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

Ответьте на запись и добавьте новую запись в указанный поток в групповой беседе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Идентификатор потока
 threadId True string

Введите идентификатор потока беседы.
Идентификатор публикации
 postId True string

Введите идентификатор записи.
Content
 content True html

Содержимое нового диалога.
Категории
 categories array of string

Категории, связанные с записью.
Address
 Address email

Адрес электронной почты.
Имя вложения
 Name True string

Название вложения.
Содержимое вложения
 ContentBytes True byte

Содержимое вложения.

Отправка HTTP-запроса

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

Создайте запрос REST API Microsoft Graph для вызова. Подробнее: https://docs.microsoft.com/en-us/graph/use-the-api

Параметры

Имя Ключ Обязательно Тип Описание
URI
 Uri True string

Полный или относительный универсальный код ресурса (URI). Пример: https://graph.microsoft.com/{version}/{resource}.
Метод
 Method True string

Метод HTTP (по умолчанию — GET).
Тело
 Body binary

Содержимое текста запроса.
Тип контента
 ContentType string

Заголовок типа контента для текста (по умолчанию — application/json).
CustomHeader1
 CustomHeader1 string

Пользовательский заголовок 1. Укажите в формате: header-name: header-value
CustomHeader2
 CustomHeader2 string

Пользовательский заголовок 2. Укажите в формате: header-name: header-value
CustomHeader3
 CustomHeader3 string

Пользовательский заголовок 3. Укажите в формате: header-name: header-value
CustomHeader4
 CustomHeader4 string

Пользовательский заголовок 4. Укажите в формате: header-name: header-value
CustomHeader5
 CustomHeader5 string

Пользовательский заголовок 5. Укажите в формате: header-name: header-value

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

response
ObjectWithoutType

Переадресация записи (предварительная версия)

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

Переадресация записи получателю.

Параметры

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

Выберите группу из раскрывающегося списка или введите адрес электронной почты группы.
ID разговора
 conversationId True string

Введите идентификатор беседы.
Идентификатор потока
 threadId True string

Введите идентификатор потока беседы.
Идентификатор публикации
 postId True string

Введите идентификатор записи.
Комментарий
 Comment html

Комментарий для пересылки с записью.
Address
 Address email

Адрес электронной почты.

Переадресация записи [не рекомендуется]

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

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

Переадресация записи получателю.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Идентификатор потока
 threadId True string

Введите идентификатор потока беседы.
Идентификатор публикации
 postId True string

Введите идентификатор записи.
Комментарий
 comment string

Комментарий для пересылки с записью.
Address
 Address email

Адрес электронной почты.

Перечисление потоков группы

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

Получение всех потоков группы.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.

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

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

Получение групповой беседы

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

Извлекает свойства определенной беседы.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
ID разговора
 conversationId True string

Введите идентификатор беседы.

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

Объект Conversation.

Тело
Conversation

Получение записи потока

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Идентификатор потока
 threadId True string

Введите идентификатор потока беседы.
Идентификатор публикации
 postId True string

Введите идентификатор записи.

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

Представляет отдельный элемент Post в сущности conversationThread.

Тело
Post

Получение потока беседы

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

Получите определенный поток, принадлежащий группе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Идентификатор потока
 threadId True string

Введите идентификатор потока беседы.

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

Объект потока беседы.

Тело
ConversationThread

Создание беседы в группе

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

Создайте беседу в этой группе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Новый раздел
 topic True string

Тема нового диалога.
Content
 content True html

Содержимое нового диалога.
Категории
 categories array of string

Категории, связанные с записью.
Address
 Address email

Адрес электронной почты.
Имя вложения
 Name True string

Название вложения.
Содержимое вложения
 ContentBytes True byte

Содержимое вложения.

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

Ответ со сведениями о созданном диалоге.

Созданный объект беседы
CreateConversationResponse

Создание потока беседы

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

Создайте новый поток в указанной беседе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
ID разговора
 conversationId True string

Введите идентификатор беседы.
Новый раздел
 topic True string

Тема нового диалога.
Content
 content True html

Содержимое нового диалога.
Категории
 categories array of string

Категории, связанные с записью.
Address
 Address email

Адрес электронной почты.
Имя вложения
 Name True string

Название вложения.
Содержимое вложения
 ContentBytes True byte

Содержимое вложения.

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

Тело
NewConversationThreadResponse

Удаление потока беседы

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

Удаляет указанный поток беседы.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.
Идентификатор потока
 threadId True string

Введите идентификатор потока беседы.

Триггеры

Когда новое сообщение электронной почты поступает в группу

Когда новая электронная почта поступает в группу.

Когда новое сообщение электронной почты поступает в группу

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

Когда новая электронная почта поступает в группу.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор группы
 groupId True string

Выберите группу из раскрывающегося списка или введите идентификатор группы.

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

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

Ответ триггера.

Определения

Беседа

Объект Conversation.

Имя Путь Тип Описание
ID разговора
 id string

Уникальный идентификатор беседы.
Раздел беседы
 topic string

Тема беседы.
Есть вложения?
 hasAttachments boolean

Указывает, имеет ли любой из записей в этой беседе хотя бы одно вложение.
Метка времени последней доставки
 lastDeliveredDateTime date-time

Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC).
Массив уникальных отправителей
 uniqueSenders array of string

Все пользователи, отправляющие сообщение в эту беседу.
Preview
 preview string

Краткая сводка из текста последней записи в этой беседе.

ConversationThread

Объект потока беседы.

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

Уникальный идентификатор потока беседы.
Раздел беседы
 topic string

Тема беседы.
Есть вложения?
 hasAttachments boolean

Указывает, имеет ли любой из записей в этой беседе хотя бы одно вложение.
Метка времени последней доставки
 lastDeliveredDateTime date-time

Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC).
Массив уникальных отправителей
 uniqueSenders array of string

Все пользователи, отправляющие сообщение в эту беседу.
Preview
 preview string

Краткая сводка из текста последней записи в этой беседе.
Заблокировано?
 isLocked boolean

Указывает, заблокирован ли поток.
toRecipients
 toRecipients array of EmailAddress

Получатели потока.
ccRecipients
 ccRecipients array of EmailAddress

Копия: получатели для потока.

Пост

Представляет отдельный элемент Post в сущности conversationThread.

Имя Путь Тип Описание
Идентификатор публикации
 id string

Уникальный идентификатор записи.
Созданная метка времени записи
 createdDateTime date-time
Последняя измененная метка времени записи
 lastModifiedDateTime date-time
Изменение ключа
 changeKey string

Определяет версию записи.
ID разговора
 conversationId string

Уникальный идентификатор беседы, к которой принадлежит запись.
Идентификатор потока беседы
 conversationThreadId string

Уникальный идентификатор потока беседы, к которому принадлежит запись.
Категории
 categories array of string

Категории, связанные с записью.
Полученная метка времени
 receivedDateTime date-time

После получения метки времени.
Есть вложения?
 hasAttachments boolean

Указывает, имеет ли запись по крайней мере одно вложение.
Новые участники
 newParticipants array of EmailAddress

Участники беседы, добавленные в поток в рамках этой записи.
body
 body ItemBody

Представляет свойства текста элемента, например сообщения, события или записи группы.
от / из / с (context-dependent)
 from EmailAddress
отправитель;
 sender EmailAddress
attachments
 attachments array of Attachment

Attachment

Имя Путь Тип Описание
Идентификатор вложения
 id string

Идентификатор вложения.
Имя вложения
 name string

Имя вложения.
Тип содержимого вложения
 contentType string

Тип содержимого вложения.
Размер вложения
 size integer

Размер вложения.
Содержимое вложения байт
 contentBytes byte

Содержимое вложения.

Электронный адрес

Имя Путь Тип Описание
Имя пользователя
 emailAddress.name string
Адрес электронной почты пользователя
 emailAddress.address email

ItemBody

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

Имя Путь Тип Описание
Тип содержимого текста
 contentType string

Тип контента текста.
Содержимое текста
 content string

Содержимое текста.

CreateConversationResponse

Ответ со сведениями о созданном диалоге.

Имя Путь Тип Описание
ID разговора
 id string

Новый идентификатор беседы.
Потоки беседы
 threads array of object

Создан поток беседы.
Идентификатор потока
 threads.id string

Новый идентификатор потока.

NewConversationThreadResponse

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

Новый идентификатор потока беседы.

ConversationTriggerResponse

При поступлении ответа триггера нового сообщения электронной почты.

Имя Путь Тип Описание
ID разговора
 id string

Уникальный идентификатор беседы.
Метка времени последней доставки
 lastDeliveredDateTime date-time

Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC).
threads
 threads array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

Объект потока беседы.

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

Уникальный идентификатор потока беседы.
posts
 posts array of PostTriggerResponse

PostTriggerResponse

Представляет отдельный элемент Post в сущности conversationThread.

Имя Путь Тип Описание
Идентификатор публикации
 id string

Уникальный идентификатор записи.
Последняя измененная метка времени записи
 lastModifiedDateTime date-time
Изменение ключа
 changeKey string

Определяет версию записи.

ObjectWithoutType