Skip to content

Commit e7aeded

Browse files
committed
edit pass: seven-azure-communication-services-email-articles
1 parent d0cf76b commit e7aeded

File tree

5 files changed

+17
-17
lines changed

5 files changed

+17
-17
lines changed

articles/communication-services/concepts/email/email-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Azure Communication Services can simplify the integration of the email capabilit
2020

2121
Azure Communication Services email enables rich collaboration in communication modalities. It combines with SMS and other communication channels to build collaborative applications to help reach your customers in their preferred communication channel.
2222

23-
With Azure Communication Services, you can speed up your market entry with scalable and reliable email features by using your own SMTP domains. As with other communication channels, when you use Azure Communication Services to send email, you pay only for what you use.
23+
With Azure Communication Services, you can speed up your market entry with scalable and reliable email features by using your own SMTP domains. As with other communication channels, when you use Azure Communication Services to send email, you pay for only what you use.
2424

2525
[!INCLUDE [Survey Request](../../includes/survey-request.md)]
2626

@@ -33,7 +33,7 @@ With Azure Communication Services, you can speed up your market entry with scala
3333
- **Email analytics** to measure the success of delivery, with a detailed breakdown of engagement tracking.
3434
- **Opt-out** handling support to automatically detect and respect opt-outs managed in a suppression list.
3535
- **SDKs** to add rich collaboration capabilities to your applications.
36-
- **Security and compliance** to honor and respect data handling and privacy requirements that Azure promises to customers.
36+
- **Security and compliance** to honor and respect data-handling and privacy requirements that Azure promises to customers.
3737

3838
## Key features
3939

articles/communication-services/concepts/email/email-smtp-overview.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,9 @@ ms.service: azure-communication-services
1313

1414
# Email SMTP support in Azure Communication Services
1515

16-
Email is still a vital channel for global businesses to connect with customers. It's an essential part of business communications. Many businesses made large investments in on-premises infrastructures to support the strong SMTP email needs of their line-of-business (LOB) applications.
16+
Email is still a vital channel for global businesses to connect with customers. It's an essential part of business communications.
1717

18-
Delivering and securing outgoing emails from these existing LOB applications poses a challenge. As outgoing emails become more numerous and important, the difficulties of managing this critical aspect of communication become more obvious. Organizations often face problems such as email deliverability, security risks, and the need for centralized control over outgoing communications.
18+
Many businesses made large investments in on-premises infrastructures to support the strong SMTP email needs of their line-of-business (LOB) applications. Delivering and securing outgoing emails from these existing LOB applications can be challenging. As outgoing emails become more numerous and important, the difficulties of managing this critical aspect of communication become more obvious. Organizations often face problems such as email deliverability, security risks, and the need for centralized control over outgoing communications.
1919

2020
Email SMTP support in Azure Communication Services offers a strategic solution to simplify the sending of emails, strengthen security features, and unify control over outbound communications. As a bridge between email clients and mail servers, SMTP support improves the effectiveness of email delivery. It creates a specialized relay infrastructure that not only increases the chances of successful email delivery but also enhances authentication to help secure communication. In addition, this capability provides business with a centralized platform to manage outgoing emails for all business-to-consumer (B2C) communications and gain insights into email traffic.
2121

@@ -24,12 +24,12 @@ Email SMTP support in Azure Communication Services offers a strategic solution t
2424
- **Easy onboarding** steps for connecting SMTP endpoints with your applications.
2525
- **High-volume sending** support for B2C communications.
2626
- **Reliable delivery** status on emails sent from your application in near real time.
27-
- **Security and compliance** to honor and respect data handling and privacy requirements that Azure promises to customers.
27+
- **Security and compliance** to honor and respect data-handling and privacy requirements that Azure promises to customers.
2828

2929
## Key features
3030

