Share via


Set up a connector to archive TELUS Network data

Use the TeleMessage connector to import and archive Short Messaging Service (SMS) data from your organization's TELUS Network. After you set up and configure a connector, it connects to your organization's TELUS Network once every day and imports SMS data to mailboxes in Microsoft 365.

After storing SMS messages in user mailboxes, you can apply Microsoft Purview features such as Litigation Hold, Content Search, and Microsoft 365 retention policies to TELUS data. For example, you can search TELUS SMS messages by using Content Search or associate the mailbox that contains the TELUS data with a custodian in an eDiscovery (Premium) case. Using a TELUS Network connector to import and archive data in Microsoft 365 can help your organization stay compliant with government and regulatory policies.

Overview of archiving TELUS Network data

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

TELUS Network archiving workflow.

  1. Your organization works with TeleMessage and TELUS to set up a TELUS Network connector. For more information, see TELUS Network Archiver.

  2. In real time, SMS messages from your organization's TELUS Network are copied to the TeleMessage site.

  3. The TELUS Network connector that you create in the Microsoft Purview portal connects to the TeleMessage site every day and transfers the SMS messages from the previous 24 hours to a secure Azure Storage location in the Microsoft cloud. The connector also converts the content of SMS messages to an email message format.

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

    In addition to automatic user mapping by using the value of the User’s Email address property, you can also implement custom mapping by uploading a CSV mapping file. This mapping file contains the mobile phone number and corresponding Microsoft 365 email address for users in your organization. If you enable both automatic user mapping and custom mapping, for every TELUS item the connector first looks at custom mapping file. If it doesn't find a valid Microsoft 365 user that corresponds to a user's mobile phone number, the connector uses the values in the email address property of the item it's trying to import. If the connector doesn't find a valid Microsoft 365 user in either the custom mapping file or in the email address property of the TELUS item, the item won't be imported.

Before you set up a connector

Important

All partner third-party data connector configurations require a provisioned service principal for the partner application. This requirement isn't applicable for native Microsoft third-pary data connector configurations.

To provision a service principal using PowerShell, see Provision a service principal for partner third-party data connectors.

Some of the implementation steps required to archive TELUS Network data are external to Microsoft 365. You must complete these steps before you can create a connector in the compliance center.

  • Order the TELUS Network Archiver service from TeleMessage and get a valid administration account for your organization. You need to sign in to this account when you create the connector in the compliance center.

  • Obtain your TELUS Network account and billing contact details so you can fill out the TeleMessage onboarding forms and order the message archiving service from TELUS.

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

  • Ensure your employees have corporate-owned and corporate-liable mobile phones on the TELUS mobile network. Archiving messages in Microsoft 365 isn't available for employee-owned or Bring Your Own Devices (BYOD) devices.

  • Assign the Data Connector Admin role to the user who creates a TELUS Network connector. This role is required to add connectors on the Data connectors page in the Microsoft Purview portal. Multiple role groups include 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:

  • Use this TeleMessage data connector 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. Therefore, these systems 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 TELUS Network connector

After you complete the prerequisites described in the previous section, create a TELUS Network connector in the Microsoft Purview portal. The connector uses the information you provide to connect to the TeleMessage site and transfer SMS messages to the corresponding user mailboxes in Microsoft 365.

  1. Sign in to the Microsoft Purview portal.

  2. Select Settings > Data connectors.

  3. Select My connectors, then select Add connector.

  4. From the list, choose TELUS Network.

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

  6. 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.
  7. After you create the connector, close the pop-up window.

  8. On the User mapping page, enable automatic user mapping and select Next. To use custom mapping, upload a CSV file, and select Next.

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

Limits

Importing attachments or items supports files up to 10 MB.