Merge pull request #289624 from vac0224/vc-service-limits-email-2024-11-08

New content in Email Service Limits

Author: v-dirichards

articles/communication-services/concepts/service-limits.md

@@ -83,7 +83,7 @@ For more information, see the [identity concept overview](./authentication.md) p
 
 When sending or receiving a high volume of messages, you might receive a ```429``` error. This error indicates you're hitting the service limitations, and your messages are queued to be sent once the number of requests is below the threshold.
 
-Rate Limits for SMS:
+### Rate Limits for SMS
 
 |Operation|Number Type |Scope|Timeframe (s)| Limit (request #) | Message units per minute|
 |---------|---|--|-------------|-------------------|-------------------------|
@@ -100,13 +100,39 @@ For more information on the SMS SDK and service, see the [SMS SDK overview](./sm
 
 ## Email
 
-You can send a limited number of email messages. If you exceed the following limits for your subscription, your requests are rejected. You can attempt these requests again, after the Retry-After time passes. Take action before reaching the limit by requesting to raise your sending volume limits if needed.
+You can send a limited number of email messages. If you exceed the [email rate limits](#rate-limits-for-email) for your subscription, your requests are rejected. You can attempt these requests again, after the Retry-After time passes. Take action before reaching the limit by requesting to raise your sending volume limits if needed.
 
-The Azure Communication Services email service is designed to support high throughput. However, the service imposes initial rate limits to help customers onboard smoothly and avoid some of the issues that can occur when switching to a new email service. We recommend gradually increasing your email volume using Azure Communication Services Email over a period of two to four weeks, while closely monitoring the delivery status of your emails. This gradual increase enables third-party email service providers to adapt to the change in IP for your domain's email traffic. The gradual change gives you time to protect your sender reputation and maintain the reliability of your email delivery.
+The Azure Communication Services email service is designed to support high throughput. However, the service imposes initial rate limits to help customers onboard smoothly and avoid some of the issues that can occur when switching to a new email service.
 
-We approve higher limits for customers based on use case requirements, domain reputation, traffic patterns, and failure rates. To request higher limits, follow the instructions at [Quota increase for email domains](./email/email-quota-increase.md). Higher quotas are only available for verified custom domains, not Azure-managed domains.
+We recommend gradually increasing your email volume using Azure Communication Services Email over a period of two to four weeks, while closely monitoring the delivery status of your emails. This gradual increase enables third-party email service providers to adapt to the change in IP for your domain's email traffic. The gradual change gives you time to protect your sender reputation and maintain the reliability of your email delivery.
 
-### Rate Limits 
+Azure Communication Services email service supports high volume up to 1-2 million messages per hour. High throughput can be enabled based on several factors, including:
+- Customer peak traffic
+- Business needs
+- Ability to manage failure rates
+- Domain reputation
+
+### Failure Rate Requirements
+
+To enable a high email quota, your email failure rate must be less than one percent (1%). If your failure rate is high, you must resolve the issues before requesting a quota increase.
+Customers are expected to actively monitor their failure rates.
+
+If the failure rate increases after a quota increase, Azure Communication Services will contact the customer for immediate action and a resolution timeline. In extreme cases, if the failure rate isn't managed within the specified timeline, Azure Communication Services may reduce or suspend service until the issue is resolved.
+
+#### Related articles
+
+Azure Communication Services provides rich logs and analytics to help monitor and manage failure rates. For more information, see the following articles:
+
+- [Improve sender reputation in Azure Communication Services email](./email/sender-reputation-managed-suppression-list.md)
+- [Email Insights](./analytics/insights/email-insights.md)
+- [Enable logs via Diagnostic Settings in Azure Monitor](./analytics/enable-logging.md)
+- [Quickstart: Handle Email events](../quickstarts/email/handle-email-events.md)
+- [Quickstart: Manage domain suppression lists in Azure Communication Services using the management client libraries](../quickstarts/email/manage-suppression-list-management-sdks.md)
+
+> [!NOTE]
+> To request higher limits, follow the instructions at [Quota increase for email domains](./email/email-quota-increase.md). Higher quotas are only available for verified custom domains, not Azure-managed domains.
+
+### Rate Limits for Email
 
 [Custom Domains](../quickstarts/email/add-custom-verified-domains.md)
 
@@ -126,7 +152,7 @@ We approve higher limits for customers based on use case requirements, domain re
 |Get Email Status|Per Subscription|1|10|
 |Get Email Status|Per Subscription|60|20|
 
-### Size Limits
+### Size Limits for Email
 
 | **Name** | Limit |
 | --- | --- |
@@ -161,7 +187,7 @@ To increase your email quota, follow the instructions at [Quota increase for ema
 
 ## Chat
 
-### Size Limits
+### Size Limits for Chat
 
 | **Name** | Limit |
 | --- | --- |
@@ -172,7 +198,7 @@ To increase your email quota, follow the instructions at [Quota increase for ema
 |Message Size|28 KB |
 |Number of Azure Communication Services resources per Azure Bot|1000 |
 
-### Rate Limits
+### Rate Limits for Chat
 
 | **Operation** | **Scope** | **Limit per 10 seconds** | **Limit per minute** |
 | --- | --- | --- | --- |
@@ -195,7 +221,7 @@ To increase your email quota, follow the instructions at [Quota increase for ema
 | Send typing indicator | per Chat thread | 10 | 30 |
 
 > [!NOTE] 
-> \* Read receipts and typing indicators are not supported on chat threads with more than 20 participants. 
+> \* Read receipts and typing indicators are not supported on chat threads with more than 20 participants.
 
 ### Chat storage
 
@@ -260,7 +286,7 @@ For more information about the voice and video calling SDK and service, see the
 
 When sending or receiving a high volume of requests, you might receive a ```ThrottleLimitExceededException``` error. This error indicates you're hitting the service limitations, and your requests fail until the token of bucket to handle requests is replenished after a certain time.
 
-Rate Limits for Job Router:
+### Rate Limits for Job Router
 
 | Operation | Scope | Timeframe (seconds) | Limit (number of requests) | Timeout in seconds |
 | --- | --- | --- | --- | --- |
@@ -272,7 +298,7 @@ If you need to send a volume of messages that exceeds the rate limits, email us
 
 ## Teams Interoperability and Microsoft Graph
 
-Using a Teams interoperability scenario, you'll likely use some Microsoft Graph APIs to create [meetings](/graph/cloud-communications-online-meetings).  
+Using a Teams interoperability scenario, you often use Microsoft Graph APIs to create [meetings](/graph/cloud-communications-online-meetings).  
 
 Each service offered through Microsoft Graph has different limitations; service-specific limits are [described here](/graph/throttling) in more detail.
 

articles/communication-services/quickstarts/email/enable-user-engagement-tracking.md

@@ -15,45 +15,49 @@ ms.service: azure-communication-services
 To gain insights into your customer email engagements, enable user engagement tracking. Only emails sent from Azure Communication Services verified email domains that are enabled for user engagement analysis can receive engagement tracking metrics.
 
 > [!IMPORTANT]
-> By enabling this feature, you are acknowledging that you are enabling open/click tracking and giving consent to collect your customers' email activity. 
+> By enabling this feature, you acknowledge that you are enabling open/click tracking and giving consent to collect your customers' email activity. 
 
 In this quick start, you learn how to enable user engagement tracking for a verified email domain in Azure Communication Services.
 
 ## Enable email engagement
+
 1.	Go the overview page of the Email Communications Service resource that you created in [Quickstart: Create and manage an Email Communication Service resource](./create-email-communication-resource.md).
+
 2.	In the left navigation panel, click **Provision Domains** to open a list of provisioned domains.
+
 3.	Click on the name of the custom domain that you would like to update.
 
-:::image type="content" source="./media/email-domains-custom-provision-domains.png" alt-text="Screenshot that shows how to get to overview page for Domain from provisioned domains list.":::
+   :::image type="content" source="./media/email-domains-custom-provision-domains.png" alt-text="Screenshot that shows how to get to overview page for Domain from provisioned domains list.":::
 
    When you click the custom domain name, it opens the Domain Overview page. The first time you open this page, User interaction tracking is **Off** by default.
 
 4.	Click **Turn On** to enable engagement tracking.
 
-:::image type="content" source="./media/email-domains-custom-overview.png" alt-text="Screenshot that shows the overview page of the domain." lightbox="media/email-domains-custom-overview-expanded.png":::
+   :::image type="content" source="./media/email-domains-custom-overview.png" alt-text="Screenshot that shows the overview page of the domain." lightbox="media/email-domains-custom-overview-expanded.png":::
 
 5.	A confirmation dialog box opens. Click **Turn On** to confirm that you want to enable engagement tracking.
 
-:::image type="content" source="./media/email-domains-user-engagement.png" alt-text="Screenshot that shows the user engagement turn-on page of the domain." lightbox="media/email-domains-user-engagement-expanded.png":::
+   :::image type="content" source="./media/email-domains-user-engagement.png" alt-text="Screenshot that shows the user engagement turn-on page of the domain." lightbox="media/email-domains-user-engagement-expanded.png":::
 
 **Your email domain is now ready to send emails with user engagement tracking. Note that user engagement tracking applies to HTML content and does not function if you submit the payload in plaintext.**
 
 You can now subscribe to Email User Engagement operational logs, which provide information about **open** and **click** user engagement metrics for messages sent from the email service.
 
 > [!NOTE]
-> User Engagement Tracking cannot be enabled for Azure Managed Domains or custom domains with default sending limits. For more information, see [Service limits for Azure Communication Services](../../concepts/service-limits.md#rate-limits).
+> User Engagement Tracking cannot be enabled for Azure Managed Domains or custom domains with default sending limits. For more information, see [Service limits for Azure Communication Services](../../concepts/service-limits.md#rate-limits-for-email).
 
 > [!IMPORTANT]
 > If you plan to enable open/click tracking for your email links, ensure that you are correctly formatting the email content in HTML. Specifically, make sure that your tracking content is properly encapsulated within the payload, as follows:
+
 ```html
  <a href="https://www.contoso.com">Contoso Inc.</a>
 ```
----
+
 ## Next steps
 
 - Access logs for [Email Communication Service](../../concepts/analytics/logs/email-logs.md).
 
 ## Related articles
 
-- Familiarize yourself with the [Email client library](../../concepts/email/sdk-features.md)
-- [Quickstart: How to connect Email Communication Service with an Azure Communication Services resource](../../quickstarts/email/connect-email-communication-resource.md)
+- Familiarize yourself with the [Email client library](../../concepts/email/sdk-features.md).
+- [Quickstart: How to connect Email Communication Service with an Azure Communication Services resource](../../quickstarts/email/connect-email-communication-resource.md).

articles/communication-services/quickstarts/email/includes/create-sender-username-resource-az-portal.md

@@ -12,27 +12,28 @@ ms.author: v-vprasannak
 - An Azure Communication Services Email Resource created and ready to add the domains. See [Get started with Creating Email Communication Resource](../../../quickstarts/email/create-email-communication-resource.md).
 - A custom domain with higher than default sending limits provisioned and ready. See [Quickstart: How to add custom verified email domains](../../../quickstarts/email/add-custom-verified-domains.md).
 
-
 ## Create multiple sender usernames
 
 An email domain that is provisioned to send email has a default MailFrom address, formatted as `[email protected]`. If you configure a custom domain such as `notification.azuremails.net`, then the default MailFrom address has `[email protected]` added. You can configure and add more MailFrom addresses and FROM display names to use values that are easier to read.
 
 > [!NOTE]
-> Sender usernames cannot be enabled for Azure Managed Domains regardless of the sending limits or custom domains with default sending limits. For more information, see [Service limits for Azure Communication Services](../../../concepts/service-limits.md#rate-limits).
+> Sender usernames cannot be enabled for Azure Managed Domains regardless of the sending limits or custom domains with default sending limits. For more information, see [Service limits for Azure Communication Services](../../../concepts/service-limits.md#rate-limits-for-email).
 
 1. Open the Overview page of the Email Communication Service resource that you created in [Get started with Creating Email Communication Resource](../../../quickstarts/email/create-email-communication-resource.md).
+
 2. Click **Provision Domains** on the left navigation panel to see list of provisioned domains.
-3. Click on the one of the provisioned domains to open the Domain Overview page.
 
-     :::image type="content" source="../../../quickstarts/email/media/email-provisioned-domains.png" alt-text="Screenshot that shows Domain link in list of provisioned email domains." lightbox="../../../quickstarts/email/media/email-provisioned-domains-expanded.png":::
+3. To open the Domain Overview page, click on the one of the provisioned domains.
+
+   :::image type="content" source="../../../quickstarts/email/media/email-provisioned-domains.png" alt-text="Screenshot that shows Domain link in list of provisioned email domains." lightbox="../../../quickstarts/email/media/email-provisioned-domains-expanded.png":::
 
 4. Click the **MailFrom Addresses** link in left navigation to see the default `donotreply` in MailFrom addresses list.
 
     :::image type="content" source="../../../quickstarts/email/media/email-mailfrom-overview.png" alt-text="Screenshot that explains how to list of MailFrom addresses.":::
 
 5. Click **Add**.
 
-     :::image type="content" source="../../../quickstarts/email/media/email-domains-mailfrom-add.png" alt-text="Screenshot that explains how to change MailFrom address and display name.":::
+    :::image type="content" source="../../../quickstarts/email/media/email-domains-mailfrom-add.png" alt-text="Screenshot that explains how to change MailFrom address and display name.":::
 
 6.  Enter the Display Name and MailFrom address. Click **Save**.  
 
@@ -47,6 +48,7 @@ An email domain that is provisioned to send email has a default MailFrom address
 ## Removing multiple sender usernames
 
 1. Open the Domains overview page.
+
 2. Click on **MailFrom addresses** link in left navigation to see the MailFrom addresses list. 
 
     :::image type="content" source="../../../quickstarts/email/media/email-mailfrom-overview-updated.png" alt-text="Screenshot that shows MailFrom addresses." lightbox="../../../quickstarts/email/media/email-mailfrom-overview-updated-expanded.png":::