added bot identifier for android

Author: AikoBB

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

@@ -26,7 +26,7 @@ CommunicationUserIdentifier newUser = identityClient.CreateUser();
 
 // and then send newUser.getId() down to your client application
 // where you can again create an identifier for the user
-var sameUser = new CommunicationUserIdentifier(newUserId);
+CommunicationUserIdentifier sameUser = new CommunicationUserIdentifier(newUserId);
 ```
 
 #### API reference
@@ -41,15 +41,15 @@ The `MicrosoftTeamsUserIdentifier` represents a Teams user with its Azure AD use
 
 ```java
 // get the Teams user's ID from Graph APIs if only the email is known
-var user = await graphClient.users("[email protected]")
+User user = graphClient.users("[email protected]")
     .buildRequest()
     .get();
 
 // create an identifier
-var teamsUser = new MicrosoftTeamsUserIdentifier(user.id);
+MicrosoftTeamsUserIdentifier teamsUser = new MicrosoftTeamsUserIdentifier(user.id);
 
 // if you're not operating in the public cloud, you must also set the right Cloud type.
-var gcchTeamsUser = new MicrosoftTeamsUserIdentifier(userId).setCloudEnvironment(CommunicationCloudEnvironment.GCCH);
+MicrosoftTeamsUserIdentifier gcchTeamsUser = new MicrosoftTeamsUserIdentifier(userId).setCloudEnvironment(CommunicationCloudEnvironment.GCCH);
 ```
 
 #### API reference
@@ -64,13 +64,46 @@ The `PhoneNumberIdentifier` represents a phone number. The service assumes that
 
 ```java
 // create an identifier
-var phoneNumber = new PhoneNumberIdentifier("+112345556789");
+PhoneNumberIdentifier phoneNumber = new PhoneNumberIdentifier("+112345556789");
 ```
 
 #### API reference
 
 [PhoneNumberIdentifier](https://azure.github.io/azure-sdk-for-android/azure-communication-common/com/azure/android/communication/common/PhoneNumberIdentifier.html)
 
+### Microsoft Bot Identifier
+
+> [!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 Azure AD 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 Azure AD 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
+UserCollectionPage users = graphClient.users()
+	.buildRequest()
+	.filter(filterConditions)
+	.select("displayName,id")
+	.get();
+
+//here we assume that you have a function getBotFromUsers that gets the bot from the returned response
+User bot = getBotFromUsers(users);
+
+// create an identifier
+MicrosoftBotIdentifier botIdentifier = new MicrosoftBotIdentifier(bot.id);
+
+// if you're not operating in the public cloud, you must also pass the right Cloud type.
+// You can also specify tenantized bots by setting the isResourceAccountConfigured flag to true.
+// The flag is false if the bot is global and no resource account is configured.
+MicrosoftBotIdentifier gcchBotIdentifier = new MicrosoftBotIdentifier(bot.id, true, CommunicationCloudEnvironment.GCCH);
+```
+
+#### API reference
+
+[MicrosoftBotIdentifier](/java/api/com.azure.communication.common.microsoftbotidentifier?view=azure-java-preview)
+
 ### Unknown
 
 The `UnknownIdentifier` exists for future-proofing and you might encounter it when you are on an old version of the SDK and a new identifier type has been introduced recently. Any unknown identifier from the service will be deserialized to the `UnknownIdentifier` in the SDK.
@@ -79,7 +112,7 @@ The `UnknownIdentifier` exists for future-proofing and you might encounter it wh
 
 ```java
 // create an identifier
-var unknown = new UnknownIdentifier("a raw id that originated in the service");
+UnknownIdentifier unknown = new UnknownIdentifier("a raw id that originated in the service");
 ```
 
 #### API reference
@@ -100,6 +133,9 @@ else if (communicationIdentifier instanceof MicrosoftTeamsUserIdentifier) {
 else if (communicationIdentifier instanceof PhoneNumberIdentifier) {
     Log.i(tag, "Phone number: " + ((PhoneNumberIdentifier)communicationIdentifier).getPhoneNumber());
 }
+else if (communicationIdentifier instanceof MicrosoftBotIdentifier) {
+    Log.i(tag, "Microsoft bot: " + ((MicrosoftBotIdentifier)communicationIdentifier).getBotId());
+}
 else if (communicationIdentifier instanceof UnknownIdentifier) {
     Log.i(tag, "Unkown user: " + ((UnknownIdentifier)communicationIdentifier).getId());
 }