orchardcore-sms-azure

Orchard Core Azure Communication Services SMS

OrchardCore.Sms.Azure adds Azure Communication Services as a provider for the base OrchardCore.Sms module. It supplies tenant settings and a configuration-backed default provider. Use the base ISmsService from application code so another provider can be selected later without rewriting the sending service.

Guidelines

• Enable OrchardCore.Sms before OrchardCore.Sms.Azure.
• Select a configured and enabled SMS provider before attempting delivery.
• Configure an ACS connection string and a phone number capable of sending SMS.
• AzureSmsProvider is the tenant-configured provider; DefaultAzureSmsProvider reads host configuration.
• Keep ACS connection strings in secure configuration, never in client-side code.
• AzureSmsOptions.ConfigurationExists() requires both PhoneNumber and ConnectionString.
• Use E.164 recipient phone numbers and validate them before sending.
• Test with authorized destination numbers where the Azure account requires it.
• All recipe JSON uses the root { "steps": [...] } format.

Enable Azure SMS

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.Sms",
        "OrchardCore.Sms.Azure"
      ],
      "disable": []
    }
  ]
}

The Azure startup calls AddAzureSmsProvider(), registers AzureSmsOptionsConfiguration, provider options configuration, and the Azure settings display driver.

Configure Per Tenant

Navigate to Settings → Communication → SMS and configure Azure Communication Services. AzureSmsSettings contains:

Property	Description
IsEnabled	Enables the Azure provider for the tenant.
ConnectionString	ACS connection string.
PhoneNumber	ACS sending number in E.164 format.

After saving, select Azure in the SMS providers UI. The provider options configuration determines which tenant providers are available; merely enabling the feature does not select it.

Configure the Default Azure Provider