Integrations

Integration with Microsoft Teams

Updated 1 week ago
25.3K views
4.6 rating

Table of Contents

Introduction

Integrating Telphi VoIP services with Microsoft Teams creates a unified communication experience, allowing your team to make and receive calls directly within Teams while leveraging your existing phone infrastructure. This guide covers multiple integration methods, from simple calling plans to advanced Direct Routing configurations.

Why Integrate?

Teams integration eliminates the need to switch between applications, provides a single interface for all communications (chat, calls, video), and reduces training requirements while maintaining enterprise calling features.

Integration Options

Choose the integration method that best fits your organization's needs, technical capabilities, and budget:

Direct Routing

Connect existing SIP trunks to Teams

✓ Advantages
  • Keep existing numbers
  • Full control
  • Cost-effective
  • Flexible routing
✗ Limitations
  • Complex setup
  • Requires SBC
  • Technical expertise needed
Recommended for: Enterprise customers with existing infrastructure

Operator Connect

Managed service from certified operator

✓ Advantages
  • Simple setup
  • Managed by provider
  • Quick deployment
  • Built-in support
✗ Limitations
  • Limited providers
  • Less control
  • Ongoing fees
Recommended for: Organizations wanting turnkey solution

Calling Plan

Microsoft's native calling service

✓ Advantages
  • Fully integrated
  • Simple management
  • No SBC needed
  • Microsoft support
✗ Limitations
  • Limited regions
  • Higher cost
  • Limited features
Recommended for: Small businesses in supported regions

Prerequisites

Before starting the integration, ensure you have the following:

Microsoft Requirements

Microsoft 365 E3/E5 or Business Premium
Teams Phone System license (per user)
Global Administrator access
Teams Admin Center access
PowerShell Module installed (Direct Routing)

Telphi Requirements

Active Telphi VoIP account
SIP trunk credentials (Direct Routing)
Session Border Controller (SBC) if using Direct Routing
Public IP addresses for SBC
Valid SSL certificates for SBC

Network Requirements

Ensure your network meets Microsoft's requirements: Minimum 100 kbps per concurrent call, QoS configured for VoIP traffic, firewall ports opened for Teams SIP signaling (TCP 5061) and media (UDP 3478-3481, 49152-53247).

Direct Routing Setup

Direct Routing is the most flexible integration method. Follow these steps for configuration:

1

Configure Session Border Controller (SBC)

Deploy and configure your SBC to handle signaling and media between Teams and your SIP trunk.

SBC Configuration Steps:

  1. Install certified SBC (AudioCodes, Ribbon, Oracle, etc.)
  2. Obtain and install SSL certificate for SBC FQDN
  3. Configure SBC public IP and DNS records
  4. Set up SIP trunk to Telphi (port 5060/5061)
  5. Configure TLS connection to Microsoft Teams
  6. Enable media bypass if supported
2

Connect SBC to Teams

Use PowerShell to register your SBC with Microsoft Teams.

# Connect to Teams PowerShell
Connect-MicrosoftTeams

# Add SBC to tenant
New-CsOnlinePSTNGateway `
-Fqdn "sbc.yourdomain.com" `
-SipSignalingPort 5061 `
-MaxConcurrentSessions 100 `
-Enabled $true
3

Create Voice Routing Policy

Define how calls are routed based on dialed numbers.

# Create PSTN usage
Set-CsOnlinePstnUsage -Identity Global `
-Usage @{Add="Telphi-Usage"}
# Create voice route
New-CsOnlineVoiceRoute -Identity "Telphi-Route" `
-NumberPattern ".*" `
-OnlinePstnGatewayList sbc.yourdomain.com `
-Priority 1 -OnlinePstnUsages "Telphi-Usage"
# Create routing policy
New-CsOnlineVoiceRoutingPolicy "Telphi-Policy" `
-OnlinePstnUsages "Telphi-Usage"
4

Assign Licenses & Policy

Enable users for Teams calling and assign the voice routing policy.

# Assign voice routing policy to user
Grant-CsOnlineVoiceRoutingPolicy `
-Identity "user@yourdomain.com" `
-PolicyName "Telphi-Policy"
# Set phone number
Set-CsPhoneNumberAssignment `
-Identity "user@yourdomain.com" `
-PhoneNumber "+15551234567" `
-PhoneNumberType DirectRouting
5

Test the Connection

Verify the integration is working correctly.

  • Check SBC health in Teams Admin Center
  • Make a test call from Teams to external number
  • Receive a test call to Teams user's number
  • Verify call quality and media path

Operator Connect Setup

Operator Connect provides a simplified, managed integration experience:

Simplified Setup Process

1️⃣
Select Operator
Choose Telphi from Teams Admin Center
2️⃣
Authorize
Grant permissions to Telphi
3️⃣
Configure
Set numbers and policies
4️⃣
Activate
Start making calls

Benefits of Operator Connect

  • No SBC required - fully managed
  • Setup time: 1-2 hours vs. days
  • Automatic updates and maintenance
  • Built-in support from Telphi
  • Native Teams experience
  • Simplified billing and management

Contact Synchronization

