Skip to content

Commit c40a13c

Browse files
authored
Merge pull request #271791 from ShawnJackson/seven-azure-communication-services-email-articles
[AQ] edit pass: Seven Azure Communication Services email articles
2 parents e2c5acd + e7aeded commit c40a13c

File tree

7 files changed

+323
-298
lines changed

7 files changed

+323
-298
lines changed
Lines changed: 39 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Allowed attachment types for sending email
3-
titleSuffix: An Azure Communication Services concept document
4-
description: Learn about how validation for attachment MIME types works for Email Communication Services.
2+
title: Allowed attachment types for sending email in Azure Communication Services
3+
titleSuffix: An Azure Communication Services concept article
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
@@ -11,23 +11,23 @@ ms.topic: conceptual
1111
ms.service: azure-communication-services
1212
---
1313

14-
# Allowed attachment types for sending email in Azure Communication Services Email
14+
# Allowed attachment types for sending email in Azure Communication Services
1515

16-
The [Send Email operation](../../quickstarts/email/send-email.md) allows the option for the sender to add attachments to an outgoing email. Along with the content itself, the sender must include the file attachment type using the MIME standard when making a request with an attachment. Many common file types are accepted, such as Word documents, Excel spreadsheets, many image and video formats, contacts, and calendar invites.
16+
The [SendMail operation](../../quickstarts/email/send-email.md) allows the option for the sender to add attachments to an outgoing email. Along with the content itself, the sender must include the file attachment type by using the Multipurpose Internet Mail Extensions (MIME) standard when making a request with an attachment. Many common file types are accepted, such as Word documents, Excel spreadsheets, image and video formats, contacts, and calendar invites.
1717

1818
## What is a MIME type?
1919

20-
MIME (Multipurpose Internet Mail Extensions) types are a way of identifying the type of data that is being sent over the internet. When users send email requests with Azure Communication Services Email, they can specify the MIME type of the email content, which allows the recipient's email client to properly display and interpret the message. If an email message includes an attachment, the MIME type would be 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

22-
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 being used. This information helps to ensure that the email message is delivered correctly and that the recipient can access the content as intended. In addition, using MIME types can also help to improve the security of email communications, as they can be used to indicate whether an email message includes executable content or other potentially harmful elements.
22+
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-
To sum up, MIME types are a critical component of email communication, and by using them with Azure Communication Services Email, 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

28-
Here's a table listing some of the most common supported file extensions and their corresponding MIME types for email attachments using Azure Communication Services Email:
28+
This table lists common supported file extensions and their corresponding MIME types for email attachments in Azure Communication Services:
2929

30-
| File Extension | Description | MIME Type |
30+
| File extension | Description | MIME type |
3131
| --- | --- | --- |
3232
| .3gp | 3GPP multimedia file | `video/3gpp` |
3333
| .3g2 | 3GPP2 multimedia file | `video/3gpp2` |
@@ -40,9 +40,9 @@ Here's a table listing some of the most common supported file extensions and the
4040
| .docm | Microsoft Word macro-enabled document | `application/vnd.ms-word.document.macroEnabled.12` |
4141
| .docx | Microsoft Word document (2007 or later) | `application/vnd.openxmlformats-officedocument.wordprocessingml.document` |
4242
| .eot | Embedded OpenType font | `application/vnd.ms-fontobject` |
43-
| .epub | EPUB ebook file | `application/epub+zip` |
43+
| .epub | EPUB e-book file | `application/epub+zip` |
4444
| .gif | GIF image | `image/gif` |
45-
| .gz | Gzip compressed file | `application/gzip` |
45+
| .gz | GZIP compressed file | `application/gzip` |
4646
| .ico | Icon file | `image/vnd.microsoft.icon` |
4747
| .ics | iCalendar file | `text/calendar` |
4848
| .jpg, .jpeg | JPEG image | `image/jpeg` |
@@ -59,7 +59,7 @@ Here's a table listing some of the most common supported file extensions and the
5959
| .otf | OpenType font | `font/otf` |
6060
| .pdf | PDF document | `application/pdf` |
6161
| .png | PNG image | `image/png` |
62-
| .ppsm | PowerPoint slideshow (macro-enabled) | `application/vnd.ms-powerpoint.slideshow.macroEnabled.12` |
62+
| .ppsm | PowerPoint macro-enabled slideshow | `application/vnd.ms-powerpoint.slideshow.macroEnabled.12` |
6363
| .ppsx | PowerPoint slideshow | `application/vnd.openxmlformats-officedocument.presentationml.slideshow` |
6464
| .ppt | PowerPoint presentation (97-2003) | `application/vnd.ms-powerpoint` |
6565
| .pptm | PowerPoint macro-enabled presentation | `application/vnd.ms-powerpoint.presentation.macroEnabled.12` |
@@ -71,44 +71,43 @@ Here's a table listing some of the most common supported file extensions and the
7171
| .svg | Scalable Vector Graphics image | `image/svg+xml` |
7272
| .tar | Tar archive file | `application/x-tar` |
7373
| .tif, .tiff | Tagged Image File Format | `image/tiff` |
74-
| .ttf | TrueType Font | `font/ttf` |
75-
| .txt | Text Document | `text/plain` |
76-
| .vsd | Microsoft Visio Drawing | `application/vnd.visio` |
74+
| .ttf | TrueType font | `font/ttf` |
75+
| .txt | Text document | `text/plain` |
76+
| .vsd | Microsoft Visio drawing | `application/vnd.visio` |
7777
| .wav | Waveform Audio File Format | `audio/wav` |
78-
| .weba | WebM Audio File | `audio/webm` |
79-
| .webm | WebM Video File | `video/webm` |
80-
| .webp | WebP Image File | `image/webp` |
81-
| .wma | Windows Media Audio File | `audio/x-ms-wma` |
82-
| .wmv | Windows Media Video File | `video/x-ms-wmv` |
78+
| .weba | WebM audio file | `audio/webm` |
79+
| .webm | WebM video file | `video/webm` |
80+
| .webp | WebP image file | `image/webp` |
81+
| .wma | Windows Media Audio file | `audio/x-ms-wma` |
82+
| .wmv | Windows Media Video file | `video/x-ms-wmv` |
8383
| .woff | Web Open Font Format | `font/woff` |
8484
| .woff2 | Web Open Font Format 2.0 | `font/woff2` |
85-
| .xls | Microsoft Excel Spreadsheet (97-2003) | `application/vnd.ms-excel` |
86-
| .xlsb | Microsoft Excel Binary Spreadsheet | `application/vnd.ms-excel.sheet.binary.macroEnabled.12` |
87-
| .xlsm | Microsoft Excel Macro-Enabled Spreadsheet | `application/vnd.ms-excel.sheet.macroEnabled.12` |
88-
| .xlsx | Microsoft Excel Spreadsheet (OpenXML) | `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` |
89-
| .xml | Extensible Markup Language File | `application/xml`, `text/xml` |
90-
| .zip | ZIP Archive | `application/zip` |
85+
| .xls | Microsoft Excel spreadsheet (97-2003) | `application/vnd.ms-excel` |
86+
| .xlsb | Microsoft Excel binary spreadsheet | `application/vnd.ms-excel.sheet.binary.macroEnabled.12` |
87+
| .xlsm | Microsoft Excel macro-enabled spreadsheet | `application/vnd.ms-excel.sheet.macroEnabled.12` |
88+
| .xlsx | Microsoft Excel spreadsheet (Open XML) | `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` |
89+
| .xml | Extensible Markup Language file | `application/xml`, `text/xml` |
90+
| .zip | ZIP archive | `application/zip` |
9191

