Set up a connector to archive Telegram communications data

Use the TeleMessage connector in the Microsoft Purview compliance portal to import and archive Telegram chats, attachments, files, and deleted messages and calls. After you set up and configure a connector, it connects to your organization's TeleMessage account, and imports the mobile communication of employees using the Telegram Archiver to mailboxes in Microsoft 365.

After Telegram Archiver connector data is stored in user mailboxes, you can apply Microsoft Purview features such as Litigation Hold, Content search, and Microsoft 365 retention policies to Telegram communication data. For example, you can search Telegram communication using Content Search or associate the mailbox that contains the Telegram Archiver connector data with a custodian in an eDiscovery (Premium) case. Using a Telegram Archiver connector to import and archive data in Microsoft 365 can help your organization stay compliant with corporate governance regulations and regulatory policies.


If you're not an E5 customer, use the 90-day Microsoft Purview solutions trial to explore how additional Purview capabilities can help your organization manage data security and compliance needs. Start now at the Microsoft Purview compliance portal trials hub. Learn details about signing up and trial terms.

Overview of archiving Telegram communications data

The following overview explains the process of using a connector to archive Telegram communications data in Microsoft 365.

Telegram communications archiving workflow.

  1. Your organization works with TeleMessage to set up a Telegram Archiver connector. For more information, see Activating the TeleMessage Telegram Archiver for Microsoft 365.

  2. In real time, your organization's Telegram data is copied to the TeleMessage site.

  3. The Telegram Archiver connector that you create in the compliance portal connects to the TeleMessage site every day and transfers the email messages from the previous 24 hours to a secure Azure Storage area in the Microsoft Cloud.

  4. The connector imports the mobile communication items to the mailbox of a specific user. A new folder named Telegram Archiver will be created in the specific user's mailbox and the items will be imported to it. The connector does this mapping by using the value of the User's Email address property. Every email message contains this property, which is populated with the email address of every participant of the email message.

In addition to automatic user mapping using the value of the User's Email address property, you can also define a custom mapping by uploading a CSV mapping file. This mapping file should contain User's mobile Number and the corresponding Microsoft 365 mailbox address for each user. If you enable automatic user mapping and provide a custom mapping, for every email item the connector will first look at custom mapping file. If it doesn't find a valid Microsoft 365 user that corresponds to a user's mobile number, the connector will use the User's email address property of the email item. If the connector doesn't find a valid Microsoft 365 user in either the custom mapping file or the user's email address property of the email item, the item won't be imported.

Before you set up a connector

  • Order the Telegram archiving service from TeleMessage and get a valid administration account for your organization. You'll need to sign into this account when you create the connector in the compliance center.

  • Register all users that require Telegram archiving in the TeleMessage account. When registering users, be sure to use the same email address that's used for their Microsoft 365 account.

  • Install the Telegram Archiver app on the mobile phones of your employees and activate it. The Telegram Archiver app allows them to communicate and chat with other Telegram users.

  • The user who creates a Telegram Archiver connector in Step 3 must be assigned the Data Connector Admin role. This role is required to add connectors on the Data connectors page in the compliance portal. This role is added by default to multiple role groups. 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 the "Create a custom Microsoft Purview role group" section in Permissions in the Microsoft Purview compliance portal.

  • This TeleMessage data connector is available in GCC environments in the Microsoft 365 US Government cloud. Third-party applications and services might involve storing, transmitting, and processing your organization's customer data on third-party systems that are outside of the Microsoft 365 infrastructure and therefore aren't covered by the Microsoft Purview and data protection commitments. Microsoft makes no representation that use of this product to connect to third-party applications implies that those third-party applications are FEDRAMP compliant.

Create a Telegram Archiver connector

After you've completed the prerequisites described in the previous section, you can create the Telegram Archiver connector in the compliance portal. The connector uses the information you provide to connect to the TeleMessage site and transfers Telegram communications data to the corresponding user mailbox boxes in Microsoft 365.

  1. Go to and then select Data connectors > Telegram Archiver.

  2. On the Telegram Archiver product description page, select Add connector.

  3. On the Terms of service page, select Accept.

  4. On the Login to TeleMessage page, under Step 3, enter the required information in the following boxes and then select Next.

    • Username: Your TeleMessage username.

    • Password: Your TeleMessage password.

  5. After the connector is created, you can close the pop-up window and go to the next page.

  6. On the User mapping page, enable automatic user mapping. To enable custom mapping, upload a CSV file that contains the user mapping information, and then select Next.

  7. Review your settings, and then select Finish to create the connector.

  8. Go to the Connectors tab in Data connectors page to see the progress of the import process for the new connector.

Known issues

  • At this time, we don't support importing attachments or items that are larger than 10 MB. Support for larger items will be available at a later date.