Skip to content

[Outlook] (requirement set) Mailbox 1.14 support on Mac #5143

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

[Outlook] (requirement set) Mailbox 1.14 support on Mac #5143

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 4 additions & 12 deletions docs/outlook/smart-alerts-onmessagesend-walkthrough.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Automatically check for an attachment before a message is sent
description: Learn how to implement an event-based add-in that implements Smart Alerts to automatically check a message for an attachment before it's sent.
ms.date: 03/11/2025
ms.date: 05/06/2025
ms.topic: how-to
ms.localizationpriority: medium
---
Expand Down Expand Up @@ -126,7 +126,7 @@ To configure the manifest, select the tab for the type of manifest you are using
<!-- Event-based activation happens in a lightweight runtime.-->
<Runtimes>
<!-- HTML file including reference to or inline JavaScript event handlers.
This is used by Outlook on the web and on the new Mac UI, and new Outlook on Windows. -->
This is used by Outlook on the web and on Mac, and new Outlook on Windows. -->
<Runtime resid="WebViewRuntime.Url">
<!-- JavaScript file containing event handlers. This is used by classic Outlook on Windows. -->
<Override type="javascript" resid="JSRuntime.Url"/>
Expand Down Expand Up @@ -328,15 +328,15 @@ In this scenario, you'll add handling for sending a message. Your add-in will ch

