From ae6687b4ae57bff91dbe66fa556ca37101be9128 Mon Sep 17 00:00:00 2001 From: Animesh Verma Date: Tue, 9 Jun 2026 14:06:30 +0530 Subject: [PATCH 1/6] Updating links for new OAM Portal --- .../actionable-messages/actionable-messages-faq.md | 14 +++----------- .../adaptive-card-expense-approval-sample.md | 2 +- docs/actionable-messages/auto-invoke.md | 2 +- docs/actionable-messages/email-dev-dashboard.md | 5 +---- docs/actionable-messages/get-started.md | 7 +++++-- docs/actionable-messages/security-requirements.md | 2 +- 6 files changed, 12 insertions(+), 20 deletions(-) diff --git a/docs/actionable-messages/actionable-messages-faq.md b/docs/actionable-messages/actionable-messages-faq.md index f4db057b..a9f2e071 100644 --- a/docs/actionable-messages/actionable-messages-faq.md +++ b/docs/actionable-messages/actionable-messages-faq.md @@ -20,10 +20,10 @@ This section contains the frequently asked questions for Actionable Messages and ### I am unable to open the AM Developer Dashboard . How can I proceed? -If you are facing errors when opening the [AM Developer Dashboard](https://outlook.office.com/connectors/oam/publish) then please follow the below steps to mitigate. +If you are facing errors when opening the [AM Developer Dashboard](https://aka.ms/ActionableMessagesPortal) then please follow the below steps to mitigate. 1. Open [Outlook Web Email](https://outlook.office.com/mail/) -2. In the next tab open the [AM Developer Dashboard](https://outlook.office.com/connectors/oam/publish) +2. In the next tab open the [AM Developer Dashboard](https://aka.ms/ActionableMessagesPortal) *This is a known issue and is being fixed* @@ -88,12 +88,4 @@ Actionable messages are typically designed for quick actions on emails. Hence, y ### I have upgraded the Adaptive card version from 1.0 to 1.4, and my Action buttons have disappeared. -Action execution paradigm has changed in Adaptive card version 1.4. We have started supporting [Action.Execute](https://adaptivecards.io/explorer/Action.Execute.html) in place of `Action.Http`. For more information, see [code sample using Adaptive cards 1.4+](./adaptive-card-expense-approval-sample.md). - -## Actionable Message onboarding paused till June 15, 2024 - -### I have submitted a Global scoped registration but it's not yet approved. - -Due to a service upgrade, onboarding for **Global** scoped registrations is temporarily paused until June 30, 2024. Registrations for Actionable Messages with **Organization** and **Test** scopes remain unaffected and will continue to operate as expected during this period. - -For those affected by the pause in **Global** scope onboarding, please prepare your services and await the resumption of the process. For any queries or assistance during this period, please reach out to the Actionable Messages team through the usual channels. +Action execution paradigm has changed in Adaptive card version 1.4. We have started supporting [Action.Execute](https://adaptivecards.io/explorer/Action.Execute.html) in place of `Action.Http`. For more information, see [code sample using Adaptive cards 1.4+](./adaptive-card-expense-approval-sample.md). \ No newline at end of file diff --git a/docs/actionable-messages/adaptive-card-expense-approval-sample.md b/docs/actionable-messages/adaptive-card-expense-approval-sample.md index ab815bf2..2aef7874 100644 --- a/docs/actionable-messages/adaptive-card-expense-approval-sample.md +++ b/docs/actionable-messages/adaptive-card-expense-approval-sample.md @@ -28,7 +28,7 @@ This sample illustrates the Universal Action Model implementation available for - Open the **Channels** pane. - Select the **Outlook** channel in *Available Channels* section. - Under the **Actionable Messages** tab, Click **Apply** followed by **please register here**. - - Fill out the registration form to request access. See [Register your service with the actionable email developer dashboard](./email-dev-dashboard.md) for more information. + - Fill out the registration form to request access. See [Register your service with the actionable email developer dashboard](https://aka.ms/ActionableMessagesPortal) for more information. - Create your bot with the Bot Framework SDK, following the instruction [here](/azure/bot-service/bot-service-quickstart-create-bot). ## Step 1: Ensure your adaptive card payloads are ready diff --git a/docs/actionable-messages/auto-invoke.md b/docs/actionable-messages/auto-invoke.md index 1f5749b0..553ece46 100644 --- a/docs/actionable-messages/auto-invoke.md +++ b/docs/actionable-messages/auto-invoke.md @@ -19,7 +19,7 @@ Actionable messages allow users to take quick actions on an email message, often ## Registration requirements -Actionable Messages services registered in the [developer dashboard](email-dev-dashboard.md) with the **Test Users** or **Organization** scope can use this feature as soon as they are approved. If your service is registered with the **Global** scope, you must contact [onboardoam@microsoft.com](mailto:onboardoam@microsoft.com) to enable this feature. +Actionable Messages services registered in the [developer dashboard](https://aka.ms/ActionableMessagesPortal) with the **Test Users** or **Organization** scope can use this feature as soon as they are approved. If your service is registered with the **Global** scope, you must contact [onboardoam@microsoft.com](mailto:onboardoam@microsoft.com) to enable this feature. ## Using autoInvokeAction diff --git a/docs/actionable-messages/email-dev-dashboard.md b/docs/actionable-messages/email-dev-dashboard.md index b1a752d1..c1728de0 100644 --- a/docs/actionable-messages/email-dev-dashboard.md +++ b/docs/actionable-messages/email-dev-dashboard.md @@ -14,7 +14,7 @@ ms.subservice: o365-connectors [!INCLUDE [legacy-token-deprecation](../includes/actionable-messages/legacy-token-deprecation.md)] -To test and publish actionable messages from your service, you need to provide certain information to Microsoft to enable this functionality for emails from your service. The [developer dashboard](https://aka.ms/publishoam) helps you submit and track status of your submission via the web portal. +To test and publish actionable messages from your service, you need to provide certain information to Microsoft to enable this functionality for emails from your service. The [developer dashboard](https://aka.ms/ActionableMessagesPortal) helps you submit and track status of your submission via the web portal. > [!NOTE] > You can easily try out actionable messages via email by sending email to yourself with the required markup without any intervention from Microsoft. This would typically be the first step you try out as you dip your toes into this capability. @@ -89,12 +89,9 @@ Each of the above are independent steps. i.e. you can pick only one scope for ea Self-service of registrations is available for registrations that use the following scopes. - **Test Users**: The registration request is auto-approved for your test users you specify. This will enable actionable emails from your service sent to test users. -- **Organization**: This registration request will be sent to your organization's administrators with **Exchange administrator** permissions. Any administrator with those permissions receive an email with submission details and will be able to review and approve your request. If no users have the **Exchange administrator** role assigned, users with the **Global administrator** role will receive this email instead. Once the submission is approved, whether auto-approved or by your administrator, it will take up to 24 hours for the registration to take effect. -For **My organization** registrations, the administrator accounts will receive an email and the submitter will also be copied on those emails. This will allow you to reach out to your administrator if you need to provide further clarifications or details. Once the request is approved, the submitter and the administrators will be notified with another email. - After 24 hours have passed, you can verify if the registration has taken into effect by sending an actionable message from your service to your mailbox or specified test users (for **Test Users** scope), or any user mailbox in your organization (for **Organization** scope). If 24 hours have passed and the registration is still not in effect, please contact us by using the feedback link at the top the registration dashboard labeled **Registration not working?**. ### Test user email addresses diff --git a/docs/actionable-messages/get-started.md b/docs/actionable-messages/get-started.md index 5127868f..fb700c9b 100644 --- a/docs/actionable-messages/get-started.md +++ b/docs/actionable-messages/get-started.md @@ -14,6 +14,9 @@ ms.subservice: o365-connectors [!INCLUDE [legacy-token-deprecation](../includes/actionable-messages/legacy-token-deprecation.md)] +> [!IMPORTANT] +> Actionable messages provider portal has moved to a new location. You can visit the same here. [Link](https://outlook.office.com/actionablemessage/oam +) ## Supported scenarios Sending actionable messages via email is supported in the following scenarios. @@ -30,7 +33,7 @@ Sending actionable messages via email is supported in the following scenarios. Let's start by creating an actionable message card. We'll start with something simple, just a basic card with an `Action.Http` action and an `Action.OpenUrl` action. We'll use the [Actionable Message Designer](https://amdesigner.azurewebsites.net/) to design the card. > [!IMPORTANT] -> The sample card markup in this topic omits the `originator` property. This works in a testing scenario, where the recipient is the same as the sender. When sending actionable messages to anyone else, the `originator` property must be set to a valid provider ID generated by the [Actionable Email Developer Dashboard](email-dev-dashboard.md). Leaving this property empty when sending to others results in the card being removed. +> The sample card markup in this topic omits the `originator` property. This works in a testing scenario, where the recipient is the same as the sender. When sending actionable messages to anyone else, the `originator` property must be set to a valid provider ID generated by the [Actionable Email Developer Dashboard](https://outlook.office.com/actionablemessage/oam). Leaving this property empty when sending to others results in the card being removed. Go to the Actionable Message Designer and paste in the following JSON: @@ -76,7 +79,7 @@ Feel free to experiment with this simple example in the Designer. You can see th ## Sending actionable messages via email > [!IMPORTANT] -> You can design and test actionable messages by using the [Actionable Message Designer](https://amdesigner.azurewebsites.net/), which allows you to send actionable messages to yourself. You can also send actionable messages to yourself using the [Office 365 SMTP server](https://support.office.com/article/pop-and-imap-email-settings-for-outlook-8361e398-8af4-4e97-b147-6c6c4ac95353). You will be unable to send actionable messages to any other user until you have registered using the [actionable messages developer dashboard](https://aka.ms/publishoam). +> You can design and test actionable messages by using the [Actionable Message Designer](https://amdesigner.azurewebsites.net/), which allows you to send actionable messages to yourself. You can also send actionable messages to yourself using the [Office 365 SMTP server](https://support.office.com/article/pop-and-imap-email-settings-for-outlook-8361e398-8af4-4e97-b147-6c6c4ac95353). You will be unable to send actionable messages to any other user until you have registered using the [actionable messages developer dashboard](https://aka.ms/ActionableMessagesPortal). To embed an actionable message card in an email message, we need to wrap the card in a `