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 で購入した電話番号

資格情報の入手方法

  1. Azure Communication Services リソース - クイックスタート ドキュメント を作成します。

  2. "SMS の送受信" 機能を選択して、このリソースで電話番号を購入します。

  3. Azure Communication Servicesリソースが含まれているサブスクリプション向けの Event Grid リソース プロバイダーを登録する 。

  4. コネクタ接続に使用できる Microsoft Entra ID ユーザーまたはサービス プリンシパルを作成します。

    • オプション 1: Microsoft Entra ID アカウントを使用した接続 - 新規ユーザーの追加
    • オプション2: サービスプリンシパルを使用した接続 (Microsoft Entra ID アプリケーション) 認証 - サービスプリンシパルを設定し、Azure CLI または Azure ポータル から登録アプリケーションを作成することもできます。 この資格情報はその後認証に使用されます。

  5. 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 リソースにアクセスします。 すべての地域 共有不可
既定 [非推奨] このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 すべての地域 共有不可

Microsoft Entra ID 統合

認証 ID: aadOauth

適用可能: すべての領域

ACS イベント リソースにアクセスするには、Microsoft Entra ID を使用します。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

サービス プリンシパル (Microsoft Entra ID アプリケーション) 認証

認証 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 メッセージを受信したとき。

SMS メッセージの受信時

操作 ID:
CreateSMSReceivedEventSubscription

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