12 - Private Chat Backup

Doug Chanin
Doug Chanin
  • Updated

Topic

This article explains how to back up and download Microsoft Teams private chats.

Environment

NinjaOne SaaS Backup

Description

Microsoft Teams private chats are direct messages between individual users that are not part of a larger team chat. NinjaOne SaaS Backup does not back up Private chats by default. We must first enable the feature at the partner account level, so that you can then enable it for an individual organization. 

Enabling Private Chat Backup for an Organization

Our support team can assist you with enabling this feature at the partner level. You can then enable private chat backup for an organization as follows:

  1. From the Partner Portal, Navigate to Organizations.
  2. Select the "Kabob menu" (represented by three dots) to the right of the organization listing.
  3. Navigate to View DetailsFeatures
  4. Enable the M365 Private Chat Backup feature.
 Private chat backup is only available with the Backup+Archiver subscription.

Setting up Private Chat Backup

To set up the Private Chat backup feature for an organization, follow these steps:

  1. Log in to the end-user portal and click the Private Chat tab from the dashboard.
  2. Click Reauthenticate Now. You will be redirected to the Credentials tab on the Account Settings page.
  3. Click Reauthenticate to authorize the backup admin account to reauthenticate. Once reauthentication is complete, all M365 accounts currently backed up will display in the Private Chat tab with an 'INACTIVE' status.
  4. You will see a blue banner asking you to set up the Customer Tenant App. Click Go to Credentials and expand the See How to Connect section near the bottom of the screen.
  5. Click Download Here to view the steps required for setting up the tenant application. Alternatively, you can review the .pdf attached directly to this article: Private Chat Backup User Guide.pdf.
  6. Once the above steps are complete, click Test & Save Connection to complete the setup.

Activating Private Chat Backup

After the initial setup, Private Chat backups will be inactive for all users. You'll need to activate Private Chat backup before performing backups. Follow these steps to activate Private Chat Backups:

  1. On the Private Chat tab, you can activate in bulk or individually:
    • To activate in bulk on all accounts, select all accounts and then click Activate.
    • To activate individual users, select the private chat account and click Activate.
  2. Click Yes, Continue in the confirmation modal.

You can review the last backup status on this page once NinjaOne SaaS Backup has completed the backup.

In Teams Chat, there are various system notifications such as Call Ended, Deleted Message, User Joined or Left Chat, and others. Since the MS Graph API treats these notifications as messages, we back them up. However, when the End-User Portal detects a "System Event Message", it will display "System Event Message can't be previewed" instead of the message itself.

Private Chat Download

Follow these steps to download a private chat:

  1. Log in to the end-user portal, and from the dashboard page, select the Private Chat tab
  2. Move your cursor over the email address. You will see the download option on the right.
  3. Click Download. You can select from three file formats: EML, PDF, and CSV.
  4. Select the required file format. You can choose to download text only or text with attachments.
  5. Once you select the required download option, a prompt will appear to initiate the download. Select the desired date range and then click Generate Download.
  6. Click Yes, continue, to proceed.
    You can check on the status of the download by navigating to System StatusDownloads.
  7. Once the download completes, click the link to download the data.
Private chats are downloaded as .zip files, no larger than 1GB. If a download is larger than 1GB, it will be separated into multiple .zip files. Chats selected without a specific date range will only contain the last 90 days of chat history. If you select a duration of more than 90 days, it will be split into multiple files. Any attachments in the downloaded chat will appear in the Attachments folder in the .zip file.  

Additional Resources

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request