Added 3 new articles, updated graphics

Author: vac0224

articles/communication-services/concepts/interop/tpe/media/teams-phone-extensibility-teams-operator-connect.png

@@ -0,0 +1,119 @@
+---
+title: Microsoft Teams Phone client capabilities in Calling client and Call Automation SDK
+titleSuffix: An Azure Communication Services article
+description: Conceptual documentation describing which capabilities Azure Communication Services Calling client and Call Automation SDKs support for Teams users in Teams Phone calls.
+author: jacadd
+manager: chpalm
+services: azure-communication-services
+ms.author: jamescadd
+ms.date: 05/20/2025
+ms.topic: conceptual
+ms.custom: public_preview
+ms.service: azure-communication-services
+---
+
+# Microsoft Teams Phone client capabilities in Calling client and Call Automation SDK
+
+This article describes which Microsoft Teams Phone client capabilities Azure Communication Services Calling client and Call Automation SDKs support for Teams Phone extensibility.
+
+[!INCLUDE [public-preview-notice.md](../../../includes/public-preview-include-document.md)]
+
+## Prerequisites
+
+- Teams users must have a Teams Phone license.
+- Teams users must be Enterprise Voice enabled.
+- Agents in Azure Communication Services applications support the capabilities in the following table. Teams users aren't supported.
+
+## Teams Phone client capabilities
+
+The following list of capabilities is supported for scenarios where at least one phone number participates in 1:1 or group calls:
+- PP: Private Preview
+- PuP: Public Preview
+- GA: General Availability
+
+| **Group of features** | **Capability (from TPE perspective)**  | **Release** | **Client Calling SDK** | **Call Automation**  |
+| --- | --- | --- | --- | --- |
+| Connectivity | Teams calling plans | PP | ✔️  | ✔️  |
+| | Teams direct routings | PP | ✔️  | ✔️  |
+| | Teams operator connect  | PP | ✔️  | ✔️  |
+| Outbound Calling | Place outbound calls using Teams service phone number | PP | ✔️  | ✔️  |
+| | Receive early media when placing outbound calls  | PP | ✔️  | N/A |
+| Inbound calling  | Support incoming PSTN call to Teams service phone number answered by call automation app and routed to agent | PP | ✔️  | ✔️  |
+| | Reject inbound call to Teams service phone number  | PP | ✔️  | ✔️  |
+| Mid-call actions (signaling)  | Leave a connected call (without terminating the call)  | PP | ✔️  | ✔️  |
+| | Terminate the entire call (ending the call for all participants)  | PP | ✔️  | ✔️  |
+| | Add an agent to an ongoing call | PP | ✔️  | ✔️  |
+| | Add external phone number from an ongoing call  | PP | ✔️  | ✔️  |
+| | Cancel an already initiated add participant request, as long as the the target agent / phone number hasn't accepted the call invite | PP | ❌  | ✔️  |
+| | Remove a call participant from ongoing call | PP | ✔️  | ✔️  |
+| | Dial out to same phone number multiple times in a call | N/A | ❌  | ❌  |
+| | Transfer the end user from ongoing 1:1 call to another agent or external phone number  | PP | ✔️  | ✔️  |
+| | Transfer the end user from ongoing group call to another agent or external phone number  | PP | ❌ | ✔️  |
+| | Retrieve call properties (`GetCall`)  | PP | N/A  | ✔️  |
+| | Send custom context as part of call invite  (AddParticipant and Transfer)  | PP | ❌  | ✔️  |
+| | Receive custom context as part of call invite (AddParticipant and Transfer)  | PP | ✔️  | ✔️  |
+| | Send and receive SIP headers (UUI and X-header) as part of call invite to and from SIP endpoints  | PP | N/A | ✔️  |
+| Mid-call actions (media)  | Developer can play audio (from audio file or text/SSML) to target participant (end user or an agent) | PP | N/A | ✔️  |
+| | Developer can play audio (from audio file or text/SSML) to all call participants  | PP | N/A | ✔️  |
+| | Developer can recognize DTMF input from a particular call participant (end user or agent) | PP | N/A | ✔️  |
+| | Developer can recognize speech (phrases or free form using speech-to-text feature) input from a particular participant (end user or agent)  | PP | N/A | ✔️  |
+| | Send DTMF tones, manually, to a PSTN participant in a 1:1 call to navigate the calling party’s IVR (no DTMF buffering) | PP | ✔️  | ✔️  |
+| | Send DTMF tones, manually, to a specific PSTN participant in a group call to navigate the calling party’s IVR (no DTMF buffering) | PP | ❌  | ✔️  |
+| | DTMF buffering support | N/A | ❌  | ❌  |
+| | Cancel all Media Operations | PP | ❌  | ✔️  |
+| | Start continuous DTMF Recognition from end user  | PP | N/A  | ✔️  |
+| | Stream real-time transcript of the call to a WebSocket  | PP | N/A | ✔️  |
+| | Mute other VoIP participants (such as other agents)  | PP | ✔️  | ✔️  |
+| | Mute other PSTN users  | N/A | ❌  | ❌  |
+| | Place call on hold and take call off hold (1:1 call only)   | PP | ✔️  | ❌ |
+| | Play music to the participant put on hold  | N/A | ❌  | ✔️ |
+| | Developer/agent can stream real-time audio out of the call to a WebSocket | PP | N/A | ✔️  |
+| Mid call media controls and device management | Existing Client Calling capabilities conform to [Calling SDK Features](https://learn.microsoft.com/en-us/azure/communication-services/concepts/voice-video-calling/calling-sdk-features) | N/A | ✔️ | ❌ |
+| Accessibility  | Agent can turn on Teams closed captions  | N/A | ❌  | N/A |
+| Emergency calling  | Agent can make an emergency call | PP | ✔️  | N/A |
+| | Honor Security desk policy for emergency calls  | PP | ✔️  | N/A |
+| | Provide a static registered emergency address for Teams calling plans, Operator Connect, and Direct Routing for emergency calls | PP | ✔️  | N/A |
+| Roster management  | List call participants  | PP | ✔️  | ✔️  |
+| | Adding Teams user honors Teams federation & external access configuration (tenant to tenant federation)  | N/A | ❌ | ❌ |
+| Recording  | Teams convenience and compliance recording | N/A | ❌  | ❌  |
+| | Azure Communication Services Recording | PP | ✔️  | ✔️  |
+| Conversational AI | Developers can use the Recognize API to build conversational AI experiences in their IVRs or conversational AI bots. Recognize API uses Azure AI speech models for NLU  | PP | N/A | ✔️  |
+| | Developers can use their custom AI models when using the Recognize API so that industry/organization specific speech recognition can be used for conversational AI experiences. Recognize API would use custom AI speech models for NLU  | PP | N/A | ✔️  |
+| | Developers can use Outbound Audio Streaming to connect their IVRs for conversational AI experiences  | PP | N/A | ✔️  |
+| | Developers can use Play API to play audio prompts for conversational AI experiences | PP | N/A | ✔️  |
+| Advanced call routing | Does start a call and add user operations honor forwarding rules | N/A | ❌  | ❌  |
+| | Read and configure call forwarding rules | N/A | ❌  | ❌  |
+| | Does start a call and add user operations honor simultaneous ringing | N/A | ❌  | ❌  |
+| | Place a phone call honors location-based routing  | N/A | ❌  | ❌  |
+| | Does start a call and add user operations honor shared line configuration | N/A | ❌  | ❌  |
+| | Start a phone call honoring dial plan policy  | PP | ✔️  | ✔️  |
+| | Park a call  | N/A | ❌  | ❌  |
+| | Be parked  | N/A | ❌  | ❌  |
+| DevOps | Developers can access API operational metrics under Azure Metrics  | PuP | ✔️  | ✔️  |
+| | Developer can access call diagnostics under [Call Diagnostics Center](https://learn.microsoft.com/en-us/azure/communication-services/concepts/voice-video-calling/call-diagnostics) | PuP | ✔️  | ✔️  |
+| | Developers can subscribe to get API and call logs under [Azure Monitor](../../analytics/logs/voice-and-video-logs.md) | PuP | ✔️  | ✔️  |
+| | Developers can get insights about their resource usage under [Azure Communication Services Insights](../../analytics/logs/voice-and-video-logs.md)  | PuP | ✔️  | ✔️  |
+| | Developers can subscribe to receive call state and roster changes events via Event Grid: [Azure Communication Services Voice and video calling events](/azure/communication-services/quickstarts/voice-video-calling/handle-calling-events) | N/A | ❌  | ❌  |
+| Teams caller ID policies  | Replace the caller ID with Replace the caller ID with this service number (Outbound PSTN call from the Teams Resource account honors its assigned Caller ID policy in the Teams Admin Center) | GA  | ✔️  | N/A |
+| | Block incoming caller ID  | GA  | ✔️  | ✔️  |
+| | Override the caller ID policy  | GA  | ✔️  | ✔️  |
+| | Calling Party Name  | GA  | ✔️  | ✔️  |
+| | Replace the caller ID with Direct Routing or Operator Connect service number  | GA  | ✔️  | ✔️  |
+| | Replace the caller ID with Teams Phone service number | GA  | ✔️  | ✔️  |
+| Dial Plan  | Outbound PSTN call from the Teams Resource account honors its assigned Dial plan policy in the Teams Admin Center  | PP | N/A  | ✔️  |
+| | Outbound emergency call from the Teams user account honors its assigned dial plan policy in the Teams Admin center | PP | ✔️  | N/A |
+| Call restrictions  | Call restriction policies assigned to the Teams Resource account are honored | PP | ✔️  | ✔️  |
+
+- \* Participants joining via phone number can't see video content. So actions involving video don't affect them but can apply when VoIP participants join.
+
+## Next Steps
+
+- [Microsoft Teams Phone overview](https://learn.microsoft.com/en-us/microsoftteams/what-is-phone-system-in-office-365)
+- [Set up Microsoft Teams Phone in your organization](https://learn.microsoft.com/en-us/microsoftteams/setting-up-your-phone-system)
+- [Access a user's Teams Phone separate from their Teams client](https://github.com/Azure/communication-preview/blob/master/Teams%20Phone%20Extensibility/teams-phone-extensibility-access-teams-phone.md)
+- [Answer Teams Phone calls from Call Automation](https://github.com/Azure/communication-preview/blob/master/Teams%20Phone%20Extensibility/teams-phone-extensibility-answer-teams-calls.md)
+
+## Related articles
+
+- [Teams Phone extensibility overview](./teams-phone-overview.md)
+- [Teams Phone extensibility FAQ](./teams-phone-extensibility-faq.md)

articles/communication-services/concepts/interop/tpe/media/teams-phone-extensibility-voice-solution-with-direct-routing.png

@@ -0,0 +1,72 @@
+---
+title: Cost and Connectivity Options for Teams Phone extensibility 
+titleSuffix: An Azure Communication Services article
+description: This article describes available PSTN connectivity options and costs for Teams Phone extensibility.
+author: henikaraa
+ms.service: azure-communication-services
+ms.subservice: pstn
+ms.date: 05/20/2025
+ms.custom: public_preview
+services: azure-communication-services
+---
+
+# Cost and connectivity options for Teams Phone extensibility
+
+[!INCLUDE [public-preview-notice.md](../../../includes/public-preview-include-document.md)]
+
+Effective communication is essential for success in today's fast-paced business environment. Choosing the right public switched telephone network (PSTN) connectivity option for your organization's communication needs can significantly improve efficiency, reduce cost, and raise overall performance.
+
+As organizations increasingly adopt Microsoft Teams for their collaboration and communication needs, understanding the various PSTN connectivity options available becomes crucial. This article explores your options for Teams Phone extensibility and provides guidance on selecting the best fit for your specific requirements. Options include Calling Plans, Operator Connect, and Direct Routing.
+
+This article also explores the business model for Teams Phone extensibility. We offer insights into cost estimation and the associated services, helping you make informed decisions to optimize your communication infrastructure.
+
+## PSTN connectivity options for Teams Phone extensibility
+
+There are three primary options available:
+
+1. **Calling Plans** are an all-in-the-cloud solution in which Microsoft acts as your PSTN carrier. Calling Plans are the simplest option, ideal for organizations that doesn't need to retain their current PSTN carrier. With Calling Plans, you get Teams Phone with added Domestic or International Calling Plans for your solution to reach phone numbers around the world.
+
+   This option doesn't require any on-premises deployment or maintenance. For more information, see [Microsoft Teams Calling Plans](/microsoftteams/calling-plans-for-office-365).
+
+   :::image type="content" source="./media/teams-phone-extensibility-teams-calling-plans.png" alt-text="Diagram shows the simplest solution Teams Phone system with Calling Plan using Microsoft as a public switched telephone network (PSTN) carrier."  lightbox="./media/teams-phone-extensibility-teams-calling-plans.png":::
+
+2. **Operator Connect** enables you to bring your existing PSTN carrier into the Microsoft Teams environment. If your carrier participates in the Microsoft Operator Connect program, they can manage PSTN calling and Session Border Controllers (SBCs) for you.
+
+   Operator Connect provides a fully managed service with no hardware footprint. This option is a great choice for organizations that want to maintain their existing PSTN infrastructure while using Teams. For more information, see [Plan for Operator Connect](/microsoftteams/operator-connect-plan).
+
+   :::image type="content" source="./media/teams-phone-extensibility-teams-operator-connect.png" alt-text="Diagram shows Teams Operator Connect using a public switched telephone network (PSTN) and Session Border Controller as a Service (SBCaaS) through Teams Phone / Teams Admin Center to connect your operators."  lightbox="./media/teams-phone-extensibility-teams-operator-connect.png":::
+
+3. **Direct Routing** enables you to use your own PSTN carrier by connecting your SBCs to Teams Phone. Direct Routing offers the most flexibility, enabling you to design a solution that fits complex environments or manage a multi-step migration.
+
+   Direct Routing is suitable for organizations that need to retain their current PSTN carrier and have specific requirements for interoperability with third-party private branch exchanges (PBXs), analog devices, and other telephony equipment. For more information, see [Plan Direct Routing](/microsoftteams/direct-routing-plan).
+
+   :::image type="content" source="./media/teams-phone-extensibility-voice-solution-with-direct-routing.png" alt-text="Diagram shows Teams Direct Routing. It features Teams users on Microsoft 365 through on premises session border controller (SBC), phone number ranges, and third party private branch exchange (PBX) / telephony equipment connecting to a telephony trunk and public switched telephone network (PSTN)."  lightbox="./media/teams-phone-extensibility-voice-solution-with-direct-routing.png":::
+
+### How to choose a connectivity option
+
+Choosing the best PSTN connectivity solution for Teams Phone extensibility depends on several factors. You need to consider the availability of services in your region, your existing infrastructure, and your specific needs.
+
+- **Availability**: Find out if the PSTN connectivity option is available in your country. For example, Microsoft Calling Plans are available in specific regions, and Operator Connect requires your existing carrier to participate in the program. Make sure that the option you choose is supported in your location.
+
+   Teams provides the Calling Plans option in multiple countries. For more information and the up-to-date list, see [Country/region availability for Calling Plans](/microsoftteams/calling-plan-overview).
+
+   Microsoft Teams also offers the option to use integration with 105 operators worldwide using the Operator Connect option. For more information and the current list, see [Modern Work for Partners - Operator Directory](https://cloudpartners.transform.microsoft.com/partner-gtm/operators/directory).
+
+   For the most flexible option, use Teams Direct Routing. You can connect your SBC to almost any telephony trunk or interconnect with third party PSTN equipment. This flexibility enables you to deploy your solution in any region or country. Remember that you need to configure the solution correctly for optimal performance and compliance with local regulations. For more information, see [Configure Direct Routing for Microsoft Teams](/microsoftteams/direct-routing-configure).
+
+- **Existing Infrastructure**: Consider your current telephony setup. If you have an existing PSTN carrier and infrastructure that you want to retain, either Direct Routing or Operator Connect might be the best option. If you prefer a fully managed, cloud-based solution with minimal on-premises requirements, Calling Plans could be the ideal choice.
+
+- **Specific Needs**: Evaluate your organization's specific needs. For example, do you need international calling, how complex is your telephony environment, and how much control do you require over your PSTN connectivity. Direct Routing offers the most flexibility and control, while Calling Plans provide simplicity and ease of use.
+
+## Estimate Teams Phone extensibility cost
+
+The Teams Phone Extensibility business model for independent software vendors (ISVs) includes charging contact center as a service (CCaaS) vendors for using Azure Communication Services SDKs. This model includes Calling SDK and VoIP consumption, which require charges for each leg between the call automation bot and the CCaaS agent.
+
+This solution also includes Audio Insights with access to mixed/unmixed audio streams or direct transcriptions. Using transcription incurs an [Azure AI Speech cost](/pricing/details/cognitive-services/speech-services/) for the selected Azure resource and Call Recording with pay-as-you-go for mixed/unmixed AV recordings. You can review current pricing for VoIP, transcription, and recording at [Azure Communication Services pricing](/pricing/details/communication-services/).
+
+End users can take advantage of their Teams Calling plans or any of the connectivity options for PSTN usage with inbound / outbound and any associated extra usage. Users must enable the required Teams licenses including Teams Phone License for any agent involved in the call including SMEs, and Resource Account license for the provisioned Teams resource account. For more information, see [Microsoft Teams Phone - Cloud Phone System](/microsoft-teams/microsoft-teams-phone).
+
+## Related articles
+
+- [Teams Phone extensibility overview](./teams-phone-overview.md)
+- [Teams Phone extensibility FAQ](./teams-phone-extensibility-faq.md)