Merge pull request #294129 from charithgunaratna/charithg/obo-docs

Adding CTE SharedLineAppearance how-to

Author: v-shils

articles/communication-services/concepts/interop/teams-user/teams-shared-line-appearance.md

@@ -54,4 +54,8 @@ The following Azure Communication Services and Graph platforms currently support
 > [!NOTE] 
 > Calling SDK for iOS, Android, and Windows do not currently support shared line appearance.
 
-For more information on the capabilities available during a shared line appearance call, see [Calling capabilities for Teams users](../teams-user-calling.md).
+For more information on the capabilities available during a shared line appearance call, see [Calling capabilities for Teams users](../teams-user-calling.md).
+
+## Next steps
+
+- [Get started with Teams Shared Line Appearance in Azure Communication Services](../../../how-tos/cte-calling-sdk/shared-line-appearance.md)

articles/communication-services/how-tos/cte-calling-sdk/includes/shared-line-appearance/shared-line-appearance-web.md

@@ -0,0 +1,37 @@
+---
+author: charithgunaratna
+ms.service: azure-communication-services
+ms.topic: include
+ms.date: 02/04/2025
+ms.author: charithg
+---
+
+> [!NOTE]
+> This API is provided as a preview for developers and might change based on feedback that we receive. Don't use this API in a production environment. To use this API, use the beta release of the Azure Communication Services Calling Web SDK (1.31.1-beta.1 or higher).
+
+[!INCLUDE [Install SDK](../install-sdk/install-sdk-web.md)]
+
+## Place a call on behalf of a Microsoft Teams user
+
+Before placing a call behalf of a delegator, make sure delegate placing the call has `make calls` permission through [delegator call settings in Microsoft Teams](https://support.microsoft.com/office/share-a-phone-line-with-a-delegate-in-microsoft-teams-16307929-a51f-43fc-8323-3b1bf115e5a8)
+
+To place a call on behalf of a Microsoft Teams user, specify `OnBehalfOfOptions` during start call. Replace `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` with the userId of the delegator and `yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy` with the userId of the callee.
+
+```js
+const onBehalfOfOptions = { userId: { microsoftTeamsUserId: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } }
+const teamsCallOptions = { onBehalfOfOptions: onBehalfOfOptions };
+const call = teamsCallAgent.startCall([{ microsoftTeamsUserId: "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy" }], teamsCallOptions);
+```
+
+To place a call to a PSTN user on behalf of a Microsoft Teams user, use `PhoneNumberIdentifier` for call participant.
+
+```js
+const call = teamsCallAgent.startCall([{ phoneNumber: "+1xxxxxxxxxx" }], teamsCallOptions);
+```
+
+## Receive a call on behalf of a Microsoft Teams user
+
+To receive calls on behalf of a delegator,
+
+- Update delegate permission to enable "receive calls" through [delegator call settings in Microsoft Teams](https://support.microsoft.com/office/share-a-phone-line-with-a-delegate-in-microsoft-teams-16307929-a51f-43fc-8323-3b1bf115e5a8)
+- Set up simultaneous ring for delegates through [delegator call settings in Microsoft Teams](https://support.microsoft.com/office/call-forwarding-call-groups-and-simultaneous-ring-in-microsoft-teams-a88da9e8-1343-4d3c-9bda-4b9615e4183e)

articles/communication-services/how-tos/cte-calling-sdk/shared-line-appearance.md

@@ -0,0 +1,40 @@
+---
+title: Tutorial - Teams Shared Line Appearance
+description: Use Microsoft Teams Shared Line Appearance with Azure Communication Services Calling SDK.
+author: charithgunaratna
+ms.author: charithg
+ms.service: azure-communication-services
+ms.topic: how-to #Required; leave this attribute/value as-is
+ms.date: 02/04/2025
+---
+
+# Teams Shared Line Appearance
+
+This article describes how to implement Microsoft Teams Shared Line Appearance with Azure Communication Services. Shared line appearance lets a user choose a delegate to make or handle calls on their behalf. This feature is helpful if a user has an administrative assistant who regularly handles the user's calls. In the context of shared line appearance, a manager is a Teams user who authorizes a delegate to make or receive calls on their behalf. A delegate is a Microsoft 365 user who can make or receive calls on behalf of the delegator. You can find additional information about shared line appearance in [Teams documentation](/microsoftteams/shared-line-appearance).
+
+## Prerequisites
+
+- An Azure account with an active subscription. See [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
+- A deployed Communication Services resource. See [Create a Communication Services resource](../../quickstarts/create-communication-resource.md).
+- A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
+- Licensing requirements for delegator and delegates. See [Teams Phone license](/microsoftteams/shared-line-appearance#license-required).
+- Enable delegation and shared line appearance. See [Enable delegation](/microsoftteams/shared-line-appearance#enable-delegation-and-shared-line-appearance)
+- Assign delegates using [Microsoft Teams Client](https://support.microsoft.com/office/share-a-phone-line-with-a-delegate-in-microsoft-teams-16307929-a51f-43fc-8323-3b1bf115e5a8) or [Teams PowerShell](/microsoftteams/shared-line-appearance#use-powershell).
+- Learn more about [Team Shared Line Appearance in Azure Communication Services](../../concepts/interop/teams-user/teams-shared-line-appearance.md)
+- Optional: Complete the quickstart to add voice calling to Microsoft Teams user. See [Quickstart: Add voice calling to Microsoft Teams user](../../quickstarts/voice-video-calling/get-started-call-to-teams-user.md).
+
+## Support
+
+### SDKs
+
+The following table shows support for shared line appearance feature in individual Azure Communication Services SDKs.
+
+| Support status | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
+|----------------|-----|--------|--------|--------|----------|--------|---------|
+| Is Supported   | ✔️  |        |        |        |          |        |         |
+
+[!INCLUDE [Shared line appearance Client-side JavaScript](./includes/shared-line-appearance/shared-line-appearance-web.md)]
+
+## Next steps
+
+- [Learn how to manage calls](./manage-calls.md)

articles/communication-services/toc.yml

@@ -454,6 +454,8 @@ items:
         href: how-tos/calling-sdk/capabilities.md
       - name: View PowerPoint Live
         href: how-tos/calling-sdk/powerpoint-live.md
+      - name: Shared Line appearance
+        href: how-tos/cte-calling-sdk/shared-line-appearance.md
     - name: Call flows and networking
       items:
       - name: Network recommendations