Skip to content

Commit 2001d87

Browse files
committed
New content in Email
New text about Email rate limits, edited all Rate Limit headings to differentiate
1 parent 9fddad1 commit 2001d87

File tree

1 file changed

+37
-11
lines changed

1 file changed

+37
-11
lines changed

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

Lines changed: 37 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ For more information, see the [identity concept overview](./authentication.md) p
8383

8484
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.
8585

86-
Rate Limits for SMS:
86+
### Rate Limits for SMS
8787

8888
|Operation|Number Type |Scope|Timeframe (s)| Limit (request #) | Message units per minute|
8989
|---------|---|--|-------------|-------------------|-------------------------|
@@ -100,13 +100,39 @@ For more information on the SMS SDK and service, see the [SMS SDK overview](./sm
100100

101101
## Email
102102

103-
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.
103+
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.
104104

105-
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.
105+
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.
106106

107-
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.
107+
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.
108108

109-
### Rate Limits
109+
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:
110+
- Customer peak traffic
111+
- Business needs
112+
- Ability to manage failure rates
113+
- Domain reputation
114+
115+
### Failure Rate Requirements
116+
117+
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.
118+
Customers are expected to actively monitor their failure rates.
119+
120+
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.
121+
122+
#### Related articles
123+
124+
Azure Communication Services provides rich logs and analytics to help monitor and manage failure rates. For more information, see the following articles:
125+
126+
- [Improve sender reputation in Azure Communication Services email](./email/sender-reputation-managed-suppression-list.md)
127+
- [Email Insights](./analytics/insights/email-insights.md)
128+
- [Enable logs via Diagnostic Settings in Azure Monitor](./analytics/enable-logging.md)
129+
- [Quickstart: Handle Email events](../quickstarts/email/handle-email-events.md)
130+
- [Quickstart: Manage domain suppression lists in Azure Communication Services using the management client libraries](../quickstarts/email/manage-suppression-list-management-sdks.md)
131+
132+
> [!NOTE]
133+
> 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.
134+
135+
### Rate Limits for Email
110136

111137
[Custom Domains](../quickstarts/email/add-custom-verified-domains.md)
112138

@@ -126,7 +152,7 @@ We approve higher limits for customers based on use case requirements, domain re
126152
|Get Email Status|Per Subscription|1|10|
127153
|Get Email Status|Per Subscription|60|20|
128154

129-
### Size Limits
155+
### Size Limits for Email
130156

131157
| **Name** | Limit |
132158
| --- | --- |
@@ -161,7 +187,7 @@ To increase your email quota, follow the instructions at [Quota increase for ema
161187
162188
## Chat
163189

164-
### Size Limits
190+
### Size Limits for Chat
165191

166192
| **Name** | Limit |
167193
| --- | --- |
@@ -172,7 +198,7 @@ To increase your email quota, follow the instructions at [Quota increase for ema
172198
|Message Size|28 KB |
173199
|Number of Azure Communication Services resources per Azure Bot|1000 |
174200

175-
### Rate Limits
201+
### Rate Limits for Chat
176202

177203
| **Operation** | **Scope** | **Limit per 10 seconds** | **Limit per minute** |
178204
| --- | --- | --- | --- |
@@ -195,7 +221,7 @@ To increase your email quota, follow the instructions at [Quota increase for ema
195221
| Send typing indicator | per Chat thread | 10 | 30 |
196222

197223
> [!NOTE]
198-
> \* Read receipts and typing indicators are not supported on chat threads with more than 20 participants.
224+
> \* Read receipts and typing indicators are not supported on chat threads with more than 20 participants.
199225
200226
### Chat storage
201227

@@ -260,7 +286,7 @@ For more information about the voice and video calling SDK and service, see the
260286

261287
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.
262288

263-
Rate Limits for Job Router:
289+
### Rate Limits for Job Router
264290

265291
| Operation | Scope | Timeframe (seconds) | Limit (number of requests) | Timeout in seconds |
266292
| --- | --- | --- | --- | --- |
@@ -272,7 +298,7 @@ If you need to send a volume of messages that exceeds the rate limits, email us
272298

273299
## Teams Interoperability and Microsoft Graph
274300

275-
Using a Teams interoperability scenario, you'll likely use some Microsoft Graph APIs to create [meetings](/graph/cloud-communications-online-meetings).
301+
Using a Teams interoperability scenario, you often use Microsoft Graph APIs to create [meetings](/graph/cloud-communications-online-meetings).
276302

277303
Each service offered through Microsoft Graph has different limitations; service-specific limits are [described here](/graph/throttling) in more detail.
278304

0 commit comments

Comments
 (0)