How to migrate file attachments in third party message apps to Teams?

[virajkanwade]

Type of issue

Missing information

Feedback

I came across https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams?WT.mc_id=M365-MVP-6934#step-3-import-messages

But it doesn't specify how to migrate attachments?

https://learn.microsoft.com/en-us/graph/api/chatmessage-post?view=graph-rest-1.0&tabs=http#example-4-send-a-message-with-file-attachment-in-it

This says the files need to be present in sharepoint.

Thanks

Page URL

https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams?WT.mc_id=M365-MVP-6934#step-3-import-messages

Content source URL

https://github.com/MicrosoftDocs/msteams-docs/blob/main/msteams-platform/graph-api/import-messages/import-external-messages-to-teams.md

Author

@AkJo

Document Id

ce77e760-90cf-e6b1-3cec-ae55ee50c33e

[Nivedipa-MSFT]

@virajkanwade - Thank you for your inquiry about your Teams app development issue!
To migrate file attachments from third-party message apps to Teams, you'll need to use Microsoft Graph APIs and perform several key steps:

1. Analyze and Prepare Message Data
Review the third-party data: Decide which data and file attachments you want to migrate.
Extract data: Extract the selected data and file attachments from the third-party chat system.
Map chat structure: Map the chat structure of the third-party system to the Teams structure.
Convert data format: Ensure the data is in the format needed for migration to Teams.

2. Set Up Your Microsoft 365 Tenant
Ensure a Microsoft 365 tenant exists: Make sure your tenant is set up for the import data.
Add team members: Ensure that team members are in Microsoft Entra ID.

3. Use Graph APIs to Post Messages with File Attachments
Obtain access tokens: Use the standard OAuth 2.0 authorization flow to obtain access tokens.
Access OneDrive/SharePoint: Access the files in OneDrive or SharePoint, depending on the type of files (personal, group chat, or channel files).

4. Send Files to Teams
Using the Graph API, you can post messages with file attachments. Here is an example on how to send a file attachment to a Teams chat:

POST https://graph.microsoft.com/v1.0/me/chats/{chat-id}/messages
Content-Type: application/json

{
  "body": {
    "content": "Here is the file you requested"
  },
  "attachments": [
    {
      "id": "1",
      "contentType": "reference",
      "contentUrl": "https://contoso.sharepoint.com/sites/Example/SharedDocuments/Example.xlsx",
      "name": "Example.xlsx"
    }
  ]
}

Doc References:

1. https://learn.microsoft.com/en-us/microsoftteams/platform/graph-api/import-messages/import-external-messages-to-teams#prerequisites

2. https://learn.microsoft.com/en-us/microsoftteams/platform/bots/how-to/bots-filesv4#use-the-graph-apis

Please let us know if you have any further query here.

[virajkanwade]

@Nivedipa-MSFT You again assumed, my files are in sharepoint. My question was more about, how do I transfer the files from the other chat to the MS environment in the first place!
Anyways, just yesterday, I managed to figure it out.

• Create team in migration mode
• Create channel in migration mode
• Get filesFolder location with the API (For some reason, out of the 1230 channels, 57 don't have filesFolder. It says the folder is not yet ready. The channels were all created together 3 days ago.)
• Download the file from the third party and upload it to the filesFolder.
• Then link the file in the message as per the docs.