Merge pull request #1075 from OfficeDev/main

Merge to publish

Author: jasonjoh

docs/actionable-messages/actionable-messages-faq.md

@@ -5,95 +5,88 @@ author: avijityadav
 ms.topic: reference
 ms.service: outlook
 ms.subservice: o365-connectors
-ms.date: 04/08/2023
-ms.author: avyad
+ms.date: 06/10/2026
+ms.author: vermaanimesh
 ms.localizationpriority: high
 ---
 
 <!-- markdownlint-disable MD026 -->
+<!-- cSpell:ignore avijityadav vermaanimesh Mimecast -->
 
 # Frequently asked questions for Actionable Messages
 
-This section contains the frequently asked questions for Actionable Messages and the answers.
+Find answers to common questions about Actionable Messages.
 
 ## Registration process
 
-### I am unable to open the AM Developer Dashboard . How can I proceed?
+### I can't 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 encounter errors when opening the [AM Developer Dashboard](https://aka.ms/ActionableMessagesPortal), follow these steps to resolve the issue.
 
-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)
+1. Open [Outlook Web Email](https://outlook.office.com/mail/).
+1. In the next tab, open the [AM Developer Dashboard](https://aka.ms/ActionableMessagesPortal).
 
-*This is a known issue and is being fixed*
+*This is a known issue and is being fixed.*
 
-### I am trying to fill in the registration form but getting error while submitting. How can I proceed?
+### I try to fill in the registration form but get an error while submitting. How can I proceed?
 
-This might happen if there are some fields that contain unexpected values.
+This error might happen if some fields contain unexpected values.
 
-1. Please recheck all the fields again.
-1. Try to use smaller size payload and check that HTML tags are not used.
-1. In case you do not find any discrepancy, please remove the card payload json and submit again. If the form is submitted, please send the card payload separately to [[email protected]](mailto:[email protected]) along with your originator ID.
+1. Check all the fields again.
+1. Try using a smaller payload and confirm that HTML tags aren't used.
+1. If you don't find any discrepancy, remove the card payload JSON and submit again. If the form submits successfully, send the card payload separately to [[email protected]](mailto:[email protected]) along with your originator ID.
 
-### I have submitted a registration request with organization scope. Who will approve my registration?
+### I submitted a registration request with organization scope. Who approves my registration?
 
-For an organization scope registration of Actionable Messages, the approval of the registration depends on the policies of your organization. Typically, the person or team responsible for managing the M365 tenant will need to approve the registration of Actionable Messages. This could be an IT administrator, a security team, or another group within the organization that is responsible for managing Office 365.
+For an organization scope registration of Actionable Messages, the approval process depends on your organization's policies. Typically, the person or team responsible for managing the M365 tenant needs to approve the registration of Actionable Messages. This role could be an IT administrator, a security team, or another group within the organization that's responsible for managing Office 365.
 
-To check who are your organization IT admins, follow the following steps :
+To check who your organization's IT admins are, follow these steps:
 
 1. Go to [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer).
-1. Make a GET request using `https://graph.microsoft.com/v1.0/directoryRoles` request URL. This will show the list of roles in your tenant.
-1. In the response you can search for **Exchange Administrator** and **Global Administrator**.
-1. In some tenants **Exchange Administrator** might not be present. If the **Exchange Administrator** role is not listed then you can use the `id` from the **Global Administrator** role to fetch the list of tenant admins.
+1. Make a GET request with `https://graph.microsoft.com/v1.0/directoryRoles` as the request URL. This request returns the list of roles in your tenant.
+1. In the response, search for **Exchange Administrator** and **Global Administrator**.
+1. In some tenants, **Exchange Administrator** might not be present. If the **Exchange Administrator** role isn't listed, use the `id` from the **Global Administrator** role to fetch the list of tenant admins.
 
-### How can I update details for an approved global scoped Actionable message registration?
+### How can I update details for an approved globally scoped Actionable Message registration?
 
-To update details for an approved global scoped Actionable Message provider, you can reach out to [[email protected]](mailto:[email protected]) with updated details. Our team will acknowledge and update it in backend. Please note that any update will take 2 weeks after the team acknowledges your update.
+To update details for an approved globally scoped Actionable Message provider, contact [[email protected]](mailto:[email protected]) with the updated details. The team acknowledges your request and updates it in the backend. Any update takes two weeks after the team acknowledges your request.
 
 ## Actionable Message Rendering
 
-### Actionable card does not show up in Outlook desktop but works fine in Outlook on the web.
+### Actionable card doesn't show up in Outlook desktop but works fine in Outlook on the web.
 
-If you don't see the Actionable Message in Outlook desktop, please confirm the following:
+If you don't see the Actionable Message in Outlook desktop, confirm the following conditions:
 
-1. Your download preferences are set to "Download full items". It should look like the following image.
+1. Your download preferences are set to **Download full items**. It should look like the following image.
 
     :::image type="content" source="images/download-preference.png" alt-text="Download preferences to see actionable messages":::
 
-1. You are not using any screen reader.
-1. Please also check if the following registry key is set to 0 - `HKEY_CURRENT_USER\Control Panel\Accessibility\Blind Access\On`.
+1. You're not using any screen reader.
+1. The following registry key is set to 0 - `HKEY_CURRENT_USER\Control Panel\Accessibility\Blind Access\On`.
 
-### Actionable messages work as expected with user mailboxes but not with Group or shared mailboxes.
+### Actionable messages work as expected with user mailboxes but not with group or shared mailboxes
 
-This is the expected behavior. Actionable Messages are only supported with single user mailboxes. Group and shared mailboxes are not supported.
+This behavior is expected. Actionable Messages only support single user mailboxes. Group and shared mailboxes aren't supported.
 
-### Users from my organization are not able to use Actionable Messages and the action redirects them to webpage.
+### Users from my organization can't use Actionable Messages and the action redirects them to a webpage
 
-Please check if the organization uses Mimecast or other similar services. Mimecast changes emails in ways that prevent Actionable Messages workflow.
+Check if your organization uses Mimecast or other similar services. Mimecast changes emails in ways that prevent Actionable Messages workflow.
 
 To verify that this is the cause:
 
-1. Disable Mimecast temporarily and send a new Actionable Message.
-1. Add "schema.org" domain or `http://schema.org/extensions` to Mimecast exception list.
+1. Temporarily disable Mimecast and send a new Actionable Message.
+1. Add the "schema.org" domain or `http://schema.org/extensions` to the Mimecast exception list.
 
-### Is there a limit to number of Actionable messages that can be opened in Outlook at one time?
+### Is there a limit to the number of Actionable Messages that can be opened in Outlook at one time?
 
-To maintain optimal performance, we allow a maximum of 10 actionable messages emails to be opened at one time. Trying to open more than that at the same time will shown an error.
+To maintain optimal performance, you can open up to 10 actionable message emails at one time. If you try to open more than that number at the same time, an error appears.
 
-### Is there a time limit before which actions can be taken on Actionable messages?
+### Is there a time limit on taking actions on Actionable Messages?
 
-Actionable messages are typically designed for quick actions on emails. Hence, you cannot take actions of an Actionable messages that is more than a month old.
+Actionable Messages are typically designed for quick actions on emails. As a result, you can't take actions on an Actionable Message that is more than a month old.
 
-## Upgrading to Adaptive Card 1.4 and above
+## Upgrading to Adaptive Card 1.4 and later
 
-### I have upgraded the Adaptive card version from 1.0 to 1.4, and my Action buttons have disappeared.
+### I upgraded the Adaptive Card version from 1.0 to 1.4, and my action buttons 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.
+The action execution paradigm changed in Adaptive Card version 1.4. The platform now supports [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).

docs/actionable-messages/adaptive-card-expense-approval-sample.md

@@ -17,7 +17,7 @@ This sample illustrates the Universal Action Model implementation available for
 ## Prerequisites
 
 - Outlook/OWA client is available and you have an account.
-- A valid Azure subsciption.
+- A valid Azure subscription.
 - Understanding of [Azure Bot Framework](/azure/bot-service/bot-builder-basics).
 
 ## Setup for bot
@@ -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

docs/actionable-messages/adaptive-card-project-management-sample.md

@@ -5,35 +5,37 @@ author: avijityadav
 ms.topic: sample
 ms.service: outlook
 ms.subservice: o365-connectors
-ms.date: 04/08/2023
-ms.author: avyad
+ms.date: 06/10/2026
+ms.author: vermaanimesh
 ms.localizationpriority: high
 ---
 
+<!-- cSpell:ignore avijityadav vermaanimesh -->
+
 # Universal Actions Model code sample - Project Management
 
 This sample illustrates the Universal Action Model implementation available for adaptive cards version 1.4 or higher.
 
 ## Prerequisites
 
-- Outlook/OWA client is available and you have an account.
+- Outlook or OWA client is available and you have an account.
 - A valid Azure subscription.
 - Understanding of [Azure Bot Framework](/azure/bot-service/bot-builder-basics).
 
 ## Setup for bot
 
-- Register a bot with Azure Bot Service, following the instructions [here](/azure/bot-service/bot-service-quickstart-registration).
-- Ensure that you've [enabled the Outlook Channel](/azure/bot-service/bot-service-channel-connect-actionable-email).
+- Register a bot with Azure Bot Service, following the instructions in [Register a bot with Azure](/azure/bot-service/bot-service-quickstart-registration).
+- Ensure that you [enabled the Outlook Channel](/azure/bot-service/bot-service-channel-connect-actionable-email).
   - Open your bot resource in the [Azure portal](https://ms.portal.azure.com/).
   - Open the **Channels** pane.
   - Select the **Outlook** channel in *Available Channels* section.
-  - Under the **Actionable Messages** tab, Click **Apply** followed by **please register here**.
+  - Under the **Actionable Messages** tab, select **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.
-- Create your bot with the Bot Framework SDK, following the instruction [here](/azure/bot-service/bot-service-quickstart-create-bot).
+- Create your bot with the Bot Framework SDK, following the instructions in [Create a bot with the Bot Framework SDK](/azure/bot-service/bot-service-quickstart-create-bot).
 
 ## Step 1: Ensure your adaptive card payloads are ready
 
-For the Project management scenario, you can find the [JSON payload here](https://github.com/OfficeDev/outlook-dev-docs/blob/main/files/actionable-messages/samples/ProjectManagement.json). Below, You can see the payload rendering in mobile and desktop screens.
+For the Project management scenario, you can find the [JSON payload here](https://github.com/OfficeDev/outlook-dev-docs/blob/main/files/actionable-messages/samples/ProjectManagement.json). In the following section, you can see the payload rendering in mobile and desktop screens.
 
 <!-- markdownlint-disable MD051 -->
 ### [Mobile](#tab/mobile)
@@ -78,7 +80,7 @@ protected override async Task<AdaptiveCardInvokeResponse> OnAdaptiveCardInvokeAs
         else if (invokeValue.Action.Verb == "projectSubmitComment")
         {
             // This function can contain your business logic
-            // to submit the comment and show the refresh car
+            // to submit the comment and show the refresh card
             return await ProcessProjectSubmitComment();
         }
         else

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 [[email protected]](mailto:[email protected]) 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 [[email protected]](mailto:[email protected]) to enable this feature.
 
 ## Using autoInvokeAction