Integrate Mo with Microsoft Teams to enable seamless access to recognition, Boosts, and occasions directly within Teams. This guide covers admin setup, user experience, and ongoing management.
Prerequisites:
Admin permissions in Mo
Microsoft Teams admin centre access
Microsoft Teams tenant ID
Integration Overview
What the Integration Enables
Core Functionality:
Receive Mo notifications directly in Teams
Create and respond to Moments from Teams
Participate in Boosts without leaving Teams
React and comment on content in Teams
View occasion celebrations and respond
Key Benefits:
Reduces tool-switching for users
Increases Mo engagement and adoption
Seamless workflow integration
Real-time notifications where users already work
Admin Setup Process
Phase 1: Link Teams Tenant to Mo
Step 1: Obtain Your Teams Tenant ID
Open Microsoft Teams application
Click the "..." icon at the end of the list showing your users
Click "Get link to team" from the dropdown
Copy the tenant ID - it appears after
tenantId=
in the URLSave this ID - you'll need it in the next step
Example URL format:
https://teams.microsoft.com/l/team/[team-id]/conversations?groupId=[group-id]&tenantId=[YOUR-TENANT-ID]
Step 2: Configure Integration in Mo
Log into Mo with admin permissions
Go to the Integrations page
Locate Microsoft Teams setup area
Paste your tenant ID into the designated field
Save the configuration
Verify connection shows as active
Phase 2: Deploy Mo App to Users
Understanding App Permission Policies
Microsoft Teams uses app permission policies to control app access. Review your organisation's existing policies before proceeding.
Recommended Approach: Organisation-Wide Deployment
This method deploys Mo to all employees automatically without individual installation.
Step 1: Access Teams Admin Centre
Navigate to App setup policies in Teams admin centre
Sign in with Teams admin credentials
Locate "App setup policies" in the navigation
Step 2: Configure Policy
Select the policy that applies to your employees
For organisation-wide deployment: Select Global policy
For specific groups: Select relevant custom policy
Click policy name to open configuration
Step 3: Add Mo as Installed App
Under "Installed apps" section, click "Add apps"
Search for "Mo" in the app catalogue
Select Mo from results
Click "Add" to include in the policy
Save changes to the policy
Step 4: Pin Mo to Sidebar (Optional but Recommended)
Scroll to "Pinned apps" section
Click "+ Add apps" at the bottom
Search for and add "Mo"
Drag to position Mo in the desired sidebar order
Save changes
Why pin Mo:
Increases visibility and discoverability
Reduces barriers to engagement
Encourages regular usage
Makes notifications more accessible
Step 5: Apply and Monitor
Review policy settings before applying
Click "Confirm" or "Save" to activate
Monitor deployment progress
Technical Considerations:
Changes propagate within 24 hours typically
Some users may see changes sooner (varies by Microsoft Teams sync)
Users must restart Teams to see newly installed apps
Pinned apps appear in order specified in policy
Alternative Deployment: User-Initiated Installation
When to use this approach:
Pilot programmes with specific user groups
Gradual rollout strategies
Organisations with strict app approval processes
Process:
Ensure Mo app is approved in your Teams app store
Users can search for "Mo" in Teams app store
Users click "Add" to install personally
User Setup and Account Linking
After Mo has been launched, users can then link their Mo account to Teams to receive notifications and interact with Mo content.
Account Linking Process:
User opens the Mo app in Teams
Mo bot sends a notification in Teams prompting user to link their account
User clicks the link button in the notification
User is redirected to Mo for authentication
User returns to Teams with accounts linked
π For detailed user instructions
Mo Functionality in Teams
Notifications Users Receive
Moments Notifications:
You've been tagged/mentioned in a Moment
Notification appears in Teams
Can comment directly from Teams
Can react with emojis from Teams
Click to view full Moment
You've been tagged in a reward Moment
Notification shows reward details
Can comment and react from Teams
Full reward information displayed
Links to complete reward view in Mo
You've been notified as a manager
Manager notification for team member recognition
Can comment and react from Teams
View complete context
Acknowledge and engage quickly
Occasion reminder: Appreciate colleagues
Prompts to recognise team members
Can create a Moment directly from Teams
Recipient auto-tagged in the interface
Streamlined recognition flow
Boost Notifications:
You've been asked to take part in a Boost
Boost prompt displayed in Teams
Can respond directly from Teams
Submit Boost response without leaving Teams
Full context of Boost requirements shown
Occasions Notifications:
First day celebrations
Notification: "It's [name]'s first day! Share and celebrate"
Option to create welcome Moment from Teams
User automatically tagged
Easy onboarding recognition
Work anniversaries
Notification: "It's [name]'s work anniversary! Share and celebrate"
Option to create celebration Moment from Teams
User automatically tagged
Milestone recognition made easy
Birthdays
Notification: "It's [name]'s birthday! Share and celebrate"
Option to create birthday Moment from Teams
User automatically tagged
Personal celebration simplified
Interaction Capabilities
What Users Can Do in Teams:
β View Mo notifications and content
β Create Moments (for occasions)
β Comment on Moments
β React with emojis to Moments
β Respond to Boost prompts
β Tag colleagues in responses
β View reward information
What Requires Mo Web/App:
β Creating standard Moments (not occasion-triggered)
β Accessing store and redeeming rewards
β Viewing full feed and browsing
β Managing profile settings
β Admin functions
Features Not Currently Available in Teams
Mo features without Teams notifications:
Nominations
Ideas
Challenges
Note: These features remain accessible through Mo web and mobile apps. Future releases may expand Teams integration coverage.
Technical Troubleshooting
Integration Not Working
Tenant ID Issues:
Verify tenant ID is correct
Check for extra spaces or characters when pasting
Confirm you copied the full ID after
tenantId=
Re-copy from Teams and paste again
Connection Status:
Check connection shows "Active" in Mo integrations page
Wait 5-10 minutes after initial configuration
Clear browser cache and check again
Contact Mo support if status remains inactive
Users Not Seeing Mo App
Check deployment status:
Verify 24 hours have passed since policy change
Confirm user is covered by correct app policy
Check if user needs to restart Teams
Verify Mo app is in "Installed apps" list
Policy configuration:
Confirm Global policy (or relevant policy) includes Mo
Check if user group has restricted policies
Verify no conflicting permission policies exist
Review Teams admin centre audit logs
Users Can't Link Accounts
Common causes:
User doesn't have Mo account yet
User already linked to different Teams account
Browser blocking authentication redirect
Pop-up blocker interfering
Solutions:
Verify user has active Mo account
Check user's email matches both systems
Disable pop-up blockers for mo.work domain
Try incognito/private browsing mode
Clear Teams cache and retry
Notifications Not Appearing
User-level checks:
Verify account linking is complete
Check Teams notification settings
Ensure Teams app is running
Confirm user hasn't muted Mo notifications
System-level checks:
Verify integration is active in Mo
Check no system-wide notification blocks
Review Teams admin notification policies
Test with known working account
Performance Issues
Slow notifications:
Microsoft Teams sync delays (normal up to several minutes)
Check Microsoft 365 service health status
Verify network connectivity
Review Teams performance generally
Missing content:
Check user permissions in Mo
Verify privacy settings on Moments
Confirm user is intended recipient
Review notification delivery logs (contact support)
Getting Help
For Technical Issues
Contact Mo Support:
Via chat icon or email: support@mo.work
Provide: Tenant ID, specific error messages, details for affected users
Contact Microsoft Support:
For Teams admin centre issues, app deployment problems or any other MS Teams specific problems.