review comments

Shamkh · Shamkh · commit 597ea64381b0 · 2024-03-25T14:16:28.000-07:00
diff --git a/articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-get-started-java.md b/articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-get-started-java.md
@@ -235,6 +235,14 @@ First, create a MessageTemplate using the values for a template.
 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
+- Recipient Phone Number in E16 format
+- Template details
+    - Name like 'sample_template'
+    - Language like 'en_us'
+    - Parameters if any
+    
 ```java
 // Assemble the template content
 String templateName = "sample_template";
@@ -267,15 +275,20 @@ To do so, from your personal WhatsApp account, send a message to your business n
 
 ### Send a text message to a WhatsApp user
 
+Messages SDK allows Contoso to send text WhatsApp messages, which initiated WhatsApp users initiated. To send text messages below details are required:
+- WhatsApp Channel ID
+- Recipient Phone Number in E16 format
+- Message body/text to be sent
+
 > [!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).
 
-In the text message, provide text to send to the recipient. In this example, we reply to the WhatsApp user with the text "Thanks for your feedback.".
+In this example, we reply to the WhatsApp user with the text "Thanks for your feedback.\n From Notification Messaging SDK".
 
 Assemble then send the text message:
 ```java
 // Assemble text message
-TextNotificationContent textContent = new TextNotificationContent(channelRegistrationId, recipientList, "“Thanks for your feedback.");
+TextNotificationContent textContent = new TextNotificationContent(channelRegistrationId, recipientList, "“Thanks for your feedback.\n From Notification Messaging SDK");
 
 // Send text message
 SendMessageResult textMessageResult = notificationClient.send(textContent);
