Merge pull request #263105 from AikoBB/aigerimb/acs-identity/bot-identifier-ga

[ACS][Common SDK] Microsoft Teams Application Identifier GA

Author: prmerger-automator[bot]

articles/communication-services/concepts/includes/identifiers/identifiers-android.md

@@ -71,17 +71,14 @@ PhoneNumberIdentifier phoneNumber = new PhoneNumberIdentifier("+112345556789");
 
 [PhoneNumberIdentifier](https://azure.github.io/azure-sdk-for-android/azure-communication-common/com/azure/android/communication/common/PhoneNumberIdentifier.html)
 
-### Microsoft bot
+### Microsoft Teams Application
 
-> [!NOTE]
-> The Microsoft Bot Identifier is currently in public preview. For more information about previews, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
-
-The `MicrosoftBotIdentifier` interface represents a Microsoft bot with its Microsoft Entra bot object ID. In the preview version the interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant, and the application should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
+The `MicrosoftTeamsAppIdentifier` interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant with its Microsoft Entra bot object ID. The Teams applications should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
 
 #### Basic usage
 
 ```java
-// Get the Microsoft bot's ID from Graph APIs
+// Get the Microsoft Teams App's ID from Graph APIs
 UserCollectionPage users = graphClient.users()
 	.buildRequest()
 	.filter(filterConditions)
@@ -92,16 +89,15 @@ UserCollectionPage users = graphClient.users()
 User bot = getBotFromUsers(users);
 
 // Create an identifier
-MicrosoftBotIdentifier botIdentifier = new MicrosoftBotIdentifier(bot.id);
+MicrosoftTeamsAppIdentifier teamsAppIdentifier = new MicrosoftTeamsAppIdentifier(bot.id);
 
 // If you're not operating in the public cloud, you must also pass the right Cloud type.
-// If you use Azure Bot Framework instead of Teams Voice applications, set property isResourceAccountConfigured to false.
-MicrosoftBotIdentifier gcchBotIdentifier = new MicrosoftBotIdentifier(bot.id, true, CommunicationCloudEnvironment.GCCH);
+MicrosoftTeamsAppIdentifier gcchTeamsAppIdentifier = new MicrosoftTeamsAppIdentifier(bot.id, CommunicationCloudEnvironment.GCCH);
 ```
 
 #### API reference
 
-[MicrosoftBotIdentifier](https://azure.github.io/azure-sdk-for-android/azure-communication-common/com/azure/android/communication/common/MicrosoftBotIdentifier.html)
+[MicrosoftTeamsAppIdentifier](https://azure.github.io/azure-sdk-for-android/azure-communication-common/com/azure/android/communication/common/MicrosoftTeamsAppIdentifier.html)
 
 ### Unknown
 

articles/communication-services/concepts/includes/identifiers/identifiers-ios.md

@@ -67,29 +67,25 @@ let phoneNumber = PhoneNumberIdentifier(phoneNumber: "+112345556789")
 
 [PhoneNumberIdentifier](https://azure.github.io/azure-sdk-for-ios/AzureCommunicationCommon/Classes/PhoneNumberIdentifier.html)
 
-### Microsoft bot
+### Microsoft Teams Application
 
-> [!NOTE]
-> The Microsoft Bot Identifier is currently in public preview. For more information about previews, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
-
-The `MicrosoftBotIdentifier` interface represents a Microsoft bot with its Microsoft Entra bot object ID. In the preview version the interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant, and the application should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
+The `MicrosoftTeamsAppIdentifier` interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant with its Microsoft Entra bot object ID. The Teams applications should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
 #### Basic usage
 
 ```swift
-// Get the Microsoft bot's ID from Graph APIs, assuming a helper method for the Graph API
+// Get the Microsoft Teams App's ID from Graph APIs, assuming a helper method for the Graph API
 let botId = await getBotIdFromGraph()
 
 // Create an identifier
-let botIdentifier = MicrosoftBotIdentifier(botId: botId)
+let teamsAppIdentifier = MicrosoftTeamsAppIdentifier(appId: botId)
 
 // If you're not operating in the public cloud, you must also pass the right Cloud type.
-// If you use Azure Bot Framework instead of Teams Voice applications, set property isResourceAccountConfigured to false.
-let gcchBotIdentifier = MicrosoftBotIdentifier(botId: botId, isResourceAccountConfigured: true, cloudEnvironment: CommunicationCloudEnvironment.Gcch)
+let gcchTeamsAppIdentifier = MicrosoftTeamsAppIdentifier(appId: botId, cloudEnvironment: CommunicationCloudEnvironment.Gcch)
 ```
 
 #### API reference
 
-[MicrosoftBotIdentifier](https://azure.github.io/azure-sdk-for-ios/AzureCommunicationCommon/Classes/MicrosoftBotIdentifier.html)
+[MicrosoftTeamsAppIdentifier](https://azure.github.io/azure-sdk-for-ios/AzureCommunicationCommon/Classes/MicrosoftTeamsAppIdentifier.html)
 
 ### Unknown
 

articles/communication-services/concepts/includes/identifiers/identifiers-java.md

@@ -71,17 +71,14 @@ var phoneNumber = new PhoneNumberIdentifier("+112345556789");
 
 [PhoneNumberIdentifier](/java/api/com.azure.communication.common.phonenumberidentifier)
 
-### Microsoft bot
+### Microsoft Teams Application
 
-> [!NOTE]
-> The Microsoft Bot Identifier is currently in public preview. For more information about previews, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
-
-The `MicrosoftBotIdentifier` interface represents a Microsoft bot with its Microsoft Entra bot object ID. In the preview version the interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant, and the application should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
+The `MicrosoftTeamsAppIdentifier` interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant with its Microsoft Entra bot object ID. The Teams applications should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
 
 #### Basic usage
 
 ```java
-// Get the Microsoft bot's ID from Graph APIs
+// Get the Microsoft Teams App's ID from Graph APIs
 var user = graphClient.users()
 	.buildRequest()
 	.filter(filterConditions)
@@ -92,16 +89,15 @@ var user = graphClient.users()
 var bot = getBotFromUsers(users);
 
 // Create an identifier
-var botIdentifier = new MicrosoftBotIdentifier(bot.id);
+var teamsAppIdentifier = new MicrosoftTeamsAppIdentifier(bot.id);
 
 // If you're not operating in the public cloud, you must also pass the right Cloud type.
-// If you use Azure Bot Framework instead of Teams Voice applications, set property isResourceAccountConfigured to false.
-var gcchBotIdentifier = new MicrosoftBotIdentifier(bot.id, true, CommunicationCloudEnvironment.GCCH);
+var gcchTeamsAppIdentifier = new MicrosoftTeamsAppIdentifier(bot.id, CommunicationCloudEnvironment.GCCH);
 ```
 
 #### API reference
 
-[MicrosoftBotIdentifier](/java/api/com.azure.communication.common.microsoftbotidentifier?view=azure-java-preview&preserve-view=true)
+[MicrosoftTeamsAppIdentifier](/java/api/com.azure.communication.common.microsoftteamsappidentifier)
 
 ### Unknown
 

articles/communication-services/concepts/includes/identifiers/identifiers-js.md

@@ -69,34 +69,30 @@ const phoneNumber = { phoneNumber: "+112345556789" };
 
 [PhoneNumberIdentifier](/javascript/api/@azure/communication-common/phonenumberidentifier)
 
-### Microsoft bot
+### Microsoft Teams Application
 
-> [!NOTE]
-> The Microsoft Bot Identifier is currently in public preview. For more information about previews, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
-
-The `MicrosoftTeamsAppIdentifier` interface represents a Microsoft bot with its Microsoft Entra bot object ID. In the preview version the interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant, and the application should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
+The `MicrosoftTeamsAppIdentifier` interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant with its Microsoft Entra bot object ID. The Teams applications should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
 
 #### Basic usage
 
 ```javascript
-// Get the Microsoft bot's ID from Graph APIs
+// Get the Microsoft Teams App's ID from Graph APIs
 const users = await graphClient.api("/users")
                     .filter(filterConditions)
                     .select('displayName,id')
                     .get();
 //Here we assume that you have a function getBotFromUsers that gets the bot from the returned response
 const bot = getBotFromUsers(users);
 // Create an identifier
-const botIdentifier = { teamsAppId: bot.id };
+const teamsAppIdentifier = { teamsAppId: bot.id };
 
 // If you're not operating in the public cloud, you must also pass the right Cloud type.
-// If you use Azure Bot Framework instead of Teams Voice applications, set property isResourceAccountConfigured to false.
-const gcchBotIdentifier = { teamsAppId: id, cloud: "gcch" };
+const gcchTeamsAppIdentifier = { teamsAppId: id, cloud: "gcch" };
 ```
 
 #### API reference
 
-[MicrosoftBotIdentifier](/javascript/api/@azure/communication-common/microsoftbotidentifier?view=azure-node-preview&preserve-view=true)
+[MicrosoftTeamsAppIdentifier](/javascript/api/@azure/communication-common/microsoftteamsappidentifier)
 
 ### Unknown
 

articles/communication-services/concepts/includes/identifiers/identifiers-net.md

@@ -71,17 +71,14 @@ var phoneNumber = new PhoneNumberIdentifier("+112345556789");
 
 [PhoneNumberIdentifier](/dotnet/api/azure.communication.phonenumberidentifier)
 
-### Microsoft bot
+### Microsoft Teams Application
 
-> [!NOTE]
-> The Microsoft Bot Identifier is currently in public preview. For more information about previews, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
-
-The `MicrosoftBotIdentifier` interface represents a Microsoft bot with its Microsoft Entra bot object ID. In the preview version the interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant, and the application should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
+The `MicrosoftTeamsAppIdentifier` interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant with its Microsoft Entra bot object ID. The Teams applications should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
 
 #### Basic usage
 
 ```csharp
-// Get the Microsoft bot's ID from Graph APIs
+// Get the Microsoft Teams App's ID from Graph APIs
 var users = await graphClient.Users.GetAsync((requestConfiguration) =>
 {
 	requestConfiguration.QueryParameters.Select = new string []{ "displayName","id" };
@@ -92,16 +89,15 @@ var users = await graphClient.Users.GetAsync((requestConfiguration) =>
 var bot = GetBotFromUsers(users);
 
 // Create an identifier
-var botIdentifier = new MicrosoftBotIdentifier(bot.Id);
+var teamsAppIdentifier = new MicrosoftTeamsAppIdentifier(bot.Id);
 
 // If you're not operating in the public cloud, you must also pass the right Cloud type.
-// If you use Azure Bot Framework instead of Teams Voice applications, set property isResourceAccountConfigured to false.
-var gcchBotIdentifier = new MicrosoftBotIdentifier(bot.Id, true, CommunicationCloudEnvironment.Gcch);
+var gcchTeamsAppIdentifier = new MicrosoftTeamsAppIdentifier(bot.Id, CommunicationCloudEnvironment.Gcch);
 ```
 
 #### API reference
 
-[MicrosoftBotIdentifier](/dotnet/api/azure.communication.microsoftbotidentifier?view=azure-dotnet-preview&preserve-view=true)
+[MicrosoftTeamsAppIdentifier](/dotnet/api/azure.communication.microsoftteamsappidentifier)
 
 ### Unknown
 

articles/communication-services/concepts/includes/identifiers/identifiers-python.md

@@ -69,37 +69,32 @@ phone_number = PhoneNumberIdentifier("+112345556789")
 
 [PhoneNumberIdentifier](/python/api/azure-communication-chat/azure.communication.chat.phonenumberidentifier)
 
-### Microsoft bot
+### Microsoft Teams Application
 
-> [!NOTE]
-> The Microsoft Bot Identifier is currently in public preview. For more information about previews, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
-
-The `MicrosoftBotIdentifier` interface represents a Microsoft bot with its Microsoft Entra bot object ID. In the preview version the interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant, and the application should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
+The `MicrosoftTeamsAppIdentifier` interface represents a bot of the Teams Voice applications such as Call Queue and Auto Attendant with its Microsoft Entra bot object ID. The Teams applications should be configured with a resource account. You can retrieve the Microsoft Entra bot object ID via the [Microsoft Graph REST API /users](/graph/api/user-list) endpoint from the `id` property in the response. For more information on how to work with Microsoft Graph, try the [Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer?request=users%2F%7Buser-mail%7D&method=GET&version=v1.0&GraphUrl=https://graph.microsoft.com) and look into the [Graph SDK](/graph/sdks/sdks-overview).
 
 #### Basic usage
 
 ```python
-# Get the Microsoft bot's ID from Graph APIs
+# Get the Microsoft Teams App's ID from Graph APIs
 users = graph_client.get("/users").json()
 
 # Here we assume that you have a function get_bot_from_users that gets the bot from the returned response
 bot = get_bot_from_users(users);
 
 # Create an identifier
-bot_identifier = MicrosoftBotIdentifier(bot_id=bot.get("id"))
+teams_app_identifier = MicrosoftTeamsAppIdentifier(app_id=bot.get("id"))
 
 # If you're not operating in the public cloud, you must also pass the right Cloud type.
-# If you use Azure Bot Framework instead of Teams Voice applications, set property isResourceAccountConfigured to false.
-gcch_bot_identifier = MicrosoftBotIdentifier(
-            bot_id=bot.get("id"),
-            is_resource_account_configured=True,
+gcch_teams_app_identifier = MicrosoftTeamsAppIdentifier(
+            app_id=bot.get("id"),
             cloud=CommunicationCloudEnvironment.GCCH
         )
 ```
 
 #### API reference
 
-[MicrosoftBotIdentifier](/python/api/azure-communication-identity/azure.communication.identity.microsoftbotidentifier?view=azure-python-preview&preserve-view=true)
+[MicrosoftTeamsAppIdentifier](/python/api/azure-communication-identity/azure.communication.identity.microsoftteamsappidentifier)
 
 ### Unknown