> [!NOTE]
>
> Support to customize a button in the Smart Alerts dialog was introduced in [requirement set 1.14](/javascript/api/requirement-sets/outlook/requirement-set-1.14/outlook-requirement-set-1.14). Learn more about its [supported clients and platforms](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#outlook-client-support).
> Support to customize a button in the Smart Alerts dialog and program it to open a task pane was introduced in [requirement set 1.14](/javascript/api/requirement-sets/outlook/requirement-set-1.14/outlook-requirement-set-1.14). The ability to program a button to run a function was introduced in [requirement set 1.15](/javascript/api/requirement-sets/outlook/requirement-set-1.15/outlook-requirement-set-1.15). Learn more about its [supported clients and platforms](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#outlook-client-support).

If a mail item doesn't meet the conditions of a Smart Alerts add-in, a dialog is shown to the user to alert them that additional actions may be needed before an item can be sent. To provide the user with further guidance on how to meet the conditions of your add-in, you can customize the text of a button in the dialog and program it to open a task pane or run a function.

The button you can customize depends on the Outlook client and version on which the add-in is running.

| Client | Customizable dialog button | Specifications |
| --- | --- | --- |
| **Windows (classic)**<br>[Supported Mailbox 1.14 versions](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#version-support-for-requirement-sets-in-classic-outlook-on-windows) prior to Version 2412 (Build 18324.20000)<br><br>**Mac (preview)** | **Don't Send** | The text and functionality of the **Don't Send** button can be customized. Customizable functionality includes opening a task pane or running a function.<br><br>The **Don't Send** button appears in the dialog no matter what send mode option you select. By default, selecting **Don't Send** cancels the send operation and closes the dialog.<br><br>![Smart Alerts dialog with the Don't Send button.](../images/outlook-smart-alerts-dont-send.png) |
| **Windows (classic)**<br>[Supported Mailbox 1.14 versions](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#version-support-for-requirement-sets-in-classic-outlook-on-windows) prior to Version 2412 (Build 18324.20000)<br><br>**Mac<br>//TODO** | **Don't Send** | The text and functionality of the **Don't Send** button can be customized. Customizable functionality includes opening a task pane or running a function.<br><br>The **Don't Send** button appears in the dialog no matter what send mode option you select. By default, selecting **Don't Send** cancels the send operation and closes the dialog.<br><br>![Smart Alerts dialog with the Don't Send button.](../images/outlook-smart-alerts-dont-send.png) |
| **Web browser**<br><br>**Windows (new)**<br><br>**Windows (classic)**<br>Version 2412 (Build 18324.20000) or later | **Take Action** | The text and functionality of the **Take Action** button can be customized. Customizable functionality includes opening a task pane or running a function.<br><br>The **Take Action** button only appears in the Smart Alerts dialog when you configure a task pane or function to run from the dialog. When the **Take Action** button is present, the **Don't Send** button is used to cancel the mail item being sent. The text and functionality of the **Don't Send** button can't be customized.<br><br>![Smart Alerts dialog with the Take Action button.](../images/outlook-smart-alerts-take-action.png) |

> [!NOTE]
Expand Down Expand Up @@ -633,14 +633,6 @@ To further streamline a user's experience when recommending changes to the mail
<script type="text/javascript" src="../launchevent/launchevent.js"></script>
```

> [!IMPORTANT]
> The dialog button customization and send mode option override features are currently in preview in Outlook on Mac. If you're testing these features in your add-in project, you must include a reference to the preview version of the Office JavaScript API in your **commands.html** file.
>
> ```html
> <script type="text/javascript" src="https://appsforoffice.microsoft.com/lib/beta/hosted/office.js"></script>
> <script type="text/javascript" src="../launchevent/launchevent.js"></script>
> ```

1. Save your changes.

## Update webpack config settings
Expand Down
20 changes: 4 additions & 16 deletions docs/outlook/spam-reporting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Implement an integrated spam-reporting add-in
description: Learn how to implement an integrated spam-reporting add-in in Outlook.
ms.date: 03/11/2025
ms.date: 05/06/2025
ms.topic: how-to
ms.localizationpriority: medium
---
Expand All @@ -17,7 +17,7 @@ The integrated spam-reporting feature eases the task of developing individual ad
- Enable an organization's security operations center (SOC) or IT administrators to easily perform spam and phishing simulations for educational purposes.

> [!NOTE]
> Integrated spam reporting was introduced in [Mailbox requirement set 1.14](/javascript/api/requirement-sets/outlook/requirement-set-1.14/outlook-requirement-set-1.14). For information on client support for this feature, see [Supported clients](#supported-clients).
> Integrated spam reporting was introduced in [Mailbox requirement set 1.14](/javascript/api/requirement-sets/outlook/requirement-set-1.14/outlook-requirement-set-1.14). Additional functionality was also added to subsequent requirement sets. To verify that an Outlook client supports these features, see [Supported clients](#supported-clients) and the relevant sections of this article for the features you want to implement.

## Supported clients

Expand All @@ -28,17 +28,13 @@ The following table identifies which Outlook clients support the integrated spam
| **Outlook on the web** | Supported\* |
| [new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) | Supported\* |
| **classic Outlook on Windows**<br>Version 2404 (Build 17530.15000) | Supported |
| **Outlook on Mac**<br>Version 16.81 (23121700) or later | Preview (see [Preview the integrated spam-reporting feature in Outlook on Mac](#preview-the-integrated-spam-reporting-feature-in-outlook-on-mac)) |
| **Outlook on Mac**<br>//TODO| Supported |
| **Outlook on Android** | Not available |
| **Outlook on iOS** | Not available |

> [!NOTE]
> \* In Outlook on the web and the new Outlook on Windows, the integrated spam-reporting feature isn't supported for Microsoft 365 consumer accounts.

## Preview the integrated spam-reporting feature in Outlook on Mac

To preview the integrated spam-reporting feature in Outlook on Mac, you must install Version 16.81.1217.0 or later. Then, join the [Microsoft 365 Insider program](https://techcommunity.microsoft.com/blog/microsoft365insiderblog/join-the-microsoft-365-insider-program-on-macos/4206727) and select the **Beta Channel** option to access Office beta builds.

## Set up your environment

> [!TIP]
Expand Down Expand Up @@ -204,7 +200,7 @@ The following is an example of a **\<VersionOverrides\>** node configured for sp
<Host xsi:type="MailHost">
<Runtimes>
<!-- References the HTML file that links to the spam-reporting event handler.
This is used by Outlook on the web and on the new Mac UI, and new Outlook on Windows. -->
This is used by Outlook on the web and on Mac, and new Outlook on Windows. -->
<Runtime resid="WebViewRuntime.Url">
<!-- References the JavaScript file that contains the spam-reporting event handler. This is used by classic Outlook on Windows. -->
<Override type="javascript" resid="JSRuntime.Url"/>
Expand Down Expand Up @@ -436,14 +432,6 @@ The following is a sample post-processing dialog shown to the user once the add-
<script type="text/javascript" src="../spamreporting/spamreporting.js"></script>
```

> [!NOTE]
> The integrated spam-reporting feature is currently in preview in Outlook on Mac. If you're testing the feature in this client, you must include a reference to the preview version of the Office JavaScript API in your **commands.html** file.
>
> ```html
> <script type="text/javascript" src="https://appsforoffice.microsoft.com/lib/beta/hosted/office.js"></script>
> <script type="text/javascript" src="../spamreporting/spamreporting.js"></script>
> ```

1. Save your changes.

## Update the webpack config settings
Expand Down