Microsoft Teams
The Vouch App for Microsoft Teams integration is designed to allow organisations to better integrate Vouch with their key Internal Communications platform.
As part of the integration, customers can receive updates within Microsoft Teams whenever a new asset is added to their Vouch account or requires review, as well share Employee Advocacy and Internal Comms content with your team.
The following guide outlines how to connect the two platforms and the various features.
Install the App
Install from the Microsoft Teams store
The Vouch app is published in the Microsoft Teams store. You can open the listing by clicking here or by opening the Apps section within your Microsoft Team's account and searching for Vouch.
Once you have found the Vouch listing, click on Open to start the install.
The Vouch app will ask you to choose the channel where you'd like to install it. Select an option and press Go.
Connect Vouch to your Teams account
Once installed, the Vouch app posts a welcome message in the chosen channel with instructions for linking your Teams and Vouch accounts. In the welcome post, click Connect Vouch.
On the Authorize Vouch to link your Teams account page, select the Vouch workspace you want to connect to Teams and press the Authorize button to complete the process.
Configure the integration
After authorising, the Microsoft Teams modal opens. This is where you confirm the default destination for Vouch messages and updates.
You can reopen it any time in Vouch under Organization settings > Integrations > Microsoft Teams and can confirm the following settings:
- Set the Team Name : The Team that Vouch will post into.
- Set the Channel : The default channel within the Team for Vouch notifications and updates.
- Set the Approval Channel : The channel that receives approval-workflow updates.
Enable direct chats to individuals via Microsoft Entra (Optional)
By default, Vouch posts to a channel, and no additional setup is needed with the app granted channel access at install time. If you want Vouch to send advocacy requests or internal comms messages as a chat to selected individuals, the Vouch app needs a set of Microsoft Graph permissions granted in your tenant.
To send messages to individuals, the Vouch application requires the following Microsoft Graph permissions:
| Permission | Type | What it enables |
|---|---|---|
| Chat.Create | Delegated | Create a new one-to-one or group chat to deliver a message. |
| ChatMessage.Send | Delegated | Send the advocacy request or internal comms message into that chat. |
| User.Read | Delegated | Sign in and read the connecting user's basic profile. |
| User.Read.All | Application | Look up recipients across the organisation so messages can be addressed to the right individuals. |
You can grant consent one of two ways:
Via the Vouch integration
When you enable individual messaging from within Vouch, Vouch triggers a Microsoft consent prompt showing the permissions above. Sign in as a Microsoft Entra administrator and accept it. This grants consent for the whole organisation in one step.
Via the Microsoft Entra admin centre
- Go to the Microsoft Entra admin centre (entra.microsoft.com) and sign in as an administrator.
- Navigate to Identity → Applications → Enterprise applications.
- Find and open the Vouch application in the list.
- Open Permissions and click Grant admin consent for [your organisation].
- Review the permissions in the prompt and accept. Each should then show as Granted.
Employee Advocacy
The following Supademo will showcase the steps to share your video stories to Microsoft Teams.