This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Managing SMS Notification Templates Using the Registry

Owned by Former user (Deleted)
Last updated: Jan 29, 2020
2 min read

WSO2 Identity Server supports multiple account verification channels for account recovery, user self-registration, and account verification (i.e.,email notifications and sms notifications). If you are using a WSO2 Identity Server 5.7.0 WUM updated pack or a later version of WSO2 IS, SMS notifications and templates are managed using the registry. Follow the steps given below to manage SMS notification templates using the registry.

To use this feature, apply the 5863 WUM update for WSO2 IS 5.7.0 using the WSO2 Update Manager (WUM).

To deploy a WUM update into production, you need to have a paid subscription. If you do not have a paid subscription, you can use this feature with the next version of WSO2 Identity Server when it is released. For more information on updating WSO2 Identity Server using WUM, see Getting Started with WUM in the WSO2 Administration Guide.

All configurations are case sensitive. Changing the case may break the functionality and cause errors.

  1. Log in to the Management Console and click Main> Registry> Browse.

  2. On the tree view tab, click system > config > identity.

  3. Click Add Collection, enter 'sms' as the Name, and then click Add.

  4. Click sms and then click Add collection. Enter 'accountconfirmation' as the Name. This will create another directory inside the sms directory.
  5. Click on Add Resource.
  6. Select 'Create Text Content' as the Method and enter en_us as the Name.

  7. Add the SMS notification template body. 

    Include the {{confirmation-code}} placeholder in the SMS template body.

  8. Click en_us resource and add the following properties depending on the flow you are using the template for. 

    FieldAccount confirmationAccount recovery
    displayaccountconfirmationaccountIdRecovery
    typeaccountconfirmationaccountIdRecovery
    localeen_USen_US

You have now successfully configured the SMS notification template for user self-registration.

If you have a custom notification handler, you have to improve SMS notification template selection via the registry. For more information, contact WSO2 Support.

Updating an SMS notification template using the registry

  1. Log in to the Management Console and click Main> Registry> Browse.

  2. On the tree view tab, click system > config > identity > sms > accountidrecovery. 

  3. Click en_us resource.
  4. Click Display as text to view the template or click Edit as text to edit the template.