Skip to content

Commit d0cf76b

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

File tree

5 files changed

+20
-22
lines changed

5 files changed

+20
-22
lines changed

articles/communication-services/concepts/email/email-attachment-allowed-mime-types.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Allowed attachment types for sending email in Azure Communication Services
33
titleSuffix: An Azure Communication Services concept article
4-
description: Learn about how validation for attachment MIME types works for Email Communication Services in Azure Communication Services.
4+
description: Learn about how validation for attachment MIME types works in Azure Communication Services.
55
author: natekimball-msft
66
manager: koagbakp
77
services: azure-communication-services
@@ -17,11 +17,11 @@ The [SendMail operation](../../quickstarts/email/send-email.md) allows the optio
1717

1818
## What is a MIME type?
1919

20-
MIME types are a way to identify the type of data that's being sent over the internet. When users send email requests by using Email Communication Services in Azure Communication Services, they can specify the MIME type of the email content so that the recipient's email client can properly display and interpret the message. If an email message includes an attachment, the MIME type is set to the appropriate file type (for example, `application/pdf` for a PDF document).
20+
MIME types are a way to identify the type of data that's being sent over the internet. When users send email requests by using Azure Communication Services, they can specify the MIME type of the email content so that the recipient's email client can properly display and interpret the message. If an email message includes an attachment, the MIME type is set to the appropriate file type (for example, `application/pdf` for a PDF document).
2121

2222
Developers can ensure that the recipient's email client properly formats and interprets the email message by using MIME types, irrespective of the software or platform that the system is using. This information helps ensure that the email message is delivered correctly and that the recipient can access the content as intended. Using MIME types can also help to improve the security of email communications, because they can indicate whether an email message includes executable content or other potentially harmful elements.
2323

24-
MIME types are a critical component of email communication. By using MIME types with Email Communication Services in Azure Communication Services, developers can help ensure that their email messages are delivered correctly and securely.
24+
MIME types are a critical component of email communication. By using MIME types with Azure Communication Services, developers can help ensure that their email messages are delivered correctly and securely.
2525

2626
## Allowed attachment types
2727

@@ -101,9 +101,9 @@ IANA maintains a registry of standardized MIME types. The registry includes a un
101101

102102
## Next steps
103103

104-
* [Prepare an Email Communication Services resource for Azure Communication Services](./prepare-email-communication-resource.md)
104+
* [Prepare an email communication resource for Azure Communication Services](./prepare-email-communication-resource.md)
105105
* [Email domains and sender authentication for Azure Communication Services](./email-domain-and-sender-authentication.md)
106-
* [Send email by using Email Communication Services in Azure Communication Services](../../quickstarts/email/send-email.md)
106+
* [Send email by using Azure Communication Services](../../quickstarts/email/send-email.md)
107107
* [Connect a verified email domain in Azure Communication Services](../../quickstarts/email/connect-email-communication-resource.md)
108108

109109
The following documents might be interesting to you:

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,9 +46,9 @@ With Azure Communication Services, you can speed up your market entry with scala
4646

4747
## Next steps
4848

49-
- [Prepare an Email Communication Services resource for Azure Communication Services](./prepare-email-communication-resource.md)
49+
- [Prepare an email communication resource for Azure Communication Services](./prepare-email-communication-resource.md)
5050
- [Email domains and sender authentication for Azure Communication Services](./email-domain-and-sender-authentication.md)
51-
- [Create and manage an Email Communication Services resource in Azure Communication Services](../../quickstarts/email/create-email-communication-resource.md)
51+
- [Create and manage an email communication resource in Azure Communication Services](../../quickstarts/email/create-email-communication-resource.md)
5252
- [Connect a verified email domain in Azure Communication Services](../../quickstarts/email/connect-email-communication-resource.md)
5353

5454
The following topics might be interesting to you:

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

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Prepare an Email Communication Services resource for Azure Communication Services
2+
title: Prepare an email communication resource for Azure Communication Services
33
titleSuffix: An Azure Communication Services concept article
4-
description: Learn about the Email Communication Services resources and domains for Azure Communication Services.
4+
description: Learn about the Azure Communication Services email resources and domains.
55
author: bashan-git
66
manager: sphenry
77
services: azure-communication-services
@@ -10,34 +10,32 @@ ms.date: 03/31/2023
1010
ms.topic: conceptual
1111
ms.service: azure-communication-services
1212
---
13-
# Prepare an Email Communication Services resource for Azure Communication Services
13+
# Prepare an email communication resource for Azure Communication Services
1414

