Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring an outbound SMS account

Updated on August 3, 2022

Configure the predefined outbound SMS accounts which Pega Customer Decision Hub uses to send out SMS messages, including messages related to actions. Optionally, you can also set up additional SMS accounts for action-related messages.

  1. In App Studio, click SettingsChannelsSMSOutbound.
  2. Click the Edit icon by the Default account to configure it.
  3. In the Setup tab, fill out the required connection details:
    • Host Address - The address of the SMS center host, for example,
    • Host Port - The port number of the SMS center host, for example, 1041.
    • User ID and Password - Authentication credentials for the SMS account.
    • Test Number - The number which is used to receive test messages for this account.
    • Sender's Number - The number which is displayed as the sending number for messages sent from this account.
  4. Optional: In the Maximum Connections field, enter the maximum number of connections available at the same time.
  5. Optional: Select Track delivery receipt to enable delivery receits. For more information, see Configuring SMS delivery receipts.
  6. Optional: Set Delivery mode to Asynchronous to send messages in bulk using the asynchronous option.
    Configure the following options:
    • Unacknowledged queue size - The maximum queue size for messages that were delivered to a consumer but not yet acknowledged.
    • Wait on rejection (seconds) - The interval to wait for the message to be rejected.
    • SMS messages per second - The number of messages to be sent out per second.
    • Acknowledgement timeout (milliseconds) - The interval before a message is considered unacknowledged.
  7. Optional: In the Account Availability section, specify delivery time frames for SMS messages related to actions.
    Select one of the following options:
    • Always Available - The account is always available to deliver messages.
    • Specify Range - The account only delivers messages during the specified time range. Specify the following value for the time range:
      • From - Start value for the time range, for example, 9.00 AM
      • To - End value for the time range, for example, 7.00 PM
      • Time Zone - Time zone for the start and end time values. By default, Pega Customer Decision Hub uses the time zone of the current user.
      Note: Delivery time frames do not apply to messages which are not related to actions, for example, work object-related notification.
  8. Optional: In the Advanced tab, configure advanced account settings, such as response timeout, character encoding, and reconnect options.
  9. Optional: In the Additional settings tab, specify the name and value for any additional SMPP configuration settings which are not available in the Setup and Advanced tabs.
  10. Click OK and then click Test to test your settings.
    The test message is sent to the Test Number specified in step 3.
  11. Optional: If you want SMS and Multi Treatments in actions to be sent from a non-default SMS account, click Add connection to add a new SMS account.
    Note: After configuring the new SMS account, select it as the delivery account the Send SMS and Send Multi shapes in the actions where you want to use the non-default SMS account for messaging.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us