Microsoft 365 Outlook package

The Microsoft 365 Outlook package enables you to automate Outlook emails over Microsoft Outlook server.

Before you start

Microsoft has deprecated EWS API for Exchange Online and has recommended users to move to Graph API.

See Upcoming API Deprecations in Exchange Web Services for Exchange Online.

The Microsoft 365 Outlook package is based on the Graph API and can be used to automate email-related tasks for sending, receiving, and modifying emails and folders in Microsoft 365 Outlook.
注： The integration of Graph API requires an administrator to grant access, after which you can configure an application access policy and limit the scope of application permissions. See Configure application access policy.
注： Limited support is available for Graph API from Microsoft. Therefore. if you are using the Azure US GCC High for Microsoft 365 version, the following actions might be impacted:
  • Forward, Reply and Reply all
  • Send action if you have any attachments
注： Graph API from Microsoft does not support downloading of attachments from emails that contain digital signatures.

Use this package in the following sequence:

  • Use the Connect action to create a session.
  • Use the various actions to automate tasks related to Microsoft 365 Outlook emails.
  • Use the Disconnect action to terminate the connection to the Microsoft Outlook server.
The Microsoft 365 Outlook package supports the email automation of a shared mailbox in Outlook 365. You can automate emails retrieved from a shared mailbox and perform email-related tasks by accessing each folder(s) and its subfolder(s) in the shared mailbox. Ensure the following requirements are met:
  • Administrator has enabled your access to shared mailbox.
  • The required delegated permissions are granted.
  • The shared mailbox is setup in your Microsoft 365 Outlook application.
Review the following table for important proxy considerations while using the Microsoft 365 Outlook package:
Proxy type Description Status
Authenticated Same proxy settings for Control Room URL and Graph API Endpoints Supported
Different proxy credentials for Control Room URL and Graph API Endpoints Not supported
Bypass authenticated proxy for Control Room URL and authenticated proxy settings for Graph API Endpoints Not supported
Unauthenticated Same settings for Control Room URL and Graph API Endpoints Supported
Different proxy settings for Control Room URL and Graph API Endpoints Supported
Combination of Authenticated and Unauthenticated Authenticated proxy for Control Room URL and unauthenticated proxy settings for Graph API Endpoints Supported
Unauthenticated proxy for Control Room URL and authenticated proxy settings for Graph API Endpoints Not supported
None No Proxy found on the Bot Runner machine Supported
注： NTLM authentication for proxy server is available that enables you to connect to Exchange online.

Actions in the Microsoft 365 Outlook package

In the Actions palette on the Bot editor screen, double-click or drag any of the following actions in the Microsoft 365 Outlook package:
Action Description
Change status See Microsoft 365 Outlook package 中的更改状态 action.
Check if folder exists See Microsoft 365 Outlook package 中的检查文件夹是否存在 action.
Connect See 使用 Microsoft 365 Outlook package 中的连接 action.
Delete See 在 Microsoft 365 Outlook package 中删除 action.
Delete all See 在 Microsoft 365 Outlook package 中删除所有 action.
Disconnect See 断开 Microsoft 365 Outlook package 中的 action.
Forward See Microsoft 365 Outlook package 中的转发 action.
Move See Microsoft 365 Outlook package 中的移动 action.
Move all See 移动 Microsoft 365 Outlook package 中的所有 action.
Reply See 在 Microsoft 365 Outlook package 中回复 action.
Reply all See 在 Microsoft 365 Outlook package 中回复所有 action.
Save all attachments See Microsoft 365 Outlook package 中的保存所有附件 action.
Save attachments See 将附件 action 保存在 Microsoft 365 Outlook package 中.
Save email See 将电子邮件 action 保存在 Microsoft 365 Outlook package 中.
Send See 在 Microsoft 365 Outlook package 中发送 action.

File stream support in Microsoft 365 Outlook

The Microsoft 365 Outlook package supports file stream capability. The file stream capability enables you to create, manage, and run API Tasks to send emails with an attachment. The Forward, Reply, Reply all, and Send actions now consume file variables that hold a file stream. The file stream capability also enables you to attach files to emails without the need of downloading them from the data source.

注：
  • The Microsoft 365 subscription determines the maximum allowed file size of an attachment. If you have a Microsoft 365 subscription, the maximum file size allowed for an attachment is 150 MB. If you have an individual Microsoft 365 account, the maximum file size allowed for an attachment is 25 MB.
  • You can also attach multiple files in the email using the list variable. Ensure that the total size of all the attachments does not exceed the size limit set for your Microsoft 365 account.
The following is the high level workflow of how file stream capability works in Microsoft 365 Outlook package.:
  1. Use one of the file stream compatible actions to hold the file stream in a file variable. For more information on file stream compatible actions, see File streaming using file variable.
  2. Create a list variable with File subtype.
  3. Use the Add item action in List package to add the file variable that holds the file stream to the list variable.
  4. Use the updated list variable as an attachment in Attachment option in the settings of Forward, Reply, Reply all, and Send actions.
  5. When you run the automation, the automation streams the file from the data source and adds it as an attachment to the email. The automation sends the email only when the upload is complete. If the upload is not complete, the email remains in the Drafts folder of the mailbox. You must manually delete the email from the Drafts folder and re-run the automation.

The following are some of the error messages that you might encounter when you use any file stream capable Microsoft 365 Outlook actions and their root causes:

Unable to find the filename in file stream metadata. Verify the file stream metadata includes filename, then try again.
If the file name is blank or the file size is 0 KB, the system displays this error message.
Attachment exceeds the 25MB size limit. Upload a smaller file, then try again.
If the overall size of the attachment exceeds 25 MB, the system displays this error message.
Unable to find attachment “%s”. Verify the path, then try again
If the attachment is missing in the source location, the system displays this error message.