Skip to content

Microsoft Teams Connector

The Microsoft Teams Connector allows you to integrate myCloudPBX with Microsoft Teams using Direct Routing. This enables Teams users to place and receive external phone calls via the same infrastructure used by traditional myCloudPBX users.

Use Cases

  • Let Teams users be part of internal ring groups, call queues, or call flows
  • Seamlessly integrate Microsoft Teams into your existing PBX workflow
  • Support hybrid deployments or smooth migration from desk phones to Teams-only environments

Connector Configuration

The left-hand side of the screen contains connector-level settings:

Field Description
Connector Type Pre-filled as Microsoft Teams
Name A label to identify this connector (e.g. "Microsoft Teams Connector Demo")
Country Sets the default regional settings (e.g. number formatting)
Timezone Used for logs and time-sensitive operations
Default Outbound Number The number used for outbound calls from Teams users
MS Teams Domain A unique domain allocated for use with Microsoft Teams Direct Routing (e.g. 25ce6eb0.teams.mycloudpbx.com.au)
Domain Verification Text The TXT record value provided by Microsoft (e.g. ms=123456)

Once the connector is created, the MS Teams Domain and Domain Verification Text are generated. These are used to verify your domain with Microsoft 365.

DNS Verification

To complete Microsoft Teams Direct Routing setup, you must verify the Teams domain in Microsoft 365.

Steps:

  1. Go to the Microsoft 365 Admin Center
  2. Navigate to Settings → Domains
  3. Click Add Domain
  4. Enter the MS Teams Domain shown in the connector screen
  5. Microsoft will prompt you to add a TXT DNS Record (e.g. ms=123456)
  6. Enter this value into the Domain Verification Text field in the portal
  7. Save the connector
  8. Complete domain verification in Microsoft 365

User Mapping

The right-hand panel allows you to define which internal users (extensions) are part of the Teams integration:

Column Description
Ext Number Internal extension number (e.g. 101, 114, 115)
Label / Name Optional descriptive label (e.g. "Ben", "Jerry")
Action Click Delete to remove a user from the Teams connector

Adding a User:

  1. Enter the extension number in the User Extension field (e.g. 116)
  2. Click Add User
  3. Optionally assign a name to help identify the user
  4. Click Update Users to save changes

These users will now be linked with Microsoft Teams users.

Microsoft Teams Configuration

Once the domain is verified:

  1. Log in to the Teams Admin Center
  2. Navigate to Users → Manage Users
  3. For each user who should use Direct Routing:
  4. Assign a phone number matching the extension configured in myCloudPBX (e.g. 101)
  5. Ensure voice routing policies are applied (see below)

Voice Routing (Optional)

If needed, configure additional voice routing in Teams:

  • Create or update Voice Routing Policies, PSTN Usages, and Dial Plans
  • Assign policies to Teams users via PowerShell or Teams Admin Center

Example PowerShell Snippet

Set-CsPhoneNumberAssignment -Identity "ben@example.com" `
  -PhoneNumber +61370006700 `
  -PhoneNumberType DirectRouting