Получить письма

Элемент получает письма из указанной папки почтового ящика Microsoft 365 и сохраняет их в переменную типа List<Message> вместе с вложениями. Для корректной работы следует поместить элемент в контейнер Microsoft 365.

Свойства

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

Важно: Значение Папки по умолчанию "Inbox" подходит только для англоязычного ящика. Для русскоязычного ящика укажите "Входящие".

Условия отбора

Свойство Запрос задает условие по свойствам письма. Строковые значения указываются в одинарных кавычках, даты — в формате ISO 8601 (UTC).

При включенном свойстве Только непрочтенные оно объединяется с Запросом через and.

Практические примеры

Пример 1: непрочитанные письма из папки «Входящие»

• Учетная запись: "robot@company.ru"
• Папка: "Входящие"
• Кол-во: 20
• Только непрочтенные: включено
• Пометить прочитанными: включено
• Результат: messages

Количество полученных писем — messages.Count, тема первого письма — messages[0].Subject.

Пример 2: письма от банка с вложениями за последние сутки

• Папка: "Входящие"
• Запрос: "from/emailAddress/address eq 'bank@bank.ru' and hasAttachments eq true and receivedDateTime ge " + DateTime.UtcNow.AddDays(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
• Только непрочтенные: выключено
• Сортировка: OldFirst

Пример 3: сохранение вложений на диск

После элемента с результатом messages добавьте элемент выполнения кода:

foreach (var m in messages)
{
    if (m.Attachments == null) continue;
    foreach (var a in m.Attachments.OfType<Microsoft.Graph.Models.FileAttachment>())
        System.IO.File.WriteAllBytes(System.IO.Path.Combine(@"C:\Robot\Inbox", a.Name), a.ContentBytes);
}

Сохраняются файловые вложения. Вложенные письма и ссылки на облачные файлы пропускаются.

Рекомендации

• Ограничивайте выборку свойствами Кол-во и Запрос: элемент загружает вложения каждого письма, и большие выборки обрабатываются долго.
• Чтобы не обрабатывать одно письмо повторно, после обработки перемещайте его в отдельную папку элементом Переместить письмо или отмечайте категорией элементом Установить категории письма.

Возможные ошибки