@@ -288,10 +301,14 @@ for (MessageReceipt messageReceipt : textMessageResult.getReceipts()) {
 
 ### Send a media message to a WhatsApp user
 
+Messages SDK allows Contoso to send Image WhatsApp messages to WhatsApp users. To send Image embedded messages below details are required:
+- WhatsApp Channel ID
+- Recipient Phone Number in E16 format
+- MediaUri of the Image
+
 > [!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).
 
-To send a media message, provide a URI to an image.
 As an example, create a URI:
 ```java
 String mediaUrl = "https://aka.ms/acsicon1";
diff --git a/articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-get-started-js.md b/articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-get-started-js.md
@@ -238,6 +238,15 @@ First, create a MessageTemplate using the values for a template.
 
 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
+- Recipient Phone Number in E16 format
+- Template details
+    - Name like 'sample_template'
+    - Language like 'en_us'
+    - Parameters if any
+    
 ```javascript
 // Assemble the template content
 const template = {
@@ -290,10 +299,15 @@ To do so, from your personal WhatsApp account, send a message to your business n
 
 ### Send a text message to a WhatsApp user
 
+Messages SDK allows Contoso to send text WhatsApp messages, which initiated WhatsApp users initiated. To send text messages below details are required:
+- WhatsApp Channel ID
+- Recipient Phone Number in E16 format
+- Message body/text to be sent
+
 > [!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).
 
-In the text message, provide text to send to the recipient. In this example, we reply to the WhatsApp user with the text "Thanks for your feedback.".
+In this example, we reply to the WhatsApp user with the text "Thanks for your feedback.\n From Notification Messaging SDK".
 
 Assemble and send the media message:
 ```javascript
@@ -304,7 +318,7 @@ const textMessageResult = await client.path("/messages/notifications:send").post
         channelRegistrationId: channelRegistrationId,
         to: recipientList,
         kind: "text",
-        content: "Thanks for your feedback."
+        content: "Thanks for your feedback.\n From Notification Messaging SDK"
     }
 });
 
@@ -320,6 +334,11 @@ if (textMessageResult.status === "202") {
 
 ### Send a media message to a WhatsApp user
 
+Messages SDK allows Contoso to send Image WhatsApp messages to WhatsApp users. To send Image embedded messages below details are required:
+- WhatsApp Channel ID
+- Recipient Phone Number in E16 format
+- MediaUri of the Image
+
 > [!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).
 
diff --git a/articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-get-started-net.md b/articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-get-started-net.md
@@ -290,6 +290,15 @@ First, create a MessageTemplate using the values for a template.
 
 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
+- Recipient Phone Number in E16 format
+- Template details
+    - Name like 'sample_template'
+    - Language like 'en_us'
+    - Parameters if any
+    
 ```csharp
 // Assemble the template content
 string templateName = "sample_template";
@@ -330,16 +339,21 @@ To do so, from your personal WhatsApp account, send a message to your business n
 
 ### Send a text message to a WhatsApp user
 
+Messages SDK allows Contoso to send text WhatsApp messages, which initiated WhatsApp users initiated. To send text messages below details are required:
+- WhatsApp Channel ID
+- Recipient Phone Number in E16 format
+- Message body/text to be sent
+
 > [!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).
 
-In the text message, provide text to send to the recipient. In this example, we reply to the WhatsApp user with the text "Thanks for your feedback.".
+In this example, we reply to the WhatsApp user with the text "Thanks for your feedback.\n From Notification Messaging SDK".
 
 Assemble then send the text message:
 ```csharp
 // Assemble text message
 var textContent = 
-    new TextNotificationContent(channelRegistrationId, recipientList, "Thanks for your feedback.");
+    new TextNotificationContent(channelRegistrationId, recipientList, "Thanks for your feedback.\n From Notification Messaging SDK");
 
 // Send text message
 Response<SendMessageResult> sendTextMessageResult = 
@@ -348,10 +362,14 @@ Response<SendMessageResult> sendTextMessageResult =
 
 ### Send a media message to a WhatsApp user
 
+Messages SDK allows Contoso to send Image WhatsApp messages to WhatsApp users. To send Image embedded messages below details are required:
+- WhatsApp Channel ID
+- Recipient Phone Number in E16 format
+- MediaUri of the Image
+
 > [!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).
 
-To send a media message, provide a URI to an image.
 As an example, create a URI:
 ```csharp
 var uri = new Uri("https://aka.ms/acsicon1");
diff --git a/articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-quickstart-python.md b/articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/get-started/messages-quickstart-python.md
@@ -244,6 +244,14 @@ Messages SDK allows Contoso to send templated WhatsApp messages to WhatsApp user
     - Language like 'en_us'
     - Parameters if any
 
+For more examples of how to assemble your MessageTemplate and how to create your own template, refer to the following resource:
+- [Send WhatsApp Template Messages](../../../../../concepts/advanced-messaging/whatsapp/template-messages.md) 
+   
+For further WhatsApp requirements on templates, refer to the WhatsApp Business Platform API references:
+- [Create and Manage Templates](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/)
+- [Template Components](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/components)
+- [Sending Template Messages](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates)
+
 To send WhatsApp template message add below code in the send_template_message(self) function.
 ```python
         input_template: MessageTemplate = MessageTemplate(
@@ -302,11 +310,12 @@ To do so, from your personal WhatsApp account, send a message to your business n
 Messages SDK allows Contoso to send text WhatsApp messages, which initiated WhatsApp users initiated. To send text messages below details are required:
 - WhatsApp Channel ID
 - Recipient Phone Number in E16 format
-- Message body to be sent
+- Message body/text to be sent
 
 > [!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).
 
+In this example, we reply to the WhatsApp user with the text "Thanks for your feedback.\n From Notification Messaging SDK".
 ```python
     def send_text_message(self):
         from azure.communication.messages import NotificationMessagesClient
@@ -317,7 +326,7 @@ Messages SDK allows Contoso to send text WhatsApp messages, which initiated What
         text_options = TextNotificationContent (
             channel_registration_id=self.channelRegistrationId,
             to= [self.phone_number],
-            content="Hello World via Notification Messaging SDK.",
+            content="Thanks for your feedback.\n From Notification Messaging SDK",
         )
         
         # calling send() with whatsapp message details
@@ -360,6 +369,9 @@ Messages SDK allows Contoso to send Image WhatsApp messages to WhatsApp users. T
 > [!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).
 
+An example of media_uri used in sending media WhatsApp message.
+input_media_uri: str = "https://aka.ms/acsicon1"
+
 ```python
     def send_image_message(self):
         from azure.communication.messages import NotificationMessagesClient
@@ -514,9 +526,3 @@ WhatsApp Image containing Message with message id <<GUID>> was successfully sent
 
 You can review and download the sample code for this quick start on [GitHub](https://github.com/Azure-Samples/communication-services-python-quickstarts/tree/main/messages-quickstart).
 
-## References
-
-- [Send WhatsApp Template Messages](../../../../../concepts/advanced-messaging/whatsapp/template-messages.md) 
-- [Create and Manage Templates](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/)
-- [Template Components](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/components)
-- [Sending Template Messages](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates)
