Configuring Support for ACS SMS Acknowledgment

After configuring outgoing SMS via Azure Communication Services, you can set up the support of delivery receipts and incoming SMS for acknowledgment.

To enable SMS acknowledgment using ACS, complete the following tasks.

  • Configure Web API Service. The server running Web API Service must be configured to be accessible from the outside over HTTPS and set up by your IT department.

  • Create an Azure AD application and register it on the Azure portal. Learn more

  • Secure the webhook delivery with Azure AD User in the Azure Event Grid. Learn more

    Follow the instructions up to step 4 and run the scripts as mentioned in the document, using the details of the Azure AD application in the script variables as follows.

    Variable

    Value Source

    $webhookAppObjectId ="[REPLACE_WITH_YOUR_ID]"

    The application ID (Object ID) on your Azure app registration details page.

    $eventSubscriptionWriterUserPrincipalName ="[REPLACE_WITH_USER_PRINCIPAL_NAME_OF_THE_USER_WHO_WILL_CREATE_THE_SUBSCRIPTION].

    Azure user principal name—usually the email used to sign in Azure AD. Learn more
    You must have the Azure AD Application Administrator role or be an owner of the service principal of Webhook app in Azure AD to execute the script. You will also incur charges for storage account subscription and other services that you use. Refer to the pricing calculator to view or calculate approximate different pricing details.

    Once the script successfully completes, we can create an event grid subscription.

  • Configure the Azure Communications plugin in the Web API configuration files. Learn more

  • Enable logging SMS status information in Workbench.

    1. Open Workbench and in Project Explorer, expand your project > Alarms and Notifications > Alert Notifications > ACS Configurations and double-click the default ACS configuration to display the settings.

    2. On the General Settings tab, select the Enable SMS delivery receipts checkbox, and then click Apply.

  • Learn more about the expected reply format for acknowledging alert SMS notifications.