15-
Similar to Chat, VoIP, and SMS modalities under Azure Communication Services, you can send an email by using an Email Communication Services resource in Azure Communication Services. Sending an email requires certain preconfiguration steps, and you have to rely on an admin in your organization to help set that up. The admin needs to:
15+
Similar to Chat, VoIP, and SMS modalities under Azure Communication Services, you can send an email by using an Azure Communication Services resource. Sending an email requires certain preconfiguration steps, and you have to rely on an admin in your organization to help set that up. The admin needs to:
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).
1919
- 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).
2020
- Set up and verify the sender domain by adding necessary DNS records for the sender verification to succeed.
2121

22-
After the sender domain is configured correctly and verified, you can link the verified domains with your Email Communication Services resource and start sending emails.
23-
2422
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.
2523

2624
Your Azure admin creates a new resource of type **Email Communication Services** and adds the allowed email sender domains under this resource. The domains added under this resource type contain all the sender authentication and engagement tracking configurations that must be completed before you start sending emails.
2725

28-
After the sender domain is configured and verified, you can link these domains with your Email Communication Services resource. You can select which of the verified domains is suitable for your application and connect them to send emails from your application.
26+
After the sender domains are configured and verified, you can link these domains with your Azure Communication Services resource. You can select which of the verified domains is suitable for your application and connect them to send emails from your application.
2927

3028
## Admin responsibilities
3129

3230
- Plan all the required email domains for the applications in the organization.
33-
- Create the new Email Communication Services resource.
31+
- Create the new email communication resource.
3432
- Add custom domains or get an Azure-managed domain.
3533
- Perform the sender verification steps for custom domains.
3634
- Set up a Domain-based Message Authentication, Reporting, and Conformance (DMARC) policy for the verified sender domains.
3735

3836
## Developer responsibilities
3937

40-
- Connect the preferred domain to Email Communication Services resources.
38+
- Connect the preferred domain to Azure Communication Services resources.
4139
- Generate the email payload and define these required elements:
4240
- Email headers
4341
- Email body
@@ -49,7 +47,7 @@ After the sender domain is configured and verified, you can link these domains w
4947
## Next steps
5048

5149
- [Email domains and sender authentication for Azure Communication Services](./email-domain-and-sender-authentication.md)
52-
- [Create and manage an Email Communication Services resource in Azure Communication Services](../../quickstarts/email/create-email-communication-resource.md)
50+
- [Create and manage an email communication resource in Azure Communication Services](../../quickstarts/email/create-email-communication-resource.md)
5351
- [Connect a verified email domain in Azure Communication Services](../../quickstarts/email/connect-email-communication-resource.md)
5452

5553
The following topics might be interesting to you:

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

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

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

24-
### Azure email communication resource
24+
### Azure email communication resources
2525

26-
Azure Resource Manager for Email Communication Services is meant for email domain administration.
26+
Azure Resource Manager for email communication resources is meant for email domain administration.
2727

2828
| Area | JavaScript | .NET | Python | Java SE | iOS | Android | Other |
2929
| -------------- | ---------- | ---- | ------ | ---- | -------------- | -------------- | ------------------------------ |
@@ -44,7 +44,7 @@ This sandbox setup helps developers start building the application. Gradually, y
4444

4545
## Next steps
4646

47-
* [Create and manage an Email Communication Services resource in Azure Communication Services](../../quickstarts/email/create-email-communication-resource.md)
47+
* [Create and manage an email communication resource in Azure Communication Services](../../quickstarts/email/create-email-communication-resource.md)
4848
* [Connect a verified email domain in Azure Communication Services](../../quickstarts/email/connect-email-communication-resource.md)
4949

5050
The following topics might be interesting to you:

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,7 @@ When users are subscribed to multiple lists in your organization, it's ideal to
161161
* [Best practices for implementing DMARC](/microsoft-365/security/office-365-security/use-dmarc-to-validate-email?preserve-view=true&view=o365-worldwide#best-practices-for-implementing-dmarc-in-microsoft-365)
162162
* [Troubleshoot your DMARC implementation](/microsoft-365/security/office-365-security/use-dmarc-to-validate-email?preserve-view=true&view=o365-worldwide#troubleshooting-your-dmarc-implementation)
163163
* [Email domains and sender authentication for Azure Communication Services](./email-domain-and-sender-authentication.md)
164-
* [Create and manage an Email Communication Services resource in Azure Communication Services](../../quickstarts/email/create-email-communication-resource.md)
164+
* [Create and manage an email communication resource in Azure Communication Services](../../quickstarts/email/create-email-communication-resource.md)
165165
* [Connect a verified email domain in Azure Communication Services](../../quickstarts/email/connect-email-communication-resource.md)
166166

167167
The following topics might be interesting to you:

0 commit comments

Comments
 (0)