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 |
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.
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
Create an Azure Communication Services resource - Quickstart doc.
Purchase a phone number in this resource with the "Send and receive SMS" feature selected.
Register an Event Grid resource provider for the subscription the Azure Communication Services resource is contained in.
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.
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
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.
- 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.
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 |
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.
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 |
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.
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
When an SMS message is received |
When an Azure Communication Services 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 |