Sync contacts between Telphi and Teams for seamless calling experience:

One-Way Sync (Telphi → Teams)

Import contacts from Telphi to Teams for easy dialing.

  1. Export contacts from Telphi admin portal (CSV format)
  2. Open Teams Admin Center
  3. Navigate to Users → Manage users
  4. Import CSV file with phone numbers
  5. Map fields correctly (Name, Number, Department)

Two-Way Sync (Advanced)

Automatic synchronization using Microsoft Graph API.

Requirements:

  • Azure AD app registration
  • API permissions (Contacts.ReadWrite)
  • Telphi API integration enabled
  • Custom sync script or middleware
Contact Telphi support for enterprise sync solutions

Available Call Features

Once integrated, you can use these calling features within Teams:

Click-to-Call

Call contacts directly from Teams interface

All methods

Presence Sync

Show availability status across platforms

Direct Routing, Operator Connect

Call Transfer

Transfer calls between Teams and desk phones

All methods

Voicemail Integration

Unified voicemail in Teams

All methods

Call History

View all calls in Teams activity feed

All methods

External Transfer

Transfer to non-Teams numbers

Direct Routing only

Enhanced Features with Direct Routing

Call Control
  • Call park and retrieve
  • Group call pickup
  • Boss/Admin delegation
  • Simultaneous ring
Advanced Routing
  • Location-based routing
  • Call queue integration
  • Auto attendant workflows
  • Emergency calling (E911)

Common Issues & Solutions

Issue: Cannot Make Outbound Calls

  • Verify voice routing policy is assigned to user
  • Check dial plan configuration (number normalization)
  • Ensure PSTN usage and voice route are configured
  • Verify SBC is online in Teams Admin Center
  • Check firewall allows SIP traffic (TCP 5061)
  • Review SBC logs for error messages

Issue: Calls Drop After 30 Seconds

  • Check SBC certificate is valid and trusted
  • Verify SIP OPTIONS keepalive is configured
  • Ensure media bypass settings are correct
  • Check NAT traversal configuration
  • Verify firewall timeout settings (> 300 seconds)
  • Review SIP session timer settings

Issue: Poor Call Quality

  • Enable QoS on network for Teams traffic
  • Check bandwidth availability (100 kbps minimum per call)
  • Verify codec configuration (prefer Opus or G.722)
  • Test network jitter and packet loss (< 30ms, < 1%)
  • Check WiFi signal strength for remote users
  • Enable media bypass if supported by SBC

Issue: Inbound Calls Not Ringing

  • Verify phone number is assigned to user in Teams
  • Check number format (E.164: +15551234567)
  • Ensure user has Teams Phone license
  • Review call forwarding settings in Teams
  • Check Do Not Disturb status in Teams
  • Verify SBC trunk is properly configured for inbound routing

Diagnostic Tools

Teams Admin Center

Voice → Direct Routing → SBC Health Dashboard

Call Analytics

Users → Call history → Call details with quality metrics

PowerShell Cmdlets

Get-CsOnlinePSTNGateway, Test-CsOnlineUserVoiceRouting

Best Practices

Do's

  • Use certified SBCs for Direct Routing
  • Implement redundant SBCs for high availability
  • Enable media bypass for better call quality
  • Configure QoS on network infrastructure
  • Monitor SBC health and call quality regularly
  • Keep SBC firmware up to date
  • Document your voice routing configuration
  • Test failover scenarios periodically

Don'ts

  • Don't use self-signed certificates in production
  • Don't skip network quality testing
  • Don't deploy without backup SBC
  • Don't ignore SBC health alerts
  • Don't forget to configure emergency calling
  • Don't use default SBC credentials
  • Don't skip user training on Teams calling
  • Don't deploy to all users at once (pilot first)

Advanced Features

Take your Teams integration to the next level with these advanced capabilities:

Call Analytics & Reporting

Leverage Teams Call Analytics and Telphi reporting for comprehensive insights:

Teams Call Quality Dashboard

  • Real-time call quality metrics
  • Network performance analysis
  • User experience reporting
  • Trend analysis and alerts

Telphi Analytics Integration

  • Combined CDR reporting
  • Cost allocation and billing
  • Trunk utilization statistics
  • Custom dashboard creation

Location-Based Routing

Route calls based on user location for compliance and cost optimization:

Use Cases:

  • Toll bypass for international offices
  • Regulatory compliance (PSTN gateway restrictions)
  • Emergency services (E911) accurate routing
  • Cost optimization through local breakout

Voicemail Transcription

Enable AI-powered voicemail transcription in Teams:

  1. Enable Cloud Voicemail in Teams Admin Center
  2. Configure voicemail policies for users/groups
  3. Set transcription language preferences
  4. Configure email notification with transcription

✓ Voicemails appear in Teams with text transcription, searchable in Teams search, and optionally forwarded to email

Ready to Integrate Teams?

Our integration specialists are available to help you deploy Microsoft Teams calling with Telphi VoIP services.

Related Articles

Mobile

Setting Up Mobile Applications

8 min read
Security

Network Security Configuration

15 min read
Configuration

Configuring Call Forwarding Rules

10 min read