Microsoft Teams, part of the Microsoft 365 family of products, is a chat-based workspace that combines instant messaging, voice, video, calling, and file-sharing. Onna connects directly to the Microsoft 365 Graph API and Export API to collect channels, chats, and other metadata from your Microsoft Teams account. Additionally, you can export the data collected in an eDiscovery-ready format.

For a short video overview of collecting from Microsoft Teams, please see below:

In this article, you will learn how to create a Microsoft Teams collection and find answers to common questions for this connector.

Requirements

To create a Microsoft Teams collection in Onna you need:

If you are interested in using Onna on your private cloud, requirements may change. For further information, contact support@onna.com.

Create a Microsoft Teams collection

To create a Microsoft Teams collection:

1. Browse to your Workspace and click + in the top right corner.

🗒 You can also create a private collection from the My Sources section. However, if you want to move it to a Workspace later on, you will need to contact our support team.

2. Select Microsoft Teams Enterprise from the list of available applications.

3. On the Add new Microsoft Teams Enterprise dialog, enter the collection details and then click Continue as…..

  • Enter a name for your collection. A common naming convention for eDiscovery purposes is to name it after the company or individual. For example, Onna VS Acmecorp.

  • Select one of the available sync modes. This connector supports One-time sync and Auto-sync and Archive.

  • (Optional) Set the sync dates. If you don’t set any date, Onna collects all the data available in Microsoft Teams.

🗒 If you already gave Onna access to your Microsoft Teams account, you can choose to continue as the account that is already authorized or click Switch account to connect with another account.

4. On the Add new Microsoft Teams Enterprise: Configuration dialog, select what to sync and click Next.

🗒 All chats (one-on-one and group) will be collected by default for the accounts selected to sync. Later you can choose which teams and channels to sync for each user.

5. On the Add new Microsoft Teams Enterprise: Accounts dialog, add the users you want to collect data from using one of the options available, then click Next:

  • Add user accounts manually by entering their email addresses. Multiple addresses must be separated with a comma.

  • Select users from a list by clicking Load users > From list. If your collection is set to Auto-sync and Archive, you can also enable the option Sync newly created users. When you enable it, their data is added to the collection when Onna syncs with Microsoft Teams.

  • Load users from a CSV file by clicking Load users > From CSV. If you go with this option, your CSV file must have one email address per line.

6. On the Add new Microsoft Teams Enterprise: User channels dialog, choose the teams and channels that you want to collect for each of the selected users. You can use the > button next to each user to display and select the teams and channels that you want to collect.

🗒 If your collection is set to Auto-sync and Archive, you can also enable the option Sync newly created teams and channels. When you enable it, data from newly created teams and channels from the selected user is added to the collection.

7. Click Done to finish creating the collection. As data is collected, you will start seeing it in your Onna account.

What’s next?

Now that you created the collection, there are a few things you can do:


Onna connector for Microsoft Teams FAQs

Here you can find answers to the most common questions about Onna’s Microsoft Teams connector.

What data can Onna collect from Microsoft Teams?

Microsoft Teams API is limited, however with Onna we are able to collect.

  • Messages and reactions (emojis) in channels, one-on-one chats, and group chats. Messages collected are grouped in daily conversations

  • Metadata for teams, channels, and chats. Metadata includes IDs, display names, topics, archival status, and members (including inactive)

  • Gifs and images

  • Attachments and their metadata

At the moment, Onna can’t collect:

  • Channel events, such as channel renamed, member added, or channel deleted

  • Team events, such as team renamed or member added

  • Files shared outside of your organization

What sync modes does this connector support?

The Microsoft Teams connector supports these sync modes:

  • One-time sync

  • Auto-sync and Archive

You can learn more by reading our documentation about sync modes.

Can Onna track edits and deletions for Microsoft Teams?

Onna can collect edits and deletions in Microsoft Teams as long as:

  • The revision happens on a message that Onna has already captured.

  • Your MS Teams source is in an auto-sync and archive mode.

This is due to Microsoft Teams API not capturing revisions, so we’ve made them available only in Onna ”

What are known issues or limitations for the connector?

  • Adaptive cards cannot be displayed in the preview. However, you can still search for them and export them.

  • Some emojis may appear different in Onna than in Teams

Does Onna keep an audit log of the data collected?

Yes, Onna keeps an audit log of all the files, documents, conversations, and other resources collected. You can learn more by reading our documentation about audit logs.

Can I export data collected from Microsoft Teams?

Yes, you can export data and metadata in an eDiscovery-ready file format, such as DAT, CSV, or custom text file.

For instructions on how to create an export, we recommend reading our documentation about exports.

If you perform an advanced export, you can also select what data you want to export. The data Onna can export is:

Select…

…to export

Conversation > Conversation ID

The unique ID used to identify a conversation

Conversation > Conversation name

The name that describes a conversation

Conversation > Conversation type

The conversation type, which can either be a channel or a private conversation with two or more participants

MessageList

Reactions and emojis

RelatedUsers

The members of a conversation

Any option in the Custom fields section

Other custom metadata collected from Microsoft Teams

How can I search for the Microsoft Teams data collected by Onna?

There are many ways you can search for data in Onna. You can also enable searchable fields to get more relevant search results. To understand which searchable fields are relevant for Microsoft Teams, contact our support team.

What permissions does Onna require from Microsoft Teams?

To connect to your Microsoft Teams instance, Onna needs the following permissions:

  • Maintain access to data you have given it access to

  • Read user chat messages

  • Access directory as the signed in user

  • Read directory data

  • Read all files that user can access

  • Read all groups

  • Read user mailbox settings

  • Read user mail

  • Read items in all site collections

  • Sign in and read user profile

  • Read all chat messages

  • Read directory data

  • Read files in all site collections

  • Allows the app to read all files in all site collections without a signed in user.

  • Read all groups

  • Read all user mailbox settings

  • Read mail in all mailboxes

  • Read items in all site collections

  • Read all users' full profiles

Why do I need a Microsoft Teams privileged role admin user account?

Onna uses the Microsoft Graph APIs to collect all your Microsoft Teams user data. For this, Onna requires organization-wide Graph API access. Only Microsoft users accounts with an Administrative Role can consent this access. The user role with least privileges that can consent this is the Privileged Role Administrator. You can also use a role with greater privileges, such as Global Administrator.

We recommend using a service account with the appropriate Administrator Role to grant Onna access to your account.

For the purpose of setting up Onna with your Microsoft Teams account, we recommend creating a user account with the appropriate privileges instead of using an existing personal user account.

Check out Microsoft documentation about admin roles and on how to assign these roles.

What are the rate limits for the Microsoft Teams connector?

All rate limits imposed by this connector come from Microsoft.

What Microsoft license do I need to collect data from Teams using Onna?

According to Microsoft, you can use this connector if you have any of the licenses for subscribing to chat messages. We recommend you to check their documentation for a list of the licenses.

You also need access to the Teams Export API. Currently access to this API is included with licenses that allow subscribing to chat messages. You don’t need to take any other action if you have one of those licenses. However, the official documentation indicates that requirements to access the API may change in the future. This is why we recommend to check the official documentation.

Got more questions?

If you didn’t find the answer to your questions in this article, you can contact us at support@onna.com.

Did this answer your question?