Azure Communication Email
サブスクリプションの Azure Communication Services にリンクしているドメインを使用してメールを送信するコネクタ。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | マイクロソフト |
| [URL] | https://azure.microsoft.com/services/communication-services |
| メール | acssolutions@microsoft.com |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://azure.microsoft.com/services/communication-services |
| プライバシー ポリシー | https://privacy.microsoft.com |
| カテゴリ | 通信 |
Azure Communication Services メールは、Azure Communication Services プラットフォームで、大量のトランザクション、バルクおよびマーケティング電子メールを容易にし、Application-to-Person (A2P) のユース ケースを可能にする新しいプリミティブです。 Azure Communication Services の電子メール オファーが使用する、独自の SMTP ドメインを用いたスケーラブルで信頼性の高いメール機能により、市場投入までの時間を短縮することができます。 他の通信モダリティと同様に、メール サービスには、使用した分だけ支払うという利点があります。
前提条件
続行するには、次のものが必要です。
- カスタム コネクタ機能を備えた Microsoft Power Apps または Power Automate プラン
- Azure サブスクリプション
- ドメインが構成された Azure Communication Services のメール リソース
- Azure メール ドメインに接続された Azure Communication Services リソース
資格情報の入手方法
Azure Communication Services リソースの設定
Azure Communication Services メール リソースの設定
- メール リソースを作成する
- ドメインの構成
メール ドメインを Communication Services リソースに接続する
接続文字列の認証
- Azure Communication Services リソース接続文字列 を使用して新しい接続を作成できます。
コネクタの使用を開始する
Azure Communication Services メール リソースを設定してドメインを構成した後、プロビジョニングされたドメインに移動し、MailFrom メールをコピーします。 これは、Send email アクションの From メールとして使用されます。
既知の問題と制限事項
Azure Communication Services メールは現在パブリック プレビュー中です。 プレビュー API と SDK は、サービス レベル アグリーメントなしで提供されるため、運用ワークロードにはお勧めできません。 特定の機能がサポートされていないか、機能が制限されている可能性があります。
サービス プリンシパル (Microsoft Entra ID 申請) この際に認証を行います。
この メールの添付ファイルの種類 のみがサポートされています。
一般的なエラーと解決策
サポートされていない添付ファイルを取り付ける場合、Send email アクションは "BadRequest" として失敗します。 この メールの添付ファイルの種類 を参照してください。
よくあるご質問
メールが見当たりません。
- Azure マネージド ドメインを使用している場合、メールの送信には数分かかることがあり、迷惑メール ボックスに送信される場合があります。 必ず迷惑メール ボックスを確認してください。
添付ファイル付きのメールはどのように送信しますか。
- メールの添付ファイルには、添付ファイル名と添付ファイルの内容の両方が必要です。 OneDrive および SharePoint などのファイル ホスティング サービスには、Power Automate でのネイティブ サポート、ファイル名を取得するための
Get file metadataや、ファイルの内容を取得するためのGet file contentなどのアクションを含みます。
- メールの添付ファイルには、添付ファイル名と添付ファイルの内容の両方が必要です。 OneDrive および SharePoint などのファイル ホスティング サービスには、Power Automate でのネイティブ サポート、ファイル名を取得するための
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| 接続文字列 | securestring | Azure Communication Services の接続文字列。 | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| メール メッセージの状態を取得する |
以前に送信されたメール メッセージの状態を取得します。 |
| メール メッセージの状態を取得する (プレビュー) - 非推奨 [非推奨] |
このアクションは非推奨になりました。 代わりに、電子メール メッセージ状態の取得 を使用してください。
|
| メールを送信 |
1 人または複数の受信者にメール メッセージを送信します。 |
| 電子メールの送信 (プレビュー) - 非推奨 [非推奨] |
このアクションは非推奨になりました。 代わりに、電子メールの送信を使用してください。
|
メール メッセージの状態を取得する
以前に送信されたメール メッセージの状態を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
操作 ID
|
operationId | True | string |
メールの送信に使用する、前の呼び出しの操作 ID です。 |
戻り値
長時間実行されている操作の状態
- Body
- EmailSendResult
メール メッセージの状態を取得する (プレビュー) - 非推奨 [非推奨]
このアクションは非推奨になりました。 代わりに、電子メール メッセージ状態の取得 を使用してください。
以前に送信されたメール メッセージの状態を取得する - 非推奨
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
メッセージ ID
|
messageId | True | string |
メール送信に使用する前回の通話からのメッセージ ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ ID
|
messageId | string | |
|
メッセージの状態
|
status | string |
メールを送信
1 人または複数の受信者にメール メッセージを送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
送信者
|
senderAddress | True | string |
検証済みドメインからの送信者のメール アドレスです。11 |
|
重要度
|
importance | string | ||
|
電子メール (送信先)
|
address | True | string |
メインの受信者のメール アドレスです。 |
|
電子メール (CC)
|
address | True | string |
追加の受信者のメール アドレスです。 |
|
電子メール (BCC)
|
address | True | string |
メール チェーンに表示されない追加の受信者のメール アドレスです。 |
|
サブジェクト
|
subject | True | string |
メールの件名を指定する。 |
|
Body
|
html | html |
メールの本文を指定する。 |
|
|
電子メール (返信先)
|
address | True | string |
受信者による返信送信先のメール アドレスです。 |
|
件名
|
name | True | string |
拡張子付きの添付ファイル名。 |
|
タイプ
|
contentType | True | string |
添付ファイルの種類です。 |
|
コンテンツ
|
contentInBase64 | True | byte |
添付ファイルの内容。 |
|
名称
|
name | True | string |
キーを入力します。 |
|
価値
|
value | True | string |
値を入力します。 |
|
ユーザー エンゲージメント追跡を無効にする
|
userEngagementTrackingDisabled | boolean |
リソース レベルのユーザー エンゲージメント追跡の設定がコントロール プレーンですでに有効になっている場合に、この要求に対してユーザー エンゲージメント追跡を無効にする必要があるかどうかを示します。 |
戻り値
長時間実行されている操作の状態
- Body
- EmailSendResult
電子メールの送信 (プレビュー) - 非推奨 [非推奨]
このアクションは非推奨になりました。 代わりに、電子メールの送信を使用してください。
1 人以上の受信者にメール メッセージを送信する - 非推奨
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
送信者
|
sender | True | string |
確認済みドメインの送信者のメール アドレス。 |
|
電子メール (送信先)
|
True | string |
メインの受信者のメール アドレスです。 |
|
|
電子メール (CC)
|
True | string |
追加の受信者のメール アドレスです。 |
|
|
電子メール (BCC)
|
True | string |
メール チェーンに表示されない追加の受信者のメール アドレスです。 |
|
|
サブジェクト
|
subject | True | string |
メールの件名を指定する。 |
|
Body
|
html | html |
メールの本文を指定する。 |
|
|
電子メール (返信先)
|
True | string |
受信者による返信送信先のメール アドレスです。 |
|
|
件名
|
name | True | string |
拡張子付きの添付ファイル名。 |
|
コンテンツ
|
contentBytesBase64 | True | byte |
添付ファイルの内容。 |
|
重要度
|
importance | string |
メールの重要度。 |
|
|
ユーザー エンゲージメント追跡を無効にする
|
disableUserEngagementTracking | boolean |
リソース レベルのユーザー エンゲージメント追跡の設定がコントロール プレーンですでに有効になっている場合に、この要求に対してユーザー エンゲージメント追跡を無効にする必要があるかどうかを示します。 |
定義
ErrorDetail
エラーの詳細です。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
code
|
code | string |
エラー コード。 |
|
message
|
message | string |
エラー メッセージ。 |
|
ターゲット
|
target | string |
エラーの対象です。 |
|
details
|
details | array of ErrorDetail |
エラーの詳細です。 |
|
additionalInfo
|
additionalInfo | array of ErrorAdditionalInfo |
エラーの追加情報です。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報です。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
タイプ
|
type | string |
追加情報の種類です。 |
|
情報
|
info | object |
追加情報です。 |
EmailSendResult
長時間実行されている操作の状態
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
id
|
id | string |
操作の一意の ID。 UUID を使用します。 |
|
ステータス
|
status | string |
操作の状態です。 |
|
エラー
|
error | ErrorDetail |
エラーの詳細です。 |