Электронная почта связи Azure
Соединитель для отправки электронной почты с помощью доменов, связанных со службами коммуникации Azure в подписке.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL | https://azure.microsoft.com/services/communication-services |
| Адрес электронной почты | acssolutions@microsoft.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://azure.microsoft.com/services/communication-services |
| Политика конфиденциальности | https://privacy.microsoft.com |
| Категории | Communication |
Электронная почта Служб коммуникации Azure — это новый примитив, который упрощает использование больших объемов транзакций, массовых и маркетинговых сообщений на платформе Служб коммуникации Azure и позволяет использовать варианты использования приложений и пользователей (A2P). Предложения электронной почты Служб коммуникации Azure помогут улучшить время на рынок с масштабируемыми, надежными возможностями электронной почты с помощью собственных доменов SMTP. Как и другие варианты обмена сообщениями, предложение электронной почты имеет преимущество только платить за то, что вы используете.
Предпосылки
Для продолжения вам потребуется следующее:
- План Microsoft Power Apps или Power Automate с пользовательским компонентом соединителя
- подписка Azure
- Ресурс электронной почты Служб коммуникации Azure с настроенным доменом
- Ресурс Служб коммуникации Azure, подключенный к домену электронной почты Azure
Получение учетных данных
Настройка ресурса Служб коммуникации Azure
Настройка ресурса электронной почты служб commuincation Services Azure
- Создание ресурса электронной почты
- Настройка домена
Подключение домена электронной почты к ресурсу служб коммуникации
Проверка подлинности строки подключения
- Вы можете создать новое подключение с помощью строки подключения к ресурсу Служб коммуникации Azure.
Начало работы с соединителем
После настройки ресурса электронной почты Служб коммуникации Azure и настройки домена перейдите к подготовленному домену и скопируйте MailFrom сообщение электронной почты. Это будет использоваться в качестве From сообщения электронной почты в действии Send email .
Известные проблемы и ограничения
Электронная почта Служб коммуникации Azure в настоящее время доступна в общедоступной предварительной версии. Предварительные версии API и пакеты SDK предоставляются без соглашения об уровне обслуживания и не рекомендуются для рабочих нагрузок рабочей среды. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены.
В настоящее время не поддерживает проверку подлинности субъекта-службы (приложение Microsoft Entra ID).
Поддерживаются только эти типы вложений электронной почты .
Распространенные ошибки и средства устранения неполадок
При присоединении неподдерживаемых вложений Send email действие завершится ошибкой как BadRequest. Обратитесь к этим типам вложений электронной почты.
Часто задаваемые вопросы
Где находится мой адрес электронной почты?
- Доставка электронной почты может занять до нескольких минут и в конечном итоге в почтовом ящике при использовании управляемых доменов Azure. Обязательно установите флажок нежелательной почты.
Как отправить сообщение электронной почты с вложениями?
- Для вложений электронной почты требуется как имя вложения, так и содержимое вложения. Некоторые службы размещения файлов, такие как OneDrive и SharePoint, имеют встроенную поддержку в Power Automate, и они имеют такие действия, как
Get file metadataполучение имени файла иGet file contentполучение содержимого файла.
- Для вложений электронной почты требуется как имя вложения, так и содержимое вложения. Некоторые службы размещения файлов, такие как OneDrive и SharePoint, имеют встроенную поддержку в Power Automate, и они имеют такие действия, как
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Строка подключения | securestring | Строка подключения служб коммуникации Azure. | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Отправка сообщения электронной почты |
Отправляет сообщение электронной почты одному или нескольким получателям. |
| Отправка электронной почты (предварительная версия) — НЕ РЕКОМЕНДУЕТСЯ [НЕ РЕКОМЕНДУЕТСЯ] |
Это действие устарело. Вместо этого используйте отправку электронной почты .
|
| Получение состояния сообщения электронной почты |
Возвращает состояние отправленного ранее сообщения электронной почты. |
| Получение состояния сообщения электронной почты (предварительная версия) — УСТАРЕЛО [УСТАРЕЛО] |
Это действие устарело. Вместо этого используйте состояние сообщения электронной почты .
|
Отправка сообщения электронной почты
Отправляет сообщение электронной почты одному или нескольким получателям.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
От
|
senderAddress | True | string |
Адрес электронной почты отправителя из проверенного домена.11 |
|
Важность
|
importance | string | ||
|
Электронная почта (в)
|
address | True | string |
Адрес электронной почты основного получателя. |
|
Электронная почта (CC)
|
address | True | string |
Адрес электронной почты дополнительного получателя. |
|
Электронная почта (BCC)
|
address | True | string |
Адрес электронной почты дополнительного получателя, который невидим в цепочке электронной почты. |
|
Тема
|
subject | True | string |
Укажите тему сообщения электронной почты. |
|
Тело
|
html | html |
Укажите текст сообщения электронной почты. |
|
|
Электронная почта (ответ на)
|
address | True | string |
Адрес электронной почты, в котором будут отправлены ответы получателей. |
|
Имя
|
name | True | string |
Имя вложения с расширением. |
|
Тип
|
contentType | True | string |
Тип файла вложения. |
|
Content
|
contentInBase64 | True | byte |
Содержимое вложения. |
|
имя
|
name | True | string |
Введите клавишу. |
|
value
|
value | True | string |
Введите значение. |
|
Отключение отслеживания взаимодействия пользователей
|
userEngagementTrackingDisabled | boolean |
Указывает, следует ли отключать отслеживание взаимодействия пользователей для этого запроса, если параметр отслеживания взаимодействия на уровне ресурсов уже включен в плоскости управления. |
Возвращаемое значение
Состояние длительной операции
- Тело
- EmailSendResult
Отправка электронной почты (предварительная версия) — НЕ РЕКОМЕНДУЕТСЯ [НЕ РЕКОМЕНДУЕТСЯ]
Это действие устарело. Вместо этого используйте отправку электронной почты .
Отправляет сообщение электронной почты одному или нескольким получателям — DEPRECATED
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
От
|
sender | True | string |
Адрес электронной почты отправителя из проверенного домена. |
|
Электронная почта (в)
|
True | string |
Адрес электронной почты основного получателя. |
|
|
Электронная почта (CC)
|
True | string |
Адрес электронной почты дополнительного получателя. |
|
|
Электронная почта (BCC)
|
True | string |
Адрес электронной почты дополнительного получателя, который невидим в цепочке электронной почты. |
|
|
Тема
|
subject | True | string |
Укажите тему сообщения электронной почты. |
|
Тело
|
html | html |
Укажите текст сообщения электронной почты. |
|
|
Электронная почта (ответ на)
|
True | string |
Адрес электронной почты, в котором будут отправлены ответы получателей. |
|
|
Имя
|
name | True | string |
Имя вложения с расширением. |
|
Content
|
contentBytesBase64 | True | byte |
Содержимое вложения. |
|
Важность
|
importance | string |
Тип важности для сообщения электронной почты. |
|
|
Отключение отслеживания взаимодействия пользователей
|
disableUserEngagementTracking | boolean |
Указывает, следует ли отключать отслеживание взаимодействия пользователей для этого запроса, если параметр отслеживания взаимодействия на уровне ресурсов уже включен в плоскости управления. |
Получение состояния сообщения электронной почты
Возвращает состояние отправленного ранее сообщения электронной почты.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор операции
|
operationId | True | string |
Идентификатор операции из предыдущего вызова для отправки сообщения электронной почты. |
Возвращаемое значение
Состояние длительной операции
- Тело
- EmailSendResult
Получение состояния сообщения электронной почты (предварительная версия) — УСТАРЕЛО [УСТАРЕЛО]
Это действие устарело. Вместо этого используйте состояние сообщения электронной почты .
Возвращает состояние отправленного ранее сообщения электронной почты — DEPRECATED
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор сообщения
|
messageId | True | string |
Идентификатор сообщения из предыдущего вызова для отправки сообщения электронной почты. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор сообщения
|
messageId | string | |
|
Состояние сообщения
|
status | string |
Определения
ОшибкаДеталь
Детали ошибки.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
код
|
code | string |
Код ошибки. |
|
сообщение
|
message | string |
Сообщение об ошибке. |
|
target
|
target | string |
Цель ошибки. |
|
details
|
details | array of ErrorDetail |
Сведения об ошибке. |
|
дополнительная информация
|
additionalInfo | array of ErrorAdditionalInfo |
Ошибка дополнительная информация. |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
type
|
type | string |
Тип дополнительной информации. |
|
info
|
info | object |
Дополнительная информация. |
РезультатОтправкиЭлектроннойПочты
Состояние длительной операции
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
id | string |
Уникальный идентификатор операции. Используйте UUID. |
|
статус
|
status | string |
Состояние операции. |
|
ошибка
|
error | ErrorDetail |
Детали ошибки. |