3131
- **Azure-managed domain**: Customers can send mail from the pre-provisioned domain (`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net`).
32-
- **Custom domain**: Customers can send mail from their own verified domain(`notify.contoso.com`).
32+
- **Custom domain**: Customers can send mail from their own verified domain (`notify.contoso.com`).
3333
- **Sender authentication support**: The platform enables support for Sender Policy Framework (SPF) and Domain Keys Identified Mail (DKIM) settings for both Azure-managed and custom domains. Authenticated Received Chain (ARC) support preserves the email authentication result during transitioning.
3434
- **Email spam protection and fraud detection**: The platform performs email hygiene for all messages. It offers comprehensive email protection through Microsoft Defender components by enabling the existing transport rules for detecting malware: URL Blocking and Content Heuristic.
3535
- **Email analytics**: The **Insights** dashboard provides email analytics. The service emits logs at the request level. Each log has a message ID and recipient information for diagnostic and auditing purposes.
@@ -38,7 +38,7 @@ Email SMTP support in Azure Communication Services offers a strategic solution t
3838
## Next steps
3939

4040
- [Configure SMTP authentication with an Azure Communication Services resource](../../quickstarts/email/send-email-smtp/smtp-authentication.md)
41-
- [Start sending email by using SMTP](../../quickstarts/email/send-email-smtp/send-email-smtp.md)
41+
- [Send email by using SMTP](../../quickstarts/email/send-email-smtp/send-email-smtp.md)
4242

4343
The following documents might be interesting to you:
4444

articles/communication-services/concepts/email/prepare-email-communication-resource.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Similar to Chat, VoIP, and SMS modalities under Azure Communication Services, yo
1616

