Set up a Microsoft connector to archive Twitter data (preview)

Use a connector to import and archive data from Twitter to Microsoft 365. After you set up and configure the connector, it connects to your organization's Twitter account (on a scheduled basis), converts the content of an item to an email message format, and then imports those items to a mailbox in Microsoft 365.

After Twitter data is imported, you can apply Microsoft Purview features such as Litigation Hold, Content Search, In-Place Archiving, Auditing, Communication compliance, and Microsoft 365 retention policies to the data stored in the mailbox. For example, you can search Twitter data using Content Search or associate the mailbox where the data is stored with a custodian in an eDiscovery case. Using a connector to import and archive Twitter data in Microsoft 365 can help your organization stay compliant with government and regulatory policies.

Before you set up a connector

Complete the following prerequisites before you set up and configure a connector in the Microsoft Purview portal to import and archive data from your organization's Twitter account.

• You need a Twitter account for your organization. You need to sign in to this account when setting up the connector.

• Your organization must have a valid Azure subscription. If you don't have an existing Azure subscription, you can sign up for one of these options:

  • Sign up for a free one year Azure subscription

  • Sign up for a Pay-As-You-Go Azure subscription

• The Twitter connector can import a total of 200,000 items in a single day. If there are more than 200,000 Twitter items in a day, none of those items are imported to Microsoft 365.

• The user who sets up the Twitter connector in the Microsoft Purview portal (in Step 5) must be assigned the Data Connector Admin role. This role is required to add connectors on the Data connectors page in the Microsoft Purview portal. Multiple role groups have this role by default. For a list of these role groups, see Roles in Microsoft Defender for Office 365 and Microsoft Purview compliance. Alternatively, an admin in your organization can create a custom role group, assign the Data Connector Admin role, and then add the appropriate users as members. For instructions, see:

  • Permissions in the Microsoft Purview portal
  • Roles and role groups in Microsoft Defender for Office 365 and Microsoft Purview compliance

Step 1: Create an app in Microsoft Entra ID

First, register a new app in Microsoft Entra ID. This app corresponds to the web app resource that you implement in Step 2 for the Twitter connector.

For more information, see Create an app in Microsoft Entra ID.

When you complete this step, save the following information to a text file. You'll use these values in later steps in the deployment process.

• Microsoft Entra application ID
• Microsoft Entra application secret
• Tenant Id

Step 2: Deploy connector web service from GitHub repository to your Azure account

Next, deploy the source code for the Twitter connector app that uses the Twitter API to connect to your Twitter account and extract data so you can import it to Microsoft 365. The Twitter connector that you deploy for your organization uploads the items from your organization's Twitter account to the Azure Storage location that you create in this step. After you create a Twitter connector in the Microsoft Purview portal (in Step 5), the Microsoft 365 Import service copies the Twitter data from the Azure Storage location to a mailbox in Microsoft 365. As explained in the Before you set up a connector section, you must have a valid Azure subscription to create an Azure Storage account.

To deploy the source code for the Twitter connector app:

1. Go to this GitHub site.
2. Select Deploy to Azure.

For more information, see Deploy the connector web service from GitHub to your Azure account.

When you complete this step, provide the following information:

• APISecretKey: Create this secret during the completion of this step. You use it in Step 5.
• tenantId: The tenant ID of your Microsoft 365 organization that you copied after creating the Twitter app in Microsoft Entra ID in Step 1.

After you complete this step, be sure to copy the app Service URL (for example, https://twitterconnector.azurewebsites.net). You need to use this URL to complete Step 3, Step 4, and Step 5.

Step 3: Create developer app on Twitter

Create and configure a developer app on Twitter. The custom connector you create in Step 7 uses the Twitter app to interact with the Twitter API and obtain data from your organization's Twitter account.

For step-by-step instructions, see Create the Twitter app.

When you complete this step, save the following information to a text file. You'll use these values to configure the Twitter connector app in Step 4.

• Twitter API Key
• Twitter API Secret Key
• Twitter Access Token
• Twitter Access Token Secret

Step 4: Configure the Twitter connector app

Add configuration settings to the Twitter connector app that you deployed in Step 2. Go to the home page of your connector app and configure it.

For step-by-step instructions, see Configure the connector web app.

When you complete this step, provide the following information. You copied this information to a text file after completing the previous steps:

• Twitter API Key (obtained in Step 3)
• Twitter API Secret Key (obtained in Step 3)
• Twitter Access Token (obtained in Step 3)
• Twitter Access Token Secret (obtained in Step 3)
• Microsoft Entra application ID (the Microsoft Entra application ID obtained in Step 1)
• Microsoft Entra application secret (the Microsoft Entra application secret obtained in Step 1)

Step 5: Set up a Twitter connector in the Microsoft Purview portal

In this step, you set up the Twitter connector in the Microsoft Purview portal. The connector imports data from your organization's Twitter account to a specified mailbox in Microsoft 365. When you finish this step, the Microsoft 365 Import service starts importing data from your organization's Twitter account to Microsoft 365.

For step-by-step instructions, see Set up a Twitter connector.

As you complete this step, provide the following information and save it in a text file:

• Azure app service URL (obtained in Step 2; for example, https://twitterconnector.azurewebsites.net)
• APISecretKey (created in Step 2)