javascript doc update and cleanup

Author: arifibrahim4

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

@@ -13,6 +13,14 @@ 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
 
 #### [Connection String](#tab/connection-string)
@@ -34,15 +42,15 @@ setx COMMUNICATION_SERVICES_CONNECTION_STRING "<your connection string>"
 For more information on how to set an environment variable for your system, follow the steps at [Store your connection string in an environment variable](../../../create-communication-resource.md#store-your-connection-string-in-an-environment-variable).
 
 
-To instantiate a MessageClient, add the following code to the `Main` method:
+To instantiate a NotificationClient, add the following code to the `Main` method:
 ```javascript
-const MessageClient = require("@azure-rest/communication-messages").default;
+const NotificationClient = require("@azure-rest/communication-messages").default;
 
 // Set Connection string
 const connectionString = process.env["COMMUNICATION_SERVICES_CONNECTION_STRING"];
 
 // Instantiate the client
-const client = MessageClient(connectionString);
+const client = NotificationClient(connectionString);
 ```
 
 <a name='azure-active-directory'></a>
@@ -72,17 +80,17 @@ To create a `DefaultAzureCredential` object:
     npm install @azure/identity
     ```
 
-1. To instantiate a `MessageClient`, add the following code to the `Main` method.
+1. To instantiate a `NotificationClient`, add the following code to the `Main` method.
     ```javascript
     const DefaultAzureCredential = require("@azure/identity").DefaultAzureCredential;
-    const MessageClient = require("@azure-rest/communication-messages").default;
+    const NotificationClient = require("@azure-rest/communication-messages").default;
     
     // Configure authentication
     const endpoint = "https://<resource name>.communication.azure.com";
     let credential = new DefaultAzureCredential();
     
     // Instantiate the client
-    const client = MessageClient(endpoint, credential);
+    const client = NotificationClient(endpoint, credential);
     ```
 
 #### [AzureKeyCredential](#tab/azurekeycredential)
@@ -102,17 +110,17 @@ After you add the environment variable, you might need to restart any running pr
 
 For more information on how to set an environment variable for your system, follow the steps at [Store your connection string in an environment variable](../../../create-communication-resource.md#store-your-connection-string-in-an-environment-variable).
 
-To instantiate a `MessageClient`, add the following code to the `Main` method:
+To instantiate a `NotificationClient`, add the following code to the `Main` method:
 ```javascript
 const AzureKeyCredential = require("@azure/core-auth").AzureKeyCredential;
-const MessageClient = require("@azure-rest/communication-messages").default;
+const NotificationClient = require("@azure-rest/communication-messages").default;
 
 // Configure authentication
 const endpoint = "https://<resource name>.communication.azure.com";
 const credential = new AzureKeyCredential("<your key credential>");
 
 // Instantiate the client
-const client = MessageClient(endpoint, credential);
+const client = NotificationClient(endpoint, credential);
 ```
 
 ---
@@ -149,81 +157,4 @@ Example:
 ```javascript
 // Example only
 const recipientList = ["+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
-    
-```javascript
-// Assemble the template content
-const template = {
-    name: "sample_template",
-    language: "en_US"
-};
-```
-
-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)
-
-```javascript
-// Send template message
-const templateMessageResult = await client.path("/messages/notifications:send").post({
-    contentType: "application/json",
-    body: {
-        channelRegistrationId: channelRegistrationId,
-        to: recipientList,
-        kind: "template",
-        template: template
-    }
-});
-
-// Process result
-if (templateMessageResult.status === "202") {
-    templateMessageResult.body.receipts.forEach((receipt) => {
-        console.log("Message sent to:"+receipt.to+" with message id:"+receipt.messageId);
-    });
-} else {
-    throw new Error("Failed to send message");
-}
-```
-
-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="../media/get-started/user-initiated-conversation.png" 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-javascript.md

@@ -16,50 +16,28 @@ ms.author: armohamed
 - [WhatsApp Business Account registered with your Azure Communication Services resource](../../connect-whatsapp-business-account.md).
 - Active WhatsApp phone number to receive messages.
 - [Node.js](https://nodejs.org/) Active LTS and Maintenance LTS versions (We recommend 8.11.1 and 10.14.1).
-- In a terminal or command window, make sure Node.js is installed.
+- [Node.js](https://nodejs.org/) Active LTS and Maintenance LTS versions (8.11.1 and 10.14.1 are recommended)
+    - In a terminal or command window, run `node --version` to check that Node.js is installed
 
-   ```console
-   node --version
-   ```
-
-## Set up the environment
-
-To set up an environment for sending messages, complete the steps in the following sections.
+## Setting up
 
 [!INCLUDE [Setting up for JavaScript Application](../javascript-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 JavaScript.
-
-| Class Name | Description |
-| --- | --- |
-| `MessageClient`   | Connects to your Azure Communication Services resource. It sends the messages.              |
-| `MessageTemplate` | Defines which template you use and the content of the template properties for your message. |
-
-> [!NOTE]
-> For more information, see the Azure SDK for JavaScript reference [@azure-rest/communication-messages package](/javascript/api/@azure-rest/communication-messages)
-
-## Common configuration
-
-Follow 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 `send-messages.js` 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-javascript.md)]
-
-## Code examples
-
-Follow these steps to add required code snippets to the main function of your `send-messages.js` 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).
 
+[!INCLUDE [Common setting for using Advanced Messages SDK](../common-setting-javascript.md)]
+
 > [!IMPORTANT]
 > To send a 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).
 
@@ -251,4 +229,4 @@ node ./send-messages.js
 
 ## Full sample code
 
-You can download the sample app from [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/communication/communication-messages-rest/samples).
+Find the finalized code for this quickstart on [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/communication/communication-messages-rest/samples).

articles/communication-services/quickstarts/advanced-messaging/whatsapp/includes/interactive/messages-quickstart-interactive-messages-javascript.md

@@ -11,19 +11,28 @@ ms.custom: include file
 ms.author: armohamed
 ---
 
-## Set up environment
+## Prerequisites
+- [WhatsApp Business Account registered with your Azure Communication Services resource](../../connect-whatsapp-business-account.md).
+- Active WhatsApp phone number to receive messages.
+- [Node.js](https://nodejs.org/) Active LTS and Maintenance LTS versions (8.11.1 and 10.14.1 are recommended)
+    - In a terminal or command window, run `node --version` to check that Node.js is installed
 
-To set up an environment for sending messages, complete the steps in the following sections.
+## Setting up
 
 [!INCLUDE [Setting up for JavaScript Application](../javascript-application-setup.md)]
 
 ## Code examples
 
 Follow these steps to add required code snippets to your `send-messages.js` 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 an Interactive List options message to a WhatsApp user](#send-an-interactive-reply-button-message-to-a-whatsapp-user).
 - [Send an Interactive Reply Button message to a WhatsApp user](#send-an-interactive-reply-button-message-to-a-whatsapp-user).
 - [Send an Interactive Click-to-action Url based message to a WhatsApp user](#send-an-interactive-click-to-action-url-based-message-to-a-whatsapp-user)
 
+[!INCLUDE [Common setting for using Advanced Messages SDK](../common-setting-javascript.md)]
 
 ### Send an Interactive List options message to a WhatsApp user
 
@@ -293,4 +302,4 @@ node ./send-messages.js
 
 ## Full sample code
 
-Find the finalized code for this quickstart on [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/communication/communication-messages-rest/samples).
+Find the finalized code for this sample on [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/communication/communication-messages-rest/samples).

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

@@ -12,6 +12,10 @@ ms.author: armohamed
 ---
 
 ## Prerequisites
+- [WhatsApp Business Account registered with your Azure Communication Services resource](../../connect-whatsapp-business-account.md).
+- Active WhatsApp phone number to receive messages.
+- [Node.js](https://nodejs.org/) Active LTS and Maintenance LTS versions (8.11.1 and 10.14.1 are recommended)
+    - In a terminal or command window, run `node --version` to check that Node.js is installed
 
 ## Setting up
 
@@ -20,8 +24,14 @@ ms.author: armohamed
 ## Code examples
 
 Follow these steps to add required code snippets to your `send-messages.js` 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-javascript.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:
@@ -88,4 +98,4 @@ node ./send-messages.js
 
 ## Full sample code
 
-Find the finalized code for this quickstart on [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/communication/communication-messages-rest/samples).
+Find the finalized code for this sample on [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/communication/communication-messages-rest/samples).

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

@@ -12,6 +12,10 @@ ms.author: armohamed
 ---
 
 ## Prerequisites
+- [WhatsApp Business Account registered with your Azure Communication Services resource](../../connect-whatsapp-business-account.md).
+- Active WhatsApp phone number to receive messages.
+- [Node.js](https://nodejs.org/) Active LTS and Maintenance LTS versions (8.11.1 and 10.14.1 are recommended)
+    - In a terminal or command window, run `node --version` to check that Node.js is installed
 
 ## Setting up
 
@@ -20,8 +24,14 @@ ms.author: armohamed
 ## Code examples
 
 Follow these steps to add required code snippets to your `send-messages.js` 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-javascript.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:
@@ -87,4 +97,4 @@ node ./send-messages.js
 
 ## Full sample code
 
-Find the finalized code for this quickstart on [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/communication/communication-messages-rest/samples).
+Find the finalized code for this sample on [GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/communication/communication-messages-rest/samples).