Frequently asked questions for Actionable Messages

This section contains the frequently asked questions for Actionable Messages and the answers.

Registration process

I am unable to open the AM Developer Dashboard . How can I proceed?

If you are facing errors when opening the AM Developer Dashboard then please follow the below steps to mitigate.

1. Open Outlook Web Email
2. In the next tab open the AM Developer Dashboard

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?

This might happen if there are some fields that contain unexpected values.

1. Please recheck all the fields again.
2. Try to use smaller size payload and check that HTML tags are not used.
3. 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 onboardoam@microsoft.com along with your originator ID.

I have submitted a registration request with organization scope. Who will approve 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.

To check who are your organization IT admins, follow the following steps :

1. Go to Graph Explorer.
2. Make a GET request using https://graph.microsoft.com/v1.0/directoryRoles request URL. This will show the list of roles in your tenant.
3. In the response you can search for Exchange Administrator and Global Administrator.
4. 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.

How can I update details for an approved global scoped Actionable message registration?

To update details for an approved global scoped Actionable Message provider, you can reach out to onboardoam@microsoft.com 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.

Actionable Message Rendering

Actionable card does not 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:

1. Your download preferences are set to "Download full items". It should look like the following image.

   

2. You are not using any screen reader.

3. Please also check if 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.

This is the expected behavior. Actionable Messages are only supported with single user mailboxes. Group and shared mailboxes are not supported.

Users from my organization are not able to use Actionable Messages and the action redirects them to webpage.

Please check if the 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.
2. Add "schema.org" domain or http://schema.org/extensions to Mimecast exception list.

Is there a limit to 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.

Is there a time limit before which actions can be taken 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.

Upgrading to Adaptive Card 1.4 and above

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 in place of Action.Http. For more information, see code sample using Adaptive cards 1.4+.

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.