Overview
With Microsoft Teams integration, your team can seamlessly chat with customers who use Teams from within Thena . No more juggling apps. No more missed messages. This guide will walk you through the setup process and explain the features available with the integration.Key features
Teams to Thena chat mirroring
Teams to Thena chat mirroring
- Customers stay in their preferred Teams environment
- Support agents work entirely from Thena
- All messages sync in real-time between platforms
- Conversations remain threaded and organized
Message threads
Message threads
- Replies stay organized in the correct thread
- Thread context is preserved across platforms
- Agents can follow multiple conversation threads simultaneously
- Historical thread navigation works as expected
Channel mapping
Channel mapping
- Connect multiple Teams channels to different Thena teams
- Supports standard, shared, and private channel types
- Route messages to the right team automatically
- Maintain separate conversation spaces for different departments
Reactions & emojis
Reactions & emojis
- Basic emoji reactions (👍, ❤️, 😂) sync between platforms
- Custom emoji reactions from Teams appear as text in Thena
- Emoji in message text is preserved in both directions
File attachments
File attachments
- Images, PDFs, and common file types fully supported
- Office documents (Word, Excel, PowerPoint) supported from Teams to Thena
- File previews available where supported by the platforms
- Large file transfers handled efficiently
Rich text formatting
Rich text formatting
- Bold, italic, and underline formatting
- Bulleted and numbered lists
- Code blocks and quotes
- Links with proper formatting
Pre-requisites
Setup guide
Enable Microsoft Teams
Download custom app
Upload to Teams
Chat with Thena bot
Authorize permissions
Complete in Thena web app
Select Thena teams
Team-level setup
Go to team settings
Navigate to channel mapping
View available channels
Map channels to Thena
Frequently asked questions
What permissions are required for MS Teams integration?
What permissions are required for MS Teams integration?
- Read/write access to Teams, channels, messages, and files
- Permission to manage app installations
- Access to user profiles and organization data
- Read/write messages permissions
- File upload capabilities
- Offline access for token refresh
How does message posting work between platforms?
How does message posting work between platforms?
- Messages try to post as the authenticated user first
- If the user isn’t authorized, Thena posts as the bot
- If the bot isn’t in the channel, Thena tries posting as the admin
- Users see an ephemeral message in Thena if a fallback occurs
- Messages are posted via the Thena bot with the original sender details preserved
What if my Thena and MS Teams email addresses don't match?
What if my Thena and MS Teams email addresses don't match?
- Contact your administrator to update your email address in either Thena or MS Teams
- Ensure your email addresses match across both platforms
- The integration relies on matching email addresses for proper user identification
Why aren't my messages reaching Teams?
Why aren't my messages reaching Teams?
- Confirm the channel is properly mapped in Thena team settings
- Make sure the Thena bot has been added to the correct Teams channel
- Check that you have the necessary permissions in both platforms
Why do my messages show as 'edited' in Teams?
Why do my messages show as 'edited' in Teams?
What should I do if my user token expires?
What should I do if my user token expires?
- Changed your Microsoft Teams password
- Lost or had your Teams access re-added
- Had your Microsoft license reassigned
- Been inactive for an extended period
Do I need Teams licenses for all my team members?
Do I need Teams licenses for all my team members?
Which channel types are supported?
Which channel types are supported?
- Standard channels: Recommended with full bot support
- Shared channels: Requires all users to be synced (no fallback bot)
- Private channels: Limited support for posting as admin or Thena bot
What message formatting is supported?
What message formatting is supported?
- Bold, italic, and strikethrough text
- Bulleted and numbered lists
- Code blocks and quoted text
- Basic emoji reactions