Merge pull request #268588 from Shamkh/CPMPythonDocs

Advanced Messages Python quickstart.

Author: PMEds28

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

@@ -10,10 +10,10 @@ ms.date: 02/29/2024
 ms.topic: quickstart
 ms.service: azure-communication-services
 ms.custom: devx-track-extended-java, devx-track-js
-zone_pivot_groups: acs-js-csharp-java
+zone_pivot_groups: acs-js-csharp-java-python
 ---
 
-# Quickstart: Add Advanced Messaging to your app
+# Quickstart: Send WhatsApp Messages using Advanced Messages
 
 Azure Communication Services enables you to send and receive WhatsApp messages. In this quickstart, get started integrating your app with Azure Communication Advanced Messages SDK and start sending/receiving WhatsApp messages. Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.
 
@@ -29,6 +29,10 @@ Azure Communication Services enables you to send and receive WhatsApp messages.
 [!INCLUDE [Send WhatsApp Messages JavaScript SDK](./includes/get-started/messages-get-started-js.md)]
 ::: zone-end
 
+::: zone pivot="programming-language-python"
+[!INCLUDE [Send WhatsApp Messages Python SDK](./includes/get-started/messages-quickstart-python.md)]
+::: zone-end
+
 ## Next steps
 
 In this quickstart, you tried out the Advanced Messaging for WhatsApp SDK. Next you might also want to see the following articles:

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](#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";
@@ -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](#set-channel-registration-id)
+- [Recipient Phone Number in E16 format](#set-recipient-list)
+- 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](#set-channel-registration-id)
+- [Recipient Phone Number in E16 format](#set-recipient-list)
+- 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";
@@ -325,7 +342,7 @@ for (MessageReceipt messageReceipt : mediaMessageResult.getReceipts()) {
    mvn exec:java -D"exec.mainClass"="com.communication.quickstart.App" -D"exec.cleanupDaemonThreads"="false"
    ```
 
-## Sample code
+## 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).
 

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](#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
+    
 ```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](#set-channel-registration-id)
+- [Recipient Phone Number in E16 format](#set-recipient-list)
+- 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](#set-channel-registration-id)
+- [Recipient Phone Number in E16 format](#set-recipient-list)
+- 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).
 
@@ -359,7 +378,7 @@ Use the node command to run the code you added to the send-messages.js file.
 node ./send-messages.js
 ```
 
-## Sample code
+## Full sample code
 
 You can download the sample app from [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/7efc61a0414c6f898409e355d0ba8d228882625f/sdk/communication/communication-messages-rest/samples-dev).
 

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](#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
+    
 ```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](#set-channel-registration-id)
+- [Recipient Phone Number in E16 format](#set-recipient-list)
+- 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](#set-channel-registration-id)
+- [Recipient Phone Number in E16 format](#set-recipient-list)
+- 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");
@@ -373,7 +391,7 @@ Response<SendMessageResult> sendMediaMessageResult =
 Build and run your program.  
 
 To send a text or media message to a WhatsApp user, there must be an active conversation between the WhatsApp Business Account and the WhatsApp user.  
-If you don't have an active conversation, for the purposes of this quickstart, you should add a wait between sending the template message and sending the text message. This added delay gives you enough time to reply to the business on the user's WhatsApp account. For reference, the full example at [Sample code](#sample-code) prompts for manual user input before sending the next message.
+If you don't have an active conversation, for the purposes of this quickstart, you should add a wait between sending the template message and sending the text message. This added delay gives you enough time to reply to the business on the user's WhatsApp account. For reference, the full example at [Sample code](#full-sample-code) prompts for manual user input before sending the next message.
 
 If successful, you receive three messages on the user's WhatsApp account.
 
@@ -400,6 +418,6 @@ dotnet run
 
 ---
 
-## Sample code
+## Full sample code
 
 [!INCLUDE [Full code example with .NET](./messages-get-started-full-example-net.md)]