stefanjf / Archive-MS-Teams-Messages

Archive MS Teams Channel Messages

Having problems running this to archive your CVR Teams messages? Drop me a note at [e-mail] and I'd be happy to archive your channels (if you give me permissions to your Team).

This tool was developed by Stefan Fernandez. This version has additional features added by Dan Risacher ([e-mail])

Overview

This was written to support CVR Teams migration efforts. However, it should work on any Teams tenant that is accessible from the Microsoft Graph API.

This code uses the Microsoft Graph API to pull and output all messages (and replies) from a channel(s) in a Team. It outputs JSON and a parsed HTML version of the channel's messages. Here's an example of what the HTML output looks like:

Prerequisites

• Python 3
  -- Must have these packages installed: requests, datetime, yaspin, python-dateutil
  pip install requests datetime yaspin python-dateutil

NOTE: For those archiving from (DOD) CVR Teams, the data may include FOUO/CUI. Recommend only running this code from an appropriate computer.

Limitations

This script only works for 'Channel' messages. It does not work for regular 'Chat' messages, which may or may not be possible through the API. I did not investigate this.

Instructions

Step 0 - Get an User Auth Token

a) Navigate to https://developer.microsoft.com/en-us/graph/graph-explorer
b) Sign in with your CVR Teams account
c) Run any query
d) Click the 'Access Token' tab and copy the token for later use.

Step 1 - Set up

• Git clone this repository or download archive_teams_messages.py to your working directory.
• Open up a python 3 interactive session in the same working directory.

Step 2 - List Groups and Channels

• In the python interactive session run the following to import the module:

from archive_teams_messages import *

Set your user auth token that you got from Step 0

setToken('super-long-auth-token-here')

Then run listMyTeams() to show Teams and Channels that you belong to. Example output below:

054cf813-27a2-4c24-98ae-03fad4c495ee   AF/A9A
        19:[e-mail]   General
3055aa2d-b68d-4a8d-861c-0965de9ad15d   AF Analytic Community
        19:[e-mail]   General
        19:[e-mail]   Crowdsourcing
        19:[e-mail]   AFAC (15A and 1515) Meetings
        19:[e-mail]   Announcements

Step 3 (Option A) - Download all messages from all channels

Run pullAllChannelMessagesInGroup("groupID") where groupID is the id from the previous step.

Example for "AF Analytic Community" group:

pullAllChannelMessagesInGroup('3055aa2d-b68d-4a8d-861c-0965de9ad15d')

This will pull messages from all channels in that group and output .json and .html files into the current working directory.

Step 3 (Option B) - Download all messages from a single channel

Run pullSingleChannelMessagesInGroup("groupID", "channelID") where groupID and channelID are the relevant ids from the previous step.

Example for "General" channel of the "AF Analytic Community" group:

pullSingleChannelMessagesInGroup('3055aa2d-b68d-4a8d-861c-0965de9ad15d', '19:[e-mail]')

This will pull messages from that channel and output .json and .html files into the current working directory.

Step 3 (Option C) - Download all messages from all channels in all teams

Run pullAllChannelsInAllGroups()

This will pull messages from all channels in all groups that the user is a member of and output to teamname/channelname.json and teamname/channelname.html files