Skip to main content

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

Configuring an inbound SMS account

Updated on August 4, 2022

Configure an inbound SMS account which Pega Customer Decision Hub uses to listen for Customer responses to actions, and then specify how to process inbound SMS messages that are received by this inbound SMS account.

Pega Customer Decision Hub

When the inbound SMS account receives a message, Pega Customer Decision Hub checks the sender's phone number against the Customer table to find the Customer who sent the message. If no matching Customer is found, the message is treated as an error and moved to the UnhandledInboundSMS workbasket for further processing.

You can configure the inbound SMS account to parse the SMS text to determine the response, and then associate each response with a different action. In a simpler scenario, you can associate all responses to a particular account with a single action.

  1. In App Studio, click SettingsChannelsSMSInbound.
  2. Click Add connection.
  3. In the Connection Setup tab, fill out the required connection details:
    • Account name - A unique name for the inbound SMS account, for example, InboundSMSMain. The name must contain only letters and numbers.
    • Host address - The address of the SMS center host, for example,
    • Host port - The port number of the SMS center host, for example, 1041.
    • Inbox address - The address of the SMS inbox on which Pega Customer Decision Hub should listen for responses.
    • IP address - The IP address of the SMS center host.
    • User ID and Password - Authentication credentials for the SMS account.
  4. Optional: In the Additional settings tab, specify the name and value for any additional SMPP configuration settings which are not available in the Connection Setup tab.
  5. In the Response behaviors tab, specify how the application should process inbound SMS messages.
    1. Optional: Specify what type of messages this inbound SMS account will receive.
      The following options are available:
      • Messages and delivery receipts - The SMS account can receive incoming messages, as well as delivery receipts for SMS messages which Pega Customer Decision Hub sends to Customers.
      • Delivery receipts only - The SMS account can receive only delivery receipts.
      For more information, see Configuring SMS delivery receipts.
    2. Select how Pega Customer Decision Hub should match received messages to responses:
      • One response - Select this option to assign the same action and response value for all SMS messages received on this account.
      • Decision table - Select this option to select one or more decision tables which associate the received message with a positive or negative action response. Each result from the decision table can be associated with the same action or with different individual actions.
    3. Configure the necessary settings for matching received messages to responses.
      • If you selected the One response option, in the Responses for inbound messages section, select an action and a response. Depending on the selected response, all incoming messages are treated as either acceptance or rejection for the selected action.
      • If you selected the Decision table option, in the Manage decision tables section, configure how the incoming messages should be matched to actions, and then select the decision table for parsing the response. For more information, see Using decision tables to manage SMS action responses.
    4. Specify how Pega Customer Decision Hub should process responses to actions which are not active for a given Customer:
      • Push it to a workbasket – Select this option to prevent Customers from responding to actions which are not active for them. Responses to inactive actions are treated as an error and moved to the UnhandledInboundSMS workbasket for further processing. You can access this workbasket in the Case Manager portal.
      • Start the action for the customer – Select this option to initiate a new action for the Customer if they respond to an action which is not active for them.
  6. Click OK.
  7. Toggle the control in the Running column to start listening for incoming messages.
    The Connection status column indicates the current status of the account.

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