The Mural App for Teams seamlessly integrates visual collaboration throughout Microsoft Teams, unleashing team creativity, engagement, and alignment where you’re already working. Leverage all of Mural’s visual thinking capabilities and Facilitation Superpowers® inside of Teams to make your next project a smashing success. Add a mural directly into any channel, chat, meeting invite, or live video meeting, and work on a mural in a personal app all within Teams.
This article walks you through the setup required in Mural and in Microsoft Teams. You can see our Mural App for Teams user guide here.
Index
FAQs.
How the Mural App for Teams works
The Mural App for Teams is available for all plans. With this integration, you can:
Embed a mural as a tab to any chat or channel in Teams where you can collaborate visually. Then, you can simply reference or return to the mural to keep collaboration going.
Stay informed with the Mural bot and receive notifications when someone comments, mentions, or invites you to a mural.
Share a mural during a live video meeting in Teams to increase inclusivity, engagement, and creativity with your team.
Use the personal app to access and work on any mural just as you would in the web app, right within Teams.
Pin a mural to any meeting invite to share information ahead of time or easily find the right mural for a recurring meeting.
Use the messaging extension to search for and share templates easily in a chat or a channel. Anyone who sees the message can instantly create a mural from the template, all in Teams.
Prerequisites
Here are the prerequisites for the Mural App for Teams:
A Microsoft administrator must allow the Mural app to be downloaded from the Microsoft Teams App Store.
A Microsoft administrator must add Mural to App Permissions Policies, if they exist.
A Microsoft administrator must allow access to the Azure Active Directory (AAD) profiles of app users by consenting on behalf of their organization.
For Business and Enterprise plans, a Mural administrator must enable the integration in the Company Dashboard > Integrations.
Implementation for administrators
App setup policies
We recommend you consider using app setup policies to install and pin apps for the MURAL app to ensure your users are getting the most out of the integration.
Learn more about install and pin app policies.
Install Mural app from App Store
The Microsoft administrator must enable their team to install the Mural app from the App Store. You must be a global admin or Teams service admin to enable the app. If application permission policies are in use for the organization, Mural must be added to those policies. After the admin enables the app installation, a user can download the Mural App for Teams in the App Store.
Accept Azure Active Directory consent
Microsoft Team administrators can accept consent on behalf of their organization. Accepting Azure Active Directory (AAD) consent options are displayed by Microsoft Teams. This is because we’re requesting access to the user AAD token, and because of the Enterprise applications Consent and Permissions settings in their Azure Active Directory (see below). This token is used in the authentication flow to link a Mural account with the user AAD profile. From there, a user will only have to log in one time even if using multiple devices or Microsoft Teams clients.
There are two methods to accepting AAD consent.
Method 1:
Click Accept.
Method 2:
Have a Microsoft Teams admin log in into the Microsoft Teams admin center.
Navigate to Manage apps.
Select the Mural app in the list.
Select Permissions tab.
Click on Review permissions and consent under Org-wide permissions.
Enable the Mural App for Teams
Before users can install the Mural App for Teams, you must allow the app in the Microsoft Teams admin center.
Go to the Manage apps page in the Microsoft Teams admin center.
In the left navigation of the Microsoft Teams admin center, go to Teams apps > Manage apps.
Search for and select the Mural app.
Click the toggle to allowed.
Read more in the Microsoft Teams help article on adding apps.
Enable the integration in Mural
The Mural administrator must enable the integration in the Integrations section of the Company Dashboard.
Specifications:
For more information on plans, check out our plans and pricing page. |
Allowlist Mural in your company’s proxy
A proxy server is used by enterprises to protect their company from cyberattacks. Sometimes your company’s proxy server will block or encrypt calls to Mural from Teams, which will cause the Mural App for Teams to not function. The Mural App for Teams calls the hosts below which need to be allowlisted so that the proxy does not block or encrypt calls to them:
app.mural.co
integrations.mural.co
Here are possible signs that a proxy server is blocking the Mural App for Teams:
After authenticating with Mural in the Mural App for Teams, you get logged out immediately. You may see an error message explaining that no workspaces could be loaded.
The Mural App for Teams works in a web browser, but not the desktop.
Implementation for users
After the Microsoft Teams and the Mural administrators have enabled the Mural app, end-users can install the app themselves if the app permission policy that's assigned to them allows it. Setup instructions are also available in the Mural App for Teams user guide.
Open Microsoft Teams.
Click on Apps in the bottom left corner to go to the App Store.
Search for and select
Mural(or scroll through the store to find it).Click the Add button to add the Mural App for Teams.
Click the Get Started button.
When prompted, sign in with your Mural credentials.
Allow the Mural App for Teams to access your Mural account so we can bring all necessary information from Mural into Teams.
Permissions and scopes
The Mural App for Teams uses the following permissions, which are also listed on the Teams app marketplace under the permissions tab.
Permission | Reason |
Receive messages and data that I provide to the bot. | The bot needs to be able to read messages that are sent to it, such as “turn on notifications”. The bot has the ability to receive data from users; however, the Mural app does not utilize this feature. |
Send me messages and notifications. | The bot sends the user messages and notifications, such as Mural notifications, if the user has opted in to receive them. |
Access my profile information such as my name, email address, company name, and preferred language. | We use the users information to log them into Mural and send personalized messages. |
Receive messages and data that team or chat members provide in a channel, chat or meeting. | This consent is required to use configurable Mural tabs in chats and channels. |
Send messages and notifications in a channel, chat or meeting. | The bot sends the user messages and notifications, such as Mural notifications, if the user has opted in to receive them. |
Access information from this team, chat or meeting such as team, chat or meeting name, channel list and roster (including team or chat member's names and email addresses) - and use this to contact them. | This consent is required to use configurable Mural tabs in chats and channels.
|
FAQs
Here are answers to some questions that may pop up when using this integration:
How do share permissions for murals work in Teams?
Sharing the mural is easy and secure inside of Microsoft Teams. The Mural App for Microsoft Teams follows the same sharing permissions as in the web app, but you’ll notice there isn’t a share button on the top bar. To change permissions, you’ll need to go to the web app. If visitor links are enabled for a mural, anyone who can access the Microsoft Teams channel, chat, or calendar invite can access the mural as a visitor without needing to sign in. If visitor links are disabled, anyone in the space who wants to access the mural must sign in and have permission to access it.
Does the Mural App for Teams require tenant-wide admin consent?
Yes.
Does the Mural App for Teams require any tenant-wide configuration changes?
Nope.
What are the actual permissions needed by Mural on Teams?
Mural doesn’t require any permissions directly to use Teams. Users will need to be invited in as members first before they can access a mural in a tab on a Team. Mural can be limited to certain users through app permission policies.
For more information, see our section on permissions and scopes.
Does the Mural app impact the Teams tenant?
An admin would need to enable the application from the Microsoft App Store and possibly add it to any app permission policies that may exist in the organization.
Is there any way to limit the access of the application to a specific population?
Yes. App permission policies can be set up in Microsoft Teams to limit the Mural app from being installed by certain users.
Can I start a mural with a template within Teams?
Yes. Through the messaging extension released in March 2022, you can search for, share, and open templates in the personal app within Teams.
Who needs to have the app installed to invite participants to collaborate in a mural using the Mural App for Microsoft Teams?
The person sharing the mural must have the app installed. Once a mural is shared in Teams, other participants can view and join the mural to collaborate without needing to install the app.
Can the Mural app be used with people outside my organization?
Yes, but only Mural members can install the app and invite participants. External participants can only see the murals shared by a member who has the app installed. The mural sharing permissions remain the same as within the web app.
Will the engagement in murals be viewable in my recorded meetings?
Currently, murals are not visible in recorded Teams’ meetings. When recording in Teams while sharing a mural, a banner will display notifying the host that the mural will not be recorded.
Does the installation of the app require Global admin consent?
The Teams admin may need to consent on behalf of the organization if they are using Azure Active Directory. See the section above about AAD.
Does turning off visitor links prevent external users from joining or viewing a mural in the Mural App for Teams?
If an external user (a visitor) tries to join the mural and visitors aren’t allowed, they’ll see a page prompting them to sign in.
How can I allow anonymous users to interact with the Mural App for Teams?
Follow this guide or disallow anonymous guests to interact with apps in Teams meetings.