Share via


Azure Communication Services SMS Events (Preview)

Connector to receive SMS messages from the Azure Communication Services resources in your subscription.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Microsoft
URL https://azure.microsoft.com/services/communication-services
Email acssolutions@microsoft.com
Connector Metadata
Publisher Microsoft
Website https://azure.microsoft.com/services/communication-services
Privacy policy https://privacy.microsoft.com
Categories Communication

The Azure Communication Services SMS Events connector enables the processing of SMS messages sent to Azure Communication Services phone numbers.

Prerequisites

You will need the following to proceed:

  • A Microsoft Power Apps or Power Automate plan with custom connector feature
  • An Azure subscription with the Event Grid resource provider registered
  • An Azure Communication Services resource
  • An Azure Communication Services purchased phone number that is set up to receive SMS messages

How to get credentials

  1. Create an Azure Communication Services resource - Quickstart doc.

  2. Purchase a phone number in this resource with the "Send and receive SMS" feature selected.

  3. Register an Event Grid resource provider for the subscription the Azure Communication Services resource is contained in.

  4. Create an Microsoft Entra ID user or Service Principal that can be used for the connector connection.

    • Option 1: Connection using Microsoft Entra ID account - Add a new user
    • Option 2: Connection using Service Principal (Microsoft Entra ID application) Authentication - You can also set up a service principal, create a registered application from the Azure CLI or through the Azure portal. The credentials can then be used to authenticate.
  5. Ensure the Microsoft Entra ID user or service principal has the following permissions assigned to them:

    • Microsoft.Communication/CommunicationServices/Read

    • Microsoft.Resources/subscriptions/resourceGroups/read

    • Microsoft.EventGrid/eventSubscriptions/write

    • Microsoft.EventGrid/eventSubscriptions/read

    • Microsoft.EventGrid/eventSubscriptions/delete

      This can be achieved by creating a custom role or assigning the user to the following built-in roles:

    • Reader - At the Azure Communication Services resource level

    • EventGrid EventSubscription Contributor - At the resource group level

Get started with your connector

This connector contains a single trigger When an SMS message is received. By default it will run when a message is sent to any of your purchased phone numbers, but it can also be configured to only run based on the "To" and "From" phone numbers of the SMS message.

Known issues and limitations

  • Trigger temporarily disabled on update if "Event Subscription Name" set - If a value was assigned to the "Event Subscription Name" field when creating the trigger, any updates to the trigger (for example, adding a "To" phone number) can take up to 10 minutes to be applied. During this time the trigger will not function.
  • Event Subscription not deleted if Connection deleted before Flow.

Creating a connection

The connector supports the following authentication types:

Microsoft Entra ID Integrated Use Microsoft Entra ID to access ACS event resources. All regions Not shareable
Service principal (Microsoft Entra ID application) Authentication Use Microsoft Entra ID Authentication to access your Azure Communication Service resource. All regions Not shareable
Default [DEPRECATED] This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility. All regions Not shareable

Microsoft Entra ID Integrated

Auth ID: aadOauth

Applicable: All regions

Use Microsoft Entra ID to access ACS event resources.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Service principal (Microsoft Entra ID application) Authentication

Auth ID: aadOauthClientCredentials

Applicable: All regions

Use Microsoft Entra ID Authentication to access your Azure Communication Service resource.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Tenant ID string Tenant ID of your Microsoft Entra ID application. True
Client ID string Client (or Application) ID of your Microsoft Entra ID application. True
Client Secret securestring Client secret of your Microsoft Entra ID application. True

Default [DEPRECATED]

Applicable: All regions

This option is only for older connections without an explicit authentication type, and is only provided for backward compatibility.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Triggers

When an SMS message is received

When an Azure Communication Services SMS message is received.

When an SMS message is received

When an Azure Communication Services SMS message is received.

Parameters

Name Key Required Type Description
Subscription
subscriptionId True string

The unique identifier for the Microsoft Azure subscription. The subscription ID forms part of the ID for every Azure resource.

Resource Group Name
resourceGroupName True string

The name of the resource group containing your resource.

Resource Name
resourceName True string

The name of the Communication Services resource.

Filter By To Phone Number
toPhoneNumbers array of string
Filter By From Phone Number
fromPhoneNumbers array of string
Event Subscription Name
eventSubscriptionName string

The name for the new event subscription.

includedEventTypes
includedEventTypes True array of string

Returns

Name Path Type Description
array of object
To
data.to string
From
data.from string
Message
data.message string
Received Timestamp
data.receivedTimestamp string
Message ID
data.messageId string