diff --git a/docs/images/outlook-smart-alerts-custom-button-and-override.png b/docs/images/outlook-smart-alerts-custom-button-and-override.png new file mode 100644 index 000000000..743ce2eb9 Binary files /dev/null and b/docs/images/outlook-smart-alerts-custom-button-and-override.png differ diff --git a/docs/images/outlook-smart-alerts-custom-take-action.png b/docs/images/outlook-smart-alerts-custom-take-action.png new file mode 100644 index 000000000..ec7c485de Binary files /dev/null and b/docs/images/outlook-smart-alerts-custom-take-action.png differ diff --git a/docs/images/outlook-smart-alerts-dont-send.png b/docs/images/outlook-smart-alerts-dont-send.png new file mode 100644 index 000000000..216597fbe Binary files /dev/null and b/docs/images/outlook-smart-alerts-dont-send.png differ diff --git a/docs/images/outlook-smart-alerts-take-action.png b/docs/images/outlook-smart-alerts-take-action.png new file mode 100644 index 000000000..7fb45c732 Binary files /dev/null and b/docs/images/outlook-smart-alerts-take-action.png differ diff --git a/docs/images/outlook-win-smart-alerts-take-action.png b/docs/images/outlook-win-smart-alerts-take-action.png new file mode 100644 index 000000000..c18c02ecd Binary files /dev/null and b/docs/images/outlook-win-smart-alerts-take-action.png differ diff --git a/docs/outlook/onmessagesend-onappointmentsend-events.md b/docs/outlook/onmessagesend-onappointmentsend-events.md index 6ac39d9fb..24a87e511 100644 --- a/docs/outlook/onmessagesend-onappointmentsend-events.md +++ b/docs/outlook/onmessagesend-onappointmentsend-events.md @@ -1,7 +1,7 @@ --- title: Handle OnMessageSend and OnAppointmentSend events in your Outlook add-in with Smart Alerts description: Learn about the Smart Alerts implementation and how it handles the OnMessageSend and OnAppointmentSend events in your event-based Outlook add-in. -ms.date: 02/13/2025 +ms.date: 03/11/2025 ms.topic: concept-article ms.localizationpriority: medium --- @@ -30,7 +30,13 @@ The following table lists supported client-server combinations for the Smart Ale ## Try out Smart Alerts in an event-based add-in -To see Smart Alerts in action, try out the [walkthrough](smart-alerts-onmessagesend-walkthrough.md). You'll create an add-in that checks whether a document or picture is attached to a message before it's sent. +To see Smart Alerts in action, try out the [walkthrough](smart-alerts-onmessagesend-walkthrough.md). You'll create an add-in that checks whether a document or picture is attached to a message before it's sent. In addition to implementing a basic Smart Alerts add-in, you'll also learn about the following functionalities to further enhance the user experience of your add-in. + +- [Customize the Smart Alerts dialog message using Markdown](smart-alerts-onmessagesend-walkthrough.md#implement-event-handling) +- [Customize the text of a dialog button](smart-alerts-onmessagesend-walkthrough.md#customize-the-text-and-functionality-of-a-button-in-the-dialog-optional) +- [Open a task pane or run a function from the dialog](smart-alerts-onmessagesend-walkthrough.md#customize-the-text-and-functionality-of-a-button-in-the-dialog-optional) +- [Override the send mode option at runtime](smart-alerts-onmessagesend-walkthrough.md#override-the-send-mode-option-at-runtime-optional) +- [Programmatically send the mail item once it meets your add-in's conditions](smart-alerts-onmessagesend-walkthrough.md#programmatically-send-the-item-from-the-task-pane-optional) ## Smart Alerts feature behavior and scenarios @@ -222,18 +228,13 @@ Because the `OnMessageSend` and `OnAppointmentSend` events are supported through In addition to these constraints, only one instance each of the `OnMessageSend` and `OnAppointmentSend` event can be declared in the manifest. If you require multiple `OnMessageSend` or `OnAppointmentSend` events, you must declare each one in a separate add-in. -The Smart Alerts dialog message must be 500 characters or less. While you can change the dialog message and **Don't Send** button to suit your add-in scenario, the following can't be customized. +The Smart Alerts dialog message must be 500 characters or less. While you can change the message and certain aspects of a button in the Smart Alerts dialog, the following can't be customized. - The dialog's title bar. Your add-in's name is always displayed there. - The font or color of the dialog message. However, you can use Markdown to format certain elements of your message. For a list of supported elements, see [Limitations to formatting the dialog message using Markdown](#limitations-to-formatting-the-dialog-message-using-markdown). - The icon next to the dialog message. - Dialogs that provide information on event processing and progress. For example, the text and options that appear in the timeout and long-running operation dialogs can't be changed. -You can customize the **Don't Send** button in the dialog to open a task pane or run a function. For guidance on the types of add-in commands, see [Types of add-in commands](../design/add-in-commands.md#types-of-add-in-commands). - -> [!NOTE] -> Support to customize the **Don't Send** button was introduced in [Mailbox requirement set 1.14](/javascript/api/requirement-sets/outlook/requirement-set-1.14/outlook-requirement-set-1.14). - In Outlook on the web and in new Outlook on Windows: - The `OnAppointmentSend` event only occurs when the meeting being sent was created through the **New Event** option. If the meeting being sent was created by selecting a date and time directly from the calendar, the `OnAppointmentSend` event doesn't occur. @@ -316,7 +317,7 @@ You can use Markdown to format the message of a Smart Alerts dialog. However, on The Smart Alerts feature ensures that all outgoing mail items are compliant with the information protection policies of an organization and helps users improve their messages through recommendations. To ensure your add-in always provides users with a smooth and efficient sending experience, observe the following guidelines. - **Don't let your add-in further delay the send operation**. Smart Alerts add-ins must be short-running and lightweight. Avoid overloading the `OnMessageSend` and `OnAppointmentSend` event handlers with heavy validations. To prevent this, preprocess information when other events occur, such as the `OnMessageRecipientsChanged` or `OnMessageAttachmentsChanged` event. To determine which events your add-in can respond to, see the "Supported events" section of [Configure your Outlook add-in for event-based activation](autolaunch.md#supported-events). -- **Don't implement additional dialogs**. Prevent overwhelming your users with too many dialogs. Instead, customize the text in the Smart Alerts dialog to convey information. If needed, you can also [customize the **Don't Send** button](smart-alerts-onmessagesend-walkthrough.md#customize-the-dont-send-button-optional) to provide users with additional information and functionality through a task pane or function. +- **Don't implement additional dialogs**. Prevent overwhelming your users with too many dialogs. Instead, customize the text in the Smart Alerts dialog to convey information. If needed, you can also [customize the text and functionality of certain dialog buttons](smart-alerts-onmessagesend-walkthrough.md#customize-the-text-and-functionality-of-a-button-in-the-dialog-optional) to provide users with additional information and functionality through a task pane or function. - **Enable the appropriate Group Policy settings in your organization**. To ensure that your Smart Alerts add-in activates on each mail item, including those sent using applications that implement Simple MAPI, configure the **Running Outlook for Simple MAPI Sending** setting. To learn more about this setting, see [Activate Smart Alerts in applications that use Simple MAPI](#activate-smart-alerts-in-applications-that-use-simple-mapi). ## Debug your add-in diff --git a/docs/outlook/smart-alerts-onmessagesend-walkthrough.md b/docs/outlook/smart-alerts-onmessagesend-walkthrough.md index 97470d004..a867afa61 100644 --- a/docs/outlook/smart-alerts-onmessagesend-walkthrough.md +++ b/docs/outlook/smart-alerts-onmessagesend-walkthrough.md @@ -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: 02/18/2025 +ms.date: 03/11/2025 ms.topic: how-to ms.localizationpriority: medium --- @@ -328,28 +328,42 @@ In this scenario, you'll add handling for sending a message. Your add-in will ch > - In classic Outlook on Windows, imports aren't currently supported in the JavaScript file where you implement the handling for event-based activation. > - To ensure your add-in runs as expected when an `OnMessageSend` or `OnAppointmentSend` event occurs, call `Office.actions.associate` in the JavaScript file where your handlers are implemented. This maps the event handler name specified in the manifest to its JavaScript counterpart. If this call isn't included in your JavaScript file and the send mode property of your manifest is set to **soft block** or isn't specified, your users will be blocked from sending messages or meetings. -## Customize the Don't Send button (optional) +## Customize the text and functionality of a button in the dialog (optional) > [!NOTE] > -> Support to customize the **Don't Send** button 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 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). -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. The [send mode option](onmessagesend-onappointmentsend-events.md#available-send-mode-options) specified in the manifest determines the options that appear to the user in the dialog. The **Don't Send** option 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. To provide the user with further guidance on how to meet the conditions of your add-in, customize the text of this button and program it to open a task pane or run a function. Through these add-in commands, you can provide the user with additional information and functionality. +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. -### Modify the Don't Send button text and functionality +The button you can customize depends on the Outlook client and version on which the add-in is running. -To modify the text of the **Don't Send** button or assign it a task pane or function, you must set additional options in the [event.completed](/javascript/api/outlook/office.mailboxevent#outlook-office-mailboxevent-completed-member(1)) method of your event handler. +| Client | Customizable dialog button | Specifications | +| --- | --- | --- | +| **Windows (classic)**
[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)

