Microsoft Teams Chat Backup

This project retrieves a full chat history (messages and uploaded files) and renders it as an HTML.

Requirements

Node.js 12 (or higher). Tested on macOS and Windows, but will most likely run on Linux too.

Like any other JS project, clone this repo and run the following command to install dependencies:

npm install

To backup a chat, run:

npm run start

This will ask several questions:

Chat ID - this is the identifier of the conversation. To find it:

Go to https://teams.microsoft.com
Go to the chat you'd like to export.
Copy chat ID from URL. It looks like 19:<uuid of one user>-<uuid of other user>@unq.gbl.spaces or 19:<some uuid>@thread.skype
Add it to the Conversations array in index.js as a chatId and set the target property with the name of the conversation / folder

Auth token (JWT) - this is needed for calling Microsoft Graph APIs.

Go to https://developer.microsoft.com/en-us/graph/graph-explorer. At the left side, under Authentication, click "Sign In with Microsoft"
After having logged in, on the left side (where you clicked for login), click "modify permissions". Enable Chat.Read and re-login (like it states).
The URL contains the token (#access_token=<long token goes here>). Copy this value or make any random call in the sandbox and copy the Authorization from the "Access token" tab of the Graph Explorer page.

Target directory name - is the name to use for the export (will be created in the out directory in this project).

An exported chat contains:

messages-#####.json: these are the pages of messages. Page 0000 is the most recent one (pages and messages within are in reverse order).
image-#####: these are images uploaded in the chat
index.html: is the full history rendered into a simple HTML template, referring to the downloaded images. This is the file you want for viewing.