update java doc for text, media and template messages

Author: arifibrahim4

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/common-setting-java.md

@@ -11,7 +11,15 @@ ms.custom: include file
 ms.author: shamkh
 ms.custom: devx-track-extended-java, devx-track-js, devx-track-python
 zone_pivot_groups: acs-js-csharp-java-python
----  
+---
+
+### Start sending messages between a business and a WhatsApp user
+
+Conversations between a WhatsApp Business Account and a WhatsApp user can be initiated in one of two ways:
+- The business sends a template message to the WhatsApp user.
+- The WhatsApp user sends any message to the business number.
+
+Regardless of how the conversation was started, **a business can only send template messages until the user sends a message to the business.** Only after the user sends a message to the business, the business is allowed to send text or media messages to the user during the active conversation. Once the 24 hour conversation window expires, the conversation must be reinitiated. To learn more about conversations, see the definition at [WhatsApp Business Platform](https://developers.facebook.com/docs/whatsapp/pricing#conversations).  
 
 ### Authenticate the client
 
@@ -137,60 +145,3 @@ Example:
 List<String> recipientList = new ArrayList<>();
 recipientList.add("+14255550199");
 ```
-
-### Start sending messages between a business and a WhatsApp user
-
-Conversations between a WhatsApp Business Account and a WhatsApp user can be initiated in one of two ways:
-- The business sends a template message to the WhatsApp user.
-- The WhatsApp user sends any message to the business number.
-
-Regardless of how the conversation was started, **a business can only send template messages until the user sends a message to the business.** Only after the user sends a message to the business, the business is allowed to send text or media messages to the user during the active conversation. Once the 24 hour conversation window expires, the conversation must be reinitiated. To learn more about conversations, see the definition at [WhatsApp Business Platform](https://developers.facebook.com/docs/whatsapp/pricing#conversations).
-
-#### (Option 1) Initiate conversation from business - Send a template message
-Initiate a conversation by sending a template message.
-
-First, create a MessageTemplate using the values for a template. 
-> [!NOTE]
-> To check which templates you have available, see the instructions at [List templates](../../../../concepts/advanced-messaging/whatsapp/template-messages.md#list-templates).
-> If you don't have a template to use, proceed to [Option 2](#option-2-initiate-conversation-from-user).
-
-Here's MessageTemplate creation using a default template, `sample_template`.   
-If `sample_template` isn't available to you, skip to [Option 2](#option-2-initiate-conversation-from-user). For advanced users, see the page [Templates](../../../../concepts/advanced-messaging/whatsapp/template-messages.md) to understand how to send a different template with Option 1.
-
-Messages SDK allows Contoso to send templated WhatsApp messages to WhatsApp users. To send template messages below details are required:
-- [WhatsApp Channel ID](#set-channel-registration-id)
-- [Recipient Phone Number in E16 format](#set-recipient-list)
-- Template details
-    - Name like 'sample_template'
-    - Language like 'en_us'
-    - Parameters if any
-    
-```java
-// Assemble the template content
-String templateName = "sample_template";
-String templateLanguage = "en_us";
-MessageTemplate messageTemplate = new MessageTemplate(templateName, templateLanguage);
-
-// Assemble template message
-TemplateNotificationContent templateContent = new TemplateNotificationContent(channelRegistrationId, recipientList, messageTemplate);
-
-// Send template message
-SendMessageResult templateMessageResult = notificationClient.send(templateContent);
-
-// Process result
-for (MessageReceipt messageReceipt : templateMessageResult.getReceipts()) {
-    System.out.println("Message sent to:" + messageReceipt.getTo() + " and message id:" + messageReceipt.getMessageId());
-}
-```
-
-Now, the user needs to respond to the template message. From the WhatsApp user account, reply to the template message received from the WhatsApp Business Account. The content of the message is irrelevant for this scenario.
-
-> [!IMPORTANT]
-> The recipient must respond to the template message to initiate the conversation before text or media message can be delivered to the recipient.
-
-#### (Option 2) Initiate conversation from user
-
-The other option to initiate a conversation between a WhatsApp Business Account and a WhatsApp user is to have the user initiate the conversation.
-To do so, from your personal WhatsApp account, send a message to your business number (Sender ID).
-
-:::image type="content" source="../media/get-started/user-initiated-conversation.png" lightbox="" alt-text="A WhatsApp conversation viewed on the web showing a user message sent to the WhatsApp Business Account number.":::

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-get-started-java.md

@@ -24,45 +24,20 @@ To set up an environment for sending messages, complete the steps in the followi
 
 [!INCLUDE [Setting up for Java Application](../java-application-setup.md)]
 
-## Object model
-
-The following classes and interfaces handle some of the major features of the Azure Communication Services Advance Messaging SDK for Java.
-
-| Class Name | Description |
-| --- |--- |
-| `NotificationMessagesClientBuilder`           | Creates the Notification Messages Client. You provide it with an endpoint and a credential. |
-| `NotificationMessagesClient`                  | Needed to send WhatsApp messages and download media files.                               |
-| `NotificationMessagesAsyncClient`             | Needed to send WhatsApp messages and download media files asynchronously.                |
-| `SendMessageResult`                           | Contains the result from the Advance Messaging service for send notification message.       |
-| `MessageTemplateClientBuilder`                | Creates the Message Template Client. You provide it with an endpoint and a credential.      |
-| `MessageTemplateClient`                       | Needed to get the list of WhatsApp templates.                                            |
-| `MessageTemplateAsyncClient`                  | Needed to get the list of WhatsApp templates asynchronously.  |
-
-> [!NOTE]
-> For more information, see the Azure SDK for Java reference [com.azure.communication.messages](/java/api/com.azure.communication.messages)
-
-## Common configuration
-
-Complete these steps to add required code snippets to the `messages-quickstart.py` python program.
+## Code examples
 
+Follow these steps to add required code snippets to the main function of your `App.java` file.
+- [Start sending messages between a business and a WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
 - [Authenticate the client](#authenticate-the-client).
 - [Set channel registration ID](#set-channel-registration-id).
 - [Set recipient list](#set-recipient-list).
-- [Start sending messages between a business and a WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
-
-[!INCLUDE [Common setting for using Advanced Messages SDK](../common-setting-java.md)]
-
-## Code examples
-
-Follow these steps to add required code snippets to the main function of your `App.java` file.
 - [Send a text message to a WhatsApp user](#send-a-text-message-to-a-whatsapp-user)
 - [Send an image media message to a WhatsApp user](#send-an-image-media-message-to-a-whatsapp-user)
 - [Send a document media message to a WhatsApp user](#send-a-document-media-message-to-a-whatsapp-user)
 - [Send an audio media message to a WhatsApp user](#send-an-audio-media-message-to-a-whatsapp-user)
 - [Send a video media message to a WhatsApp user](#send-a-video-media-message-to-a-whatsapp-user)
 
-> [!IMPORTANT]
-> To send a text message to a WhatsApp user, the WhatsApp user must first send a message to the WhatsApp Business Account. For more information, see [Start sending messages between business and WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+[!INCLUDE [Common setting for using Advanced Messages SDK](../common-setting-java.md)]
 
 ### Send a text message to a WhatsApp user
 
@@ -73,6 +48,9 @@ Messages SDK allows Contoso to send text WhatsApp messages, which initiated What
 
 In this example, we reply to the WhatsApp user with the text `"Thanks for your feedback.\n From Notification Messaging SDK."`
 
+> [!IMPORTANT]
+> To send a text message to a WhatsApp user, the WhatsApp user must first send a message to the WhatsApp Business Account. For more information, see [Start sending messages between business and WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+
 Assemble and send the text message:
 
 ```java
@@ -98,6 +76,9 @@ The Messages SDK enables Contoso to send media (image, video, audio, or document
 > [!IMPORTANT]
 > As of SDK version 1.1.0, `MediaNotificationContent` is being deprecated for images. We encourage you to use `ImageNotificationContent` to send images. Explore other content-specific classes for other media types like `DocumentNotificationContent`, `VideoNotificationContent`, and `AudioNotificationContent`.
 
+> [!IMPORTANT]
+> To send a image message to a WhatsApp user, the WhatsApp user must first send a message to the WhatsApp Business Account. For more information, see [Start sending messages between business and WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+
 Assemble and send the image message:
 
 ```java
@@ -121,6 +102,9 @@ The Messages SDK enables Contoso to send media (image, video, audio, or document
 - [Recipient Phone Number in E16 format](#set-recipient-list).
 - URL of the Video media.
 
+> [!IMPORTANT]
+> To send a video message to a WhatsApp user, the WhatsApp user must first send a message to the WhatsApp Business Account. For more information, see [Start sending messages between business and WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+
 Assemble and send the video message:
 
 ```java
@@ -144,6 +128,9 @@ The Messages SDK enables Contoso to send media (image, video, audio, or document
 - [Recipient Phone Number in E16 format](#set-recipient-list).
 - URL of the Audio media.
 
+> [!IMPORTANT]
+> To send a audio message to a WhatsApp user, the WhatsApp user must first send a message to the WhatsApp Business Account. For more information, see [Start sending messages between business and WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+
 Assemble and send the audio message:
 
 ```java
@@ -167,6 +154,9 @@ The Messages SDK enables Contoso to send media (image, video, audio, or document
 - [Recipient Phone Number in E16 format](#set-recipient-list).
 - URL of the Document media.
 
+> [!IMPORTANT]
+> To send a document message to a WhatsApp user, the WhatsApp user must first send a message to the WhatsApp Business Account. For more information, see [Start sending messages between business and WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+
 Assemble and send the document message:
 
 ```java
@@ -199,4 +189,4 @@ for (MessageReceipt messageReceipt : docMessageResult.getReceipts()) {
 
 ## Full sample code
 
-Find the finalized code for this quickstart on [GitHub](https://github.com/Azure/azure-sdk-for-java/tree/d668cb44f64d303e71d2ee72a8b0382896aa09d5/sdk/communication/azure-communication-messages/src/samples/java/com/azure/communication/messages).
+Find the finalized code for this quickstart on [GitHub](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/communication/azure-communication-messages/src/samples/java/com/azure/communication/messages).

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/java-application-setup.md

@@ -29,7 +29,6 @@ Open the `pom.xml` file in your text editor. Add the following dependency elemen
 <dependency>
     <groupId>com.azure</groupId>
     <artifactId>azure-communication-messages</artifactId>
-    <version>1.0.0</version>
 </dependency>
 ```
 
@@ -53,3 +52,20 @@ public class App
     }
 }
 ```
+
+## Object model
+
+The following classes and interfaces handle some of the major features of the Azure Communication Services Advance Messaging SDK for Java.
+
+| Class Name | Description |
+| --- |--- |
+| `NotificationMessagesClientBuilder`           | Creates the Notification Messages Client. You provide it with an endpoint and a credential. |
+| `NotificationMessagesClient`                  | Needed to send WhatsApp messages and download media files.                               |
+| `NotificationMessagesAsyncClient`             | Needed to send WhatsApp messages and download media files asynchronously.                |
+| `SendMessageResult`                           | Contains the result from the Advance Messaging service for send notification message.       |
+| `MessageTemplateClientBuilder`                | Creates the Message Template Client. You provide it with an endpoint and a credential.      |
+| `MessageTemplateClient`                       | Needed to get the list of WhatsApp templates.                                            |
+| `MessageTemplateAsyncClient`                  | Needed to get the list of WhatsApp templates asynchronously.  |
+
+> [!NOTE]
+> For more information, see the Azure SDK for Java reference [com.azure.communication.messages](https://learn.microsoft.com/en-us/java/api/overview/azure/communication-messages-readme?view=azure-java-stable)

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/reactions/messages-quickstart-reaction-messages-java.md

@@ -13,6 +13,68 @@ ms.author: shamkh
 
 ## Prerequisites
 
-## Setting up
+- [WhatsApp Business Account registered with your Azure Communication Services resource](../../connect-whatsapp-business-account.md).
+- Active WhatsApp phone number to receive messages.
+- [Java Development Kit (JDK)](/java/azure/jdk/) version 8 or later.
+- [Apache Maven](https://maven.apache.org/download.cgi).
+
+## Set up environment
+
+To set up an environment for sending messages, complete the steps in the following sections.
 
 [!INCLUDE [Setting up for Java Application](../java-application-setup.md)]
+
+## Code examples
+
+Follow these steps to add required code snippets to the main function of your `App.java` file.
+- [Start sending messages between a business and a WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+- [Authenticate the client](#authenticate-the-client).
+- [Set channel registration ID](#set-channel-registration-id).
+- [Set recipient list](#set-recipient-list).
+- [Send a Reaction messages to a WhatsApp user message](#send-a-reaction-messages-to-a-whatsapp-user-message).
+
+[!INCLUDE [Common setting for using Advanced Messages SDK](../common-setting-java.md)]
+
+### Send a Reaction messages to a WhatsApp user message
+
+The Messages SDK enables Contoso to send reaction WhatsApp messages, when initiated by WhatsApp users. To send text messages:
+- [WhatsApp Channel ID](#set-channel-registration-id).
+- [Recipient Phone Number in E16 format](#set-recipient-list).
+- Reaction message content.
+
+> [!IMPORTANT]
+> To send a reaction to user message, the WhatsApp user must first send a message to the WhatsApp Business Account. For more information, see [Start sending messages between business and WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+
+Assemble and send the reaction to a message:
+
+```java
+// Assemble reaction message
+String emoji = "\uD83D\uDE00";
+ReactionNotificationContent reaction = new ReactionNotificationContent("<CHANNEL_ID>", recipients, emoji, "<REPLY_MESSAGE_ID>");
+
+// Send reaction to a message
+SendMessageResult textMessageResult = notificationClient.send(reaction);
+
+// Process result
+for (MessageReceipt messageReceipt : textMessageResult.getReceipts()) {
+    System.out.println("Message sent to:" + messageReceipt.getTo() + " and message id:" + messageReceipt.getMessageId());
+}
+```
+
+### Run the code
+
+1. Open to the directory that contains the `pom.xml` file and compile the project using the `mvn` command.
+
+   ```console
+   mvn compile
+   ```
+
+1. Run the app by executing the following `mvn` command.
+
+   ```console
+   mvn exec:java -D"exec.mainClass"="com.communication.quickstart.App" -D"exec.cleanupDaemonThreads"="false"
+   ```
+
+## Full sample code
+
+Find the finalized code for this quickstart on [GitHub](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/communication/azure-communication-messages/src/samples/java/com/azure/communication/messages).

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/stickers/messages-quickstart-sticker-messages-java.md

@@ -2,17 +2,79 @@
 title: Include file
 description: Include file
 services: azure-communication-services
-author: shamkh
+author: arifibrahim4
 ms.service: azure-communication-services
 ms.subservice: advanced-messaging
-ms.date: 12/15/2024
+ms.date: 1/27/2025
 ms.topic: include
 ms.custom: include file
-ms.author: shamkh
+ms.author: armohamed
 ---
 
 ## Prerequisites
 
-## Setting up
+- [WhatsApp Business Account registered with your Azure Communication Services resource](../../connect-whatsapp-business-account.md).
+- Active WhatsApp phone number to receive messages.
+- [Java Development Kit (JDK)](/java/azure/jdk/) version 8 or later.
+- [Apache Maven](https://maven.apache.org/download.cgi).
+
+## Set up environment
+
+To set up an environment for sending messages, complete the steps in the following sections.
 
 [!INCLUDE [Setting up for Java Application](../java-application-setup.md)]
+
+## Code examples
+
+Follow these steps to add required code snippets to the main function of your `App.java` file.
+- [Start sending messages between a business and a WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+- [Authenticate the client](#authenticate-the-client).
+- [Set channel registration ID](#set-channel-registration-id).
+- [Set recipient list](#set-recipient-list).
+- [Send a Sticker messages to a WhatsApp user](#send-a-sticker-messages-to-a-whatsapp-user).
+
+[!INCLUDE [Common setting for using Advanced Messages SDK](../common-setting-java.md)]
+
+### Send a sticker messages to a WhatsApp user
+
+The Messages SDK enables Contoso to send reaction WhatsApp messages, when initiated by WhatsApp users. To send text messages:
+- [WhatsApp Channel ID](#set-channel-registration-id).
+- [Recipient Phone Number in E16 format](#set-recipient-list).
+- Sticker message content.
+
+> [!IMPORTANT]
+> To send a sticker message to user, the WhatsApp user must first send a message to the WhatsApp Business Account. For more information, see [Start sending messages between business and WhatsApp user](#start-sending-messages-between-a-business-and-a-whatsapp-user).
+
+Assemble and send the sticker message:
+
+```java
+// Assemble sticker message
+String stickerUrl = "https://www.gstatic.com/webp/gallery/1.sm.webp";
+StickerNotificationContent sticker = new StickerNotificationContent("<CHANNEL_ID>", recipients, stickerUrl);
+
+// Send sticker message
+SendMessageResult textMessageResult = notificationClient.send(sticker);
+
+// Process result
+for (MessageReceipt messageReceipt : textMessageResult.getReceipts()) {
+    System.out.println("Message sent to:" + messageReceipt.getTo() + " and message id:" + messageReceipt.getMessageId());
+}
+```
+
+### Run the code
+
+1. Open to the directory that contains the `pom.xml` file and compile the project using the `mvn` command.
+
+   ```console
+   mvn compile
+   ```
+
+1. Run the app by executing the following `mvn` command.
+
+   ```console
+   mvn exec:java -D"exec.mainClass"="com.communication.quickstart.App" -D"exec.cleanupDaemonThreads"="false"
+   ```
+
+## Full sample code
+
+Find the finalized code for this quickstart on [GitHub](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/communication/azure-communication-messages/src/samples/java/com/azure/communication/messages).