Merge pull request #301796 from glorialimicrosoft/gelli/updateDocsForPricingAndTemplate

Update docs for pricing and template parameter name

Author: JillGrant615

articles/communication-services/concepts/advanced-messaging/whatsapp/pricing.md

@@ -29,48 +29,27 @@ The Azure Communication Services Advanced Messaging usage fee is based on the nu
 
 ### WhatsApp
 
-When you connect your WhatsApp Business account to Azure, Azure Communication Services becomes the billing entity for your WhatsApp usage. WhatsApp provides these rates and are included in your Azure bill. The information given summarizes the key aspects of WhatsApp pricing. WhatsApp describes their pricing in detail here at [Conversation-Based Pricing](https://developers.facebook.com/docs/whatsapp/pricing).
+When you connect your WhatsApp Business account to Azure, Azure Communication Services becomes the billing entity for your WhatsApp usage. WhatsApp provides these rates, and they’re included in your Azure bill. WhatsApp describes their pricing in detail here: [WhatsApp Pricing Documentation](https://developers.facebook.com/docs/whatsapp/pricing).
 
-WhatsApp charges per conversation, not individual message. Conversations are message threads between a business and its customers that last 24 or 72 hours based on the conversation category. Conversations are categorized with one of the following categories:
 
-- **Marketing** conversations include promotions or offers, informational updates, or invitations for customers to respond or take action.
-- **Utility** conversations facilitate a specific, agreed-upon request or transaction, or update to a customer about an ongoing transaction. These conversations might include transaction confirmations, transaction updates, and/or post-purchase notifications.
-- **Authentication** conversations enable you to authenticate users with one-time passcodes, potentially at multiple steps in the sign in process. Authentication can include account verification, account recovery, and integrity challenges.
-- **Service** conversations help you resolve customer inquiries.
+**Effective July 1, 2025**, WhatsApp will implement the following changes to their pricing model:
 
-For service conversations, WhatsApp provides 1,000 free conversations each month across all business phone numbers. Marketing, utility and authentication conversations aren't part of the free tier.
+- The conversation-based pricing model will be deprecated.
+- WhatsApp will charge [per-message for template messages](https://developers.facebook.com/docs/whatsapp/pricing/updates-to-pricing#per-message-pricing) instead of per-conversation.
+- Utility template messages sent within an open customer service window [will become free](https://developers.facebook.com/docs/whatsapp/pricing/updates-to-pricing#free-utility-templates-in-the-customer-service-window).
 
-WhatsApp rates vary based on conversation category and country/region rate. Rates vary between \$0.003 and \$0.1597 depending on the category and country/region. WhatsApp provides a detailed explanation of their pricing, including the current rate card here: [Conversation-Based Pricing](https://developers.facebook.com/docs/whatsapp/pricing).
+See [Pricing Updates on the WhatsApp Business Platform](https://developers.facebook.com/docs/whatsapp/pricing/updates-to-pricing/) for additional details.
 
 ## Pricing example: Contoso sends appointment reminders to their WhatsApp customers
 
 Contoso provides a virtual visit solution for its patients. Contoso is scheduling the visit and sends WhatsApp invites to all patients reminding them about their upcoming visit. WhatsApp classifies appointment reminders as **Utility Conversations**. In this case, each WhatsApp conversation is a single message.
-
 Contoso sends appointment reminders to 2,000 patients in North America each month and the pricing would be:
 
 **Advanced Messaging usage for messages:**
 
-2,000 WhatsApp Conversations = 2,000 messages x \$0.005/message = \$10 USD
-
-**WhatsApp Fees (rates subject to change):**
-
-2,000 WhatsApp Conversations \* \$0.015/utility conversation = \$30 USD
-
-To get the latest WhatsApp rates, refer to WhatsApp’s pricing documentation: [Conversation-Based Pricing](https://developers.facebook.com/docs/whatsapp/pricing).
-
-## Pricing example: A WhatsApp user reaches out to a business for support
-
-Contoso is a business that provides a contact center for customers to seek product information and support. All these cases are closed within 24 hours and have an average of 20 messages each. Each case equals one WhatsApp Conversation. WhatsApp classifies contact center conversations as *Service Conversations*.
-
-Contoso manages 2,000 cases in North America each month and the pricing would be:
-
-**Advanced Messaging usage for conversation:**
-
-2,000 WhatsApp Conversations \* 20 messages/conversation x \$0.005/message = \$200 USD
-
-**WhatsApp Fees (rates subject to change):** 1,000 WhatsApp free conversations/month + 1,000 WhatsApp conversations \* \$0.0088/service conversation = \$8.80 USD
+2,000 messages × \$0.005/message = \$10.00 USD + WhatsApp Fee 
 
-To get the latest WhatsApp rates, refer to WhatsApp’s pricing documentation: [Conversation-Based Pricing](https://developers.facebook.com/docs/whatsapp/pricing).
+Please see WhatsApp pricing in detail here: [WhatsApp Pricing Documentation](https://developers.facebook.com/docs/whatsapp/pricing).
 
 ## Next steps
 

articles/communication-services/concepts/advanced-messaging/whatsapp/template-messages.md

@@ -49,6 +49,10 @@ Select a template to view the details.
 The `content` field of the template details can include parameter bindings. The parameter bindings can be denoted as:
 - A `format` field with a value such as `IMAGE`.
 - Double brackets surrounding a number, such as `{{1}}`. The number, indexed started at 1, indicates the order in which the binding values must be supplied to create the message template.
+- Double brackets surrounding a name, such as `{{movie_name}}`. The named parameters allow developers to reference parameters by name instead of position.
+> [!IMPORTANT]
+> When using named parameters, you must ensure that the name you use when sending the message **exactly matches** the name defined in the template you created in the Meta WhatsApp Manager.
+
 
 :::image type="content" source="../../../quickstarts/advanced-messaging/whatsapp/media/template-messages/sample-movie-ticket-confirmation-azure-portal.png" lightbox="../../../quickstarts/advanced-messaging/whatsapp/media/template-messages/sample-movie-ticket-confirmation-azure-portal.png" alt-text="Screenshot that shows template details.":::