**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.

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.

![Smart Alerts dialog with the Don't Send button.](../images/outlook-smart-alerts-dont-send.png) | +| **Web browser**

**Windows (new)**

**Windows (classic)**
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.

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.

![Smart Alerts dialog with the Take Action button.](../images/outlook-smart-alerts-take-action.png) | -- The [cancelLabel](/javascript/api/outlook/office.smartalertseventcompletedoptions#outlook-office-smartalertseventcompletedoptions-cancellabel-member) option customizes the text of the **Don't Send** button. Custom text must be a maximum of 20 characters. -- The [commandId](/javascript/api/outlook/office.smartalertseventcompletedoptions#outlook-office-smartalertseventcompletedoptions-commandid-member) option specifies the ID of the task pane or function that runs when the **Don't Send** button is selected. The value must match the task pane or function command ID in the manifest of your add-in. The markup depends on the type of manifest your add-in uses. +> [!NOTE] +> In classic Outlook on Windows, if you customized the text and functionality of the **Don't Send** button in your Smart Alerts add-in prior to Version 2412 (Build 18324.20000), no additional action is needed to implement the **Take Action** button in the latest supported versions. The default or customized **Take Action** button will automatically appear the next time a user receives a Smart Alerts dialog. Although no implementation changes are needed, we recommend notifying users of this updated experience. +> +> If you only customized the text of the **Don't Send** button in earlier supported versions, your custom text won't appear in the latest versions that support the **Take Action** implementation. + +To modify the text of the dialog button or assign it a task pane or function, you must set additional options in the [event.completed](/javascript/api/outlook/office.mailboxevent#outlook-office-mailboxevent-completed-member(1)) method of your event handler. + +- The [cancelLabel](/javascript/api/outlook/office.smartalertseventcompletedoptions#outlook-office-smartalertseventcompletedoptions-cancellabel-member) option customizes the text of the applicable button. Custom text must be a maximum of 20 characters. +- The [commandId](/javascript/api/outlook/office.smartalertseventcompletedoptions#outlook-office-smartalertseventcompletedoptions-commandid-member) option specifies the ID of the task pane or function that runs when the applicable button is selected. The value must match the task pane or function command ID in the manifest of your add-in. The markup depends on the type of manifest your add-in uses. - **Add-in only manifest**: The `id` attribute of the **\** element representing the task pane or function command. - **Unified manifest for Microsoft 365**: The "id" property of the task pane or function command in the "controls" array. -- The [contextData](/javascript/api/outlook/office.smartalertseventcompletedoptions#outlook-office-smartalertseventcompletedoptions-contextdata-member) option specifies any JSON data you want to pass to the add-in when the **Don't Send** button is selected. If you include this option, you must also set the `commandId` option. Otherwise, the JSON data is ignored. + + In supported Outlook clients and versions, when the `commandId` option is specified, the **Take Action** button appears in the Smart Alerts dialog. +- The [contextData](/javascript/api/outlook/office.smartalertseventcompletedoptions#outlook-office-smartalertseventcompletedoptions-contextdata-member) option specifies any JSON data you want to pass to the add-in when the applicable button is selected. If you include this option, you must also set the `commandId` option. Otherwise, the JSON data is ignored. > [!TIP] + > When you configure a button in the Smart Alerts dialog to run a function, a button for the implemented add-in command is also added to the ribbon or action bar of the Outlook client. Use the `contextData` option to distinguish when a user runs the function from the Smart Alerts dialog. + > > To retrieve the value of the `contextData` option, you must call [Office.context.mailbox.item.getInitializationContextAsync](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods) in the JavaScript implementation of your task pane or function command. -In this sample, the **Don't Send** button is modified to open a task pane. +In this sample, the dialog button is modified to open a task pane. 1. Navigate to the **./src/launchevent** folder, then open **launchevent.js**. 1. Replace the **getAttachmentsCallback** function with the following code. @@ -396,7 +410,7 @@ In this sample, the **Don't Send** button is modified to open a task pane. > [!NOTE] > -> Support to customize the **Don't Send** button 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 override the send mode option at runtime 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). There may be instances when you want your add-in to implement different send mode options. For example, you may want your add-in to enforce the **block** option on mail items that don't meet the information protection policies of your organization, but only have it apply the **prompt user** option to provide a recommendation if a user adds the incorrect recipient. @@ -446,7 +460,12 @@ To override the send mode option at runtime, you must set the [sendModeOverride] ## Configure the task pane (optional) -If you implemented the optional steps to customize the **Don't Send** button or override the send mode option in this walkthrough, you also need to configure the task pane. Although the task pane is needed in this implementation, it isn't a requirement to customize the text of the **Don't Send** button or override the send mode option. +If you implemented the optional steps to customize a dialog button or override the send mode option in this walkthrough, you also need to configure the task pane. + +> [!NOTE] +> In Outlook on the web, new Outlook on Windows, supported versions of classic Outlook on Windows prior to Version 2412 (Build 18324.20000), and Outlook on Mac, you can customize the text of the **Don't Send** button without implementing a task pane or function command. Although the task pane is needed in this sample, it isn't a requirement to be able to customize the button text or override the send mode option in these clients. +> +> In classic Outlook on Windows starting in Version 2412 (Build 18324.20000), you must implement a task pane or function command to customize the **Take Action** button. This is because the **Take Action** button only appears in the Smart Alerts dialog when a task pane or function command is implemented in the add-in. 1. Navigate to the **./src/taskpane** folder, then open **taskpane.html**. 1. Select the entire **\** node (including its open and close tags) and replace it with the following code. @@ -508,7 +527,7 @@ If you implemented the optional steps to customize the **Don't Send** button or export async function addAttachment() { const attachmentUrl = document.querySelector("#attachment-url").value; Office.context.mailbox.item.addFileAttachmentAsync(attachmentUrl, getFileName(attachmentUrl), (asyncResult) => { - console.log(asyncResult); + console.log("Added attachment."); }); } @@ -528,14 +547,14 @@ If you implemented the optional steps to customize the **Don't Send** button or const base64String = "iVBORw0KGgoAAAANSUhEUgAAAGAAAABgCAMAAADVRocKAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAnUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAN0S+bUAAAAMdFJOUwAQIDBAUI+fr7/P7yEupu8AAAAJcEhZcwAADsMAAA7DAcdvqGQAAAF8SURBVGhD7dfLdoMwDEVR6Cspzf9/b20QYOthS5Zn0Z2kVdY6O2WULrFYLBaLxd5ur4mDZD14b8ogWS/dtxV+dmx9ysA2QUj9TQRWv5D7HyKwuIW9n0vc8tkpHP0W4BOg3wQ8wtlvA+PC1e8Ao8Ld7wFjQtHvAiNC2e8DdqHqKwCrUPc1gE1AfRVgEXBfB+gF0lcCWoH2tYBOYPpqQCNwfT3QF9i+AegJfN8CtAWhbwJagtS3AbIg9o2AJMh9M5C+SVGBvx6zAfmT0r+Bv8JMwP4kyFPir+cswF5KL3WLv14zAFBCLf56Tw9cparFX4upgaJUtPhrOS1QlY5W+vWTXrGgBFB/b72ev3/0igUdQPppP/nfowfKUUEFcP207y/yxKmgAYQ+PywoAFOfCH3A2MdCFzD3kdADBvq10AGG+pXQBgb7pdAEhvuF0AIc/VtoAK7+JciAs38KIuDugyAC/v4hiMCE/i7IwLRBsh68N2WQjMVisVgs9i5bln8LGScNcCrONQAAAABJRU5ErkJggg=="; - // Gets the current body of the message. + // Get the current body of the message. mailItem.body.getAsync(Office.CoercionType.Html, (bodyResult) => { if (bodyResult.status === Office.AsyncResultStatus.Failed) { console.log(bodyResult.error.message); return; } - // Inserts the Base64-encoded image to the beginning of the body. + // Insert the Base64-encoded image to the beginning of the body. const options = { isInline: true, asyncContext: bodyResult.value }; mailItem.addFileAttachmentFromBase64Async(base64String, "sample.png", options, (attachResult) => { if (attachResult.status === Office.AsyncResultStatus.Failed) { @@ -560,6 +579,54 @@ If you implemented the optional steps to customize the **Don't Send** button or 1. Save your changes. +### Programmatically send the item from the task pane (optional) + +> [!NOTE] +> The `sendAsync` method 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. + +To further streamline a user's experience when recommending changes to the mail items they're sending, call the [sendAsync](/javascript/api/requirement-sets/outlook/requirement-set-1.15/office.context.mailbox.item?view=outlook-js-1.15&preserve-view=true#methods) method in your task pane or function command code. + +1. In **taskpane.js**, replace the `addAttachment` function with the following code. + + ```javascript + // Adds the specified URL as an attachment to the message. + // Then, programmatically sends the message. + export async function addAttachment() { + const attachmentUrl = document.querySelector("#attachment-url").value; + Office.context.mailbox.item.addFileAttachmentAsync(attachmentUrl, getFileName(attachmentUrl), (asyncResult) => { + console.log("Added attachment"); + + // Programmatically send the item. + Office.context.mailbox.item.sendAsync((sendResult) => { + if (sendResult.status === Office.AsyncResultStatus.Failed) { + console.log(`Unable to send the message: ${sendResult.error.message}`); + return; + } + + // Don't run additional operations here. Process them before the sendAsync call instead. + }); + + // Don't run additional operations after the sendAsync call. Process them before the sendAsync call instead. + }); + } + ```` + + > [!TIP] + > - Any code implemented to run when `asyncResult.status` is `Office.AsyncResultStatus.Success` or after the `sendAsync` method isn't guaranteed to be processed. This is because the item may have already been sent and the add-in has completed processing. We recommend processing other operations before calling `sendAsync`. + > - The `sendAsync` implementation varies between a task pane and function command implementation. For guidance, see the [sendAsync](/javascript/api/requirement-sets/outlook/requirement-set-1.15/office.context.mailbox.item?view=outlook-js-1.15&preserve-view=true#methods) reference documentation. + +1. Save your changes. +1. In **taskpane.html**, update the label of the `add-attachment` button. + + ```html + Add and send + ``` + + > [!TIP] + > It's good practice to indicate to the user when your add-in programmatically sends the mail item they're composing. Depending on your implementation, you can indicate this in the label of a button or add a note to the task pane. + +1. Save your changes. + ## Update the commands HTML file 1. In the **./src/commands** folder, open **commands.html**. @@ -571,7 +638,7 @@ If you implemented the optional steps to customize the **Don't Send** button or ``` > [!IMPORTANT] - > The **Don't Send** 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. + > 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 > @@ -614,24 +681,32 @@ If you implemented the optional steps to customize the **Don't Send** button or [!INCLUDE [outlook-manual-sideloading](../includes/outlook-manual-sideloading.md)] 1. In your preferred Outlook client, create a new message and set the subject. In the body, add some text. For example, "Here's a picture of the proposed logo." -1. Send the message. A dialog appears requesting you to add an attachment. Select **Don't Send** or **Add an attachment**. The option available to you depends on whether you implemented the optional step to customize the **Don't Send** button. +1. Send the message. A dialog appears requesting you to add an attachment. Select **Don't Send**, **Take Action**, or **Add an attachment**. The options available to you depend on your Outlook client and whether you implemented the optional step to customize the dialog button. - Default **Don't Send** button. ![Dialog requesting the user to add an attachment to the message.](../images/outlook-win-smart-alerts.png) - - Customized **Add an attachment** button. + - Default **Take Action** button. + + ![Dialog with a Take Action button that opens a task pane.](../images/outlook-win-smart-alerts-take-action.png) + + - Customized **Add an attachment** button. Applies to Outlook on the web, new Outlook on Windows, and classic Outlook on Windows (starting in Version 2412 (Build 18324.20000)). + + ![Dialog with a customized Take Action button requesting the user to add an attachment to the message.](../images/outlook-smart-alerts-custom-take-action.png) + + - Customized **Add an attachment** button. Applies to classic Outlook on Windows prior to Version 2412 (Build 18324.20000). ![Dialog with a customized Don't Send button requesting the user to add an attachment to the message.](../images/outlook-smart-alerts-custom-button.png) > [!NOTE] > In supported versions of classic Outlook on Windows prior to Version 2410 (Build 18031.15000), if you assign a task pane to the **Don't Send** button, closing the dialog also opens the specified task pane. -1. Add an attachment to your message. If you implemented the optional step to customize the **Don't Send** button, use the task pane to add an attachment. +1. Add an attachment to your message. If you implemented the optional step to customize a dialog button, use the task pane to add an attachment. ![Task pane with an option to add an attachment.](../images/outlook-smart-alerts-task-pane.png) -1. Send the message. There should be no alert this time. +1. Send the message. If you implemented the optional step to programmatically send the message from the task pane, the message will send when you select **Add and send**. There should be no alert this time. 1. [!include[Instructions to stop web server and uninstall dev add-in](../includes/stop-uninstall-outlook-dev-add-in.md)] @@ -649,7 +724,13 @@ If you implemented the optional step to override the send mode option at runtime 1. Send the message. A dialog appears recommending to attach a copy of the image to the message. 1. Select **Send Anyway** to send the message as is, or select **Attach a copy** to include a copy before sending the message. - ![Smart Alerts dialog with the Send Anyway option available at runtime.](../images/outlook-smart-alerts-send-mode-override.png) + - Applies to Outlook on the web, new Outlook on Windows, and classic Outlook on Windows (starting in Version 2412 (Build 18324.20000)). + + ![Customized Smart Alerts dialog with the Send Anyway option available at runtime.](../images/outlook-smart-alerts-custom-button-and-override.png) + + - Applies to classic Outlook on Windows prior to Version 2412 (Build 18324.20000). + + ![Smart Alerts dialog with the Send Anyway option available at runtime in classic Outlook on Windows prior to Version 2412 (Build 18324.20000).](../images/outlook-smart-alerts-send-mode-override.png) > [!IMPORTANT] > If a Smart Alerts add-in that implements the override feature can't complete processing an event due to an error or is unavailable when the event occurs, it uses the send mode option specified in the manifest.