Others

Create a Teams Click-to-Call Link for External Phone Numbers

Maira Mehtab Sep 28, 2026 870 views

Question details

The user needs to create a SharePoint hyperlink that launches Microsoft Teams to call external contacts who only have phone numbers.

Product: Microsoft Teams
Device & OS: not provided
Scenario: Setting up internal enterprise portals or directories in SharePoint to quickly dial external phone numbers via Microsoft Teams.
Observed behavior: SharePoint Quick Links do not natively support direct Teams call links for external numbers without custom configurations, and standard tel links depend on the browser and device's default calling app settings.

Before you start

Verify that your organization's IT policies allow outbound calling to external numbers in Microsoft Teams and ensure Teams is set as your default calling app in your system settings.

Solution 1Recommended

Use a Custom SPFx Web Part with a Tel Protocol Link

Implement a custom hyperlink using the tel protocol within a SharePoint Framework (SPFx) web part to trigger the default device calling app (Teams).

The standard Quick Links web part in SharePoint often restricts custom HTML, making it difficult to embed direct calling protocols. Using an SPFx Modern Script web part bypasses this limitation, allowing you to use standard HTML anchor tags for phone numbers.

When a user clicks a tel link, the browser prompts the device's default calling application. You must test this in Microsoft Edge to confirm it correctly routes to Teams in your environment.

Test browser call routing

Open Microsoft Edge, type a sample phone number into a test HTML page, click it, and confirm whether Microsoft Teams launches automatically to handle the call.

Add an SPFx Script web part

Edit your modern SharePoint page and insert an SPFx Modern Script web part (or equivalent custom code web part) into the desired section.

Insert the HTML hyperlink

Enter the custom HTML code in the web part using the format: <a href="tel:1234567890">Call External Contact</a>, replacing the placeholder with the actual phone number.

Use a Custom SPFx Web Part with a Tel Protocol Link

Browser Prompts: Users may see a one-time browser prompt asking them to select an application (like Microsoft Teams) to handle 'tel:' links. Advise users to check the 'Always allow' box.

Solution 2

Add External Users to Microsoft Entra ID

Configure external phone numbers as contacts in Microsoft Entra ID so they can be recognized and easily added to Teams Speed Dial.

Free Microsoft Office alternative

Streamline Your Work with WPS Office

While Microsoft Teams and SharePoint handle your organization's communication and intranet needs, WPS Office provides a fast, lightweight, and fully integrated solution for all your document creation tasks. Experience a powerful office suite without the hefty subscription fees.

Fully compatible with Microsoft Word, Excel, and PowerPoint formats for seamless file sharing.Lightweight application that opens documents instantly and consumes minimal system resources.Familiar tabbed user interface, ensuring zero learning curve for seamless migration.All-in-one suite to view, edit, and collaborate on documents, spreadsheets, and PDFs effortlessly.

microsoft office alternative - wps office

Frequently Asked Questions

Why doesn't the SharePoint Quick Links web part accept tel links?

For security reasons, SharePoint's native Quick Links web part may sanitize or block custom HTML and specific URI schemes like 'tel:'. Using an SPFx web part or standard text hyperlink in a Text web part often resolves this.

How do I make Microsoft Edge always open Teams for phone numbers?

You can configure this by going to Windows Settings > Apps > Default apps, scrolling to 'Choose default apps by protocol', and setting the 'TEL' protocol default to Microsoft Teams.

Can I add someone to Teams Speed Dial without their email address?

Yes, you can manually type a valid phone number into the Teams Speed Dial search bar and select 'Add to speed dial', even if the contact lacks an email address or organizational account.

Office Quick Solutions