Frequently asked questions for Actionable Messages
This section contains the frequently asked questions for Actionable Messages and the answers.
If you are facing errors when opening the AM Developer Dashboard then please follow the below steps to mitigate.
- Open Outlook Web Email
- In the next tab open the AM Developer Dashboard
This is a known issue and is being fixed
This might happen if there are some fields that contain unexpected values.
- Please recheck all the fields again.
- Try to use smaller size payload and check that HTML tags are not used.
- 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.
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 :
- Go to Graph Explorer.
- Make a GET request using
https://graph.microsoft.com/v1.0/directoryRoles
request URL. This will show the list of roles in your tenant. - In the response you can search for Exchange Administrator and Global Administrator.
- 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.
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.
If you don't see the Actionable Message in Outlook desktop, please confirm the following:
Your download preferences are set to "Download full items". It should look like the following image.
You are not using any screen reader.
Please also check if the following registry key is set to 0 -
HKEY_CURRENT_USER\Control Panel\Accessibility\Blind Access\On
.
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:
- Disable Mimecast temporarily and send a new Actionable Message.
- Add "schema.org" domain or
http://schema.org/extensions
to Mimecast exception list.
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.
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.
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+.
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.