92-
There are many other file extensions and MIME types that can be used for email attachments. However, this list includes accepted types for sending attachments in our SendMail operation. Additionally, different email clients and servers may have different limitations or restrictions on file size and types that could result in the failure of email delivery. Ensure that the recipient can accept the email attachment or refer to the documentation for the recipient's email providers.
92+
There are many other file extensions and MIME types that you can use for email attachments. However, this list includes accepted types for sending attachments in the SendMail operation.
93+
94+
Some email clients and servers might have limitations or restrictions on file size and types that could result in the failure of email delivery. Ensure that the recipient can accept the email attachment, or refer to the documentation for the recipient's email provider.
9395

9496
## Additional information
9597

96-
The Internet Assigned Numbers Authority (IANA) is a department of the Internet Corporation for Assigned Names and Numbers (ICANN) responsible for the global coordination of various Internet protocols and resources, including the management and registration of MIME types.
98+
The Internet Assigned Numbers Authority (IANA) is a department of the Internet Corporation for Assigned Names and Numbers (ICANN). IANA is responsible for the global coordination of various internet protocols and resources, including the management and registration of MIME types.
9799

98-
The IANA maintains a registry of standardized MIME types, which includes a unique identifier for each MIME type, a short description of its purpose, and the associated file extensions. For the most up-to-date information regarding MIME types, including the definitive list of media types, it's recommended to visit the [IANA Website](https://www.iana.org/assignments/media-types/media-types.xhtml) directly.
100+
IANA maintains a registry of standardized MIME types. The registry includes a unique identifier for each MIME type, a short description of its purpose, and the associated file extensions. For the most up-to-date information about MIME types, including the definitive list of media types, go to the [IANA website](https://www.iana.org/assignments/media-types/media-types.xhtml).
99101

100102
## Next steps
101103

102-
* [What is Email Communication Communication Service](./prepare-email-communication-resource.md)
103-
104+
* [Prepare an email communication resource for Azure Communication Services](./prepare-email-communication-resource.md)
104105
* [Email domains and sender authentication for Azure Communication Services](./email-domain-and-sender-authentication.md)
106+
* [Send email by using Azure Communication Services](../../quickstarts/email/send-email.md)
107+
* [Connect a verified email domain in Azure Communication Services](../../quickstarts/email/connect-email-communication-resource.md)
105108

106-
* [Get started with sending email using Email Communication Service in Azure Communication Service](../../quickstarts/email/send-email.md)
107-
108-
* [Get started by connecting Email Communication Service with a Azure Communication Service resource](../../quickstarts/email/connect-email-communication-resource.md)
109-
110-
The following documents may be interesting to you:
109+
The following documents might be interesting to you:
111110

112-
- Familiarize yourself with the [Email client library](../email/sdk-features.md)
113-
- How to send emails with custom verified domains? [Add custom domains](../../quickstarts/email/add-custom-verified-domains.md)
114-
- How to send emails with Azure Managed Domains? [Add Azure Managed domains](../../quickstarts/email/add-azure-managed-domains.md)
111+
* Familiarize yourself with the [email client library](../email/sdk-features.md).
112+
* Learn how to send emails with [custom verified domains](../../quickstarts/email/add-custom-verified-domains.md).
113+
* Learn how to send emails with [Azure-managed domains](../../quickstarts/email/add-azure-managed-domains.md).

0 commit comments

Comments
 (0)