1717
- Approve the domain that your organization allows you to send mail from.
1818
- Define the sender domain for the P1 sender email address (also known as the Mail From email address) that appears on the envelope of the email. For more information, see [RFC 5321](https://tools.ietf.org/html/rfc5321).
19-
- Define the P2 sender email address that most email recipients will see on their email client. For more information, see [RFC 5322](https://tools.ietf.org/html/rfc5322).
19+
- Define the P2 sender email address that most email recipients see on their email client. For more information, see [RFC 5322](https://tools.ietf.org/html/rfc5322).
2020
- Set up and verify the sender domain by adding necessary DNS records for the sender verification to succeed.
2121

2222
One of the key principles for Azure Communication Services is to have a simplified developer experience. The service's email platform simplifies the experience for developers and eases the back-and-forth operation with organization administrators. It improves the end-to-end experience by allowing admin developers to configure the necessary sender authentication and other compliance-related steps to send email, so you can focus on building the required payload.

articles/communication-services/concepts/email/sdk-features.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,10 @@ You can use email client libraries in Azure Communication Services to add transa
1616

1717
## Client libraries
1818

19-
| Assembly | Protocol |Open vs. closed source| Namespace | Capabilities |
19+
| Assembly | Protocol |Open vs. closed source| Namespace | Capability |
2020
| ---------------------- | --------------------- | ---|-------------------------- | --------------------------------------------------------------------------- |
21-
| Azure Resource Manager | REST | Open | `Azure.ResourceManager.Communication` | Provision and manage email communication resources |
22-
| Email | REST | Open | `Azure.Communication.Email` | Send and get status on email messages |
21+
| Azure Resource Manager | REST | Open | `Azure.ResourceManager.Communication` | Provision and manage email communication resources. |
22+
| Email | REST | Open | `Azure.Communication.Email` | Send and get status on email messages. |
2323

2424
### Azure email communication resources
2525

@@ -33,7 +33,7 @@ Azure Resource Manager for email communication resources is meant for email doma
3333

3434
| Feature | Capability | JavaScript | Java | .NET | Python |
3535
| ----------------- | ------------------------------------------------------------------------------------- | --- | ---- | ---- | ------ |
36-
| Sendmail | Send email messages. </br> *Attachments are supported.* | ✔️ | ✔️ | ✔️ | ✔️ |
36+
| SendMail | Send email messages.</br> *Attachments are supported.* | ✔️ | ✔️ | ✔️ | ✔️ |
3737
| Get Status | Receive delivery reports for sent messages. | ✔️ | ✔️ | ✔️ | ✔️ |
3838

3939
## API throttling and timeouts

articles/communication-services/concepts/email/sender-reputation-managed-suppression-list.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Azure Communication Services offers email capabilities that can enrich your cust
2424
* Monitoring spam and abuse reports.
2525
* Maintaining a healthy contact list.
2626
* Understanding user engagement and inbox placements.
27-
* Understanding customer complaints and providing an easy opt-out process for unsubscribing.
27+
* Understanding customer complaints and providing an easy process for opting out or unsubscribing.
2828

2929
To enable email logs and monitor your email delivery, follow the steps in [Azure Communication Services email logs](../../concepts/analytics/logs/email-logs.md).
3030

@@ -72,7 +72,7 @@ The following SMTP codes can describe hard bounces:
7272
| 5.7.13 | User Account Disabled | The recipient's email account was disabled, and the email server is not accepting messages for that account. The mail service provider might have deactivated or suspended the recipient's email address, rendering the address inaccessible for receiving emails. Or, the user or the organization chose to disable the email account. |
7373
| 5.4.310 | DNS Domain Does Not Exist | The recipient's email domain doesn't exist or has an incorrect DNS configuration. Verify the domain's DNS settings. |
7474

75-
Sending emails repeatedly to addresses that don't exist can significantly affect your sending reputation. It's crucial to take action by promptly removing those addresses from your contact list and diligently managing a healthy contact list.
75+
Sending emails repeatedly to addresses that don't exist can significantly affect your sender reputation. It's crucial to take action by promptly removing those addresses from your contact list and diligently managing a healthy contact list.
7676

7777
### Error codes for soft bounces
7878

@@ -140,17 +140,17 @@ Email addresses can remain on the managed suppression list for a maximum of 14 d
140140

141141
## Reputation-related and asynchronous email delivery failures
142142

143-
Some email service providers generate email bounces from reputation issues. These bounces are often classified as spam and abuse related, because of specific reputation or content problems. The bounce messages might include URLs to webpages that provide further explanations for the bounces, to help you understand the reason for the delivery failure and enable appropriate action.
143+
Some email service providers generate email bounces from reputation issues. These bounces are often classified as spam and abuse related, because of specific reputation or content issues. The bounce messages might include URLs to webpages that provide further explanations for the bounces, to help you understand the reason for the delivery failure and enable appropriate action.
144144

145145
In addition to the SMTP-level bounces, bounces might occur after the receiving server accepts a message. Initially, the response from the email service provider might suggest successful email delivery. But later, the provider sends a bounce response.
146146

147147
These asynchronous bounces are typically directed to the return path address mentioned in the email payload. Be aware of these asynchronous bounces and handle them accordingly to maintain optimal email delivery performance.
148148

149149
## Opt-out or unsubscribe management
150150

151-
Understanding your customers' interest in your email communication and monitoring opt-out or unsubscribe requests when recipients choose not to receive emails from you are crucial aspects of maintaining a positive sender reputation. Whether you have a manual or automated process in place for handling unsubscribe requests, it's important to provide an **Unsubscribe** link in the email payload that you send. When recipients decide not to receive further emails, they can select the **Unsubscribe** link and remove their email address from your mailing list.
151+
Understanding your customers' interest in your email communication and monitoring opt-out or unsubscribe requests are crucial aspects of maintaining a positive sender reputation. Whether you have a manual or automated process in place for handling unsubscribe requests, it's important to provide an **Unsubscribe** link in the email payload that you send. When recipients decide not to receive further emails, they can select the **Unsubscribe** link and remove their email address from your mailing list.
152152

153-
The functionality of the links and instructions in the email is vital. They must be working correctly and promptly notify the application mailing list to remove the contact from the appropriate list or lists.
153+
The functionality of the links and instructions in the email is vital. They must be working correctly and promptly notify the application mailing list to remove the contact from the appropriate list.
154154

155155
An unsubscribe mechanism should be explicit and transparent from the subscriber's perspective. It should ensure that users know precisely which messages they're unsubscribing from.
156156

0 commit comments

Comments
 (0)