Azure Communication Services SMS イベント (プレビュー)
サブスクリプションの Azure Communication Services リソースから SMS メッセージを受信するためのコネクタ。
このコネクタは、次の製品および地域で利用可能です:
サービス | クラス | 地域 |
---|---|---|
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 の SMS イベント コネクタを使用すると、Azure Communication Services の電話番号に送信される SMS メッセージを処理できます。
続行するには、次のものが必要です。
- カスタム コネクタ機能を備えた Microsoft Power Apps または Power Automate プラン
- 登録された Event Grid リソース プロバイダー付きの Azure サブスクリプション
- Azure Communication Services リソース
- SMS メッセージを受信するように設定されている、Azure Communication Services で購入した電話番号
Azure Communication Services リソース - クイックスタート ドキュメント を作成します。
"SMS の送受信" 機能を選択して、このリソースで電話番号を購入します。
Azure Communication Servicesリソースが含まれているサブスクリプション向けの Event Grid リソース プロバイダーを登録する 。
コネクタ接続に使用できる Microsoft Entra ID ユーザーまたはサービス プリンシパルを作成します。
- オプション 1: Microsoft Entra ID アカウントを使用した接続 - 新規ユーザーの追加
- オプション2: サービスプリンシパルを使用した接続 (Microsoft Entra ID アプリケーション) 認証 - サービスプリンシパルを設定し、Azure CLI または Azure ポータル から登録アプリケーションを作成することもできます。 この資格情報はその後認証に使用されます。
Microsoft Entra ID ユーザーまたはサービス プリンシパルに以下の権限が割り当てられていることを確認してください:
Microsoft.Communication/CommunicationServices/Read
Microsoft.Resources/subscriptions/resourceGroups/read
Microsoft.EventGrid/eventSubscriptions/write
Microsoft.EventGrid/eventSubscriptions/read
Microsoft.EventGrid/eventSubscriptions/delete
これは、カスタム ロールを作成するか、ユーザーを次の組み込みロールに割り当てることで実現できます。
閲覧者 - Azure Communication Services リソース レベルで
EventGrid EventSubscription 投稿者 - リソース グループ レベル
このコネクタには単一のトリガー SMS メッセージを受信したとき が含まれています。 デフォルトでは、購入した電話番号にメッセージが送信されたときに実行されますが、SMSメッセージの "To" と "From" の電話番号に基づいてのみ実行するように構成することもできます。
- "イベント サブスクリプション名" が設定されている場合、更新時にトリガーが一時的に無効化される - トリガーの作成時に "イベント サブスクリプション名" フィールドに値が割り当てられた場合、トリガーへの更新 (たとえば、"To" 電話番号の追加) は適用まで最大 10分かかる可能性があります。 この間、トリガーは機能しません。
- フローの前に接続が削除された場合、イベント サブスクリプションは削除されません。
このコネクタは、次の認証タイプをサポートしています:
Microsoft Entra ID 統合 | ACS イベント リソースにアクセスするには、Microsoft Entra ID を使用します。 | すべての地域 | 共有不可 |
サービス プリンシパル (Microsoft Entra ID アプリケーション) 認証 | Microsoft Entra ID 認証を使用して Azure Communication Service リソースにアクセスします。 | すべての地域 | 共有不可 |
既定 [非推奨] | このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 | すべての地域 | 共有不可 |
認証 ID: aadOauth
適用可能: すべての領域
ACS イベント リソースにアクセスするには、Microsoft Entra ID を使用します。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
認証 ID: aadOauthClientCredentials
適用可能: すべての領域
Microsoft Entra ID 認証を使用して Azure Communication Service リソースにアクセスします。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
名称 | タイプ | Description | Required |
---|---|---|---|
Tenant ID | string | Microsoft Entra ID アプリケーションのテナント ID。 | True |
Client ID | string | Microsoft Entra ID アプリケーションのクライアント (またはアプリケーション) ID。 | True |
Client Secret | securestring | Microsoft Entra ID アプリケーションのクライアント シークレット。 | True |
適用可能: すべての領域
このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
名前 | 呼び出し | 更新期間 |
---|---|---|
接続ごとの API 呼び出し | 100 | 60 秒 |
SMS メッセージの受信時 |
Azure Communication Services の SMS メッセージを受信したとき。 |
Azure Communication Services の SMS メッセージを受信したとき。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
サブスクリプション
|
subscriptionId | True | string |
Microsoft Azure サブスクリプションの一意識別子。 サブスクリプション IDは、各 Azure リソースの ID の一部を構成します。 |
Resource Group Name
|
resourceGroupName | True | string |
リソースを含むリソース グループの名前。 |
リソース名
|
resourceName | True | string |
Communication Services リソースの名。 |
電話番号へフィルター
|
toPhoneNumbers | array of string | ||
電話番号からフィルター
|
fromPhoneNumbers | array of string | ||
イベント サブスクリプション名
|
eventSubscriptionName | string |
新しいイベント サブスクリプションの名前。 |
|
includedEventTypes
|
includedEventTypes | True | array of string |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
|
array of object | ||
受信先
|
data.to | string | |
送信者
|
data.from | string | |
Message
|
data.message | string | |
受信したタイムスタンプ
|
data.receivedTimestamp | string | |
メッセージ ID
|
data.messageId | string |