Wait for SMS Activity
- Last UpdatedJul 01, 2024
- 5 minute read
Activity description:
The Wait for SMS Activity can be used to wait for a number of SMSs for a particular time period, both of which can be set in the activity's properties. It can store SMSs (completely or partially) into specified variables. Depending on different property settings the activity will give different outputs.
Activity Properties:
The Wait for SMS activity has to be configured by specifying appropriate values for the different properties in the Activity Properties area. The Activity Properties can be accessed by clicking on the Activity Properties tool in the tool bar or by selecting the appropriate option from the right click menu for the Wait for SMS activity. The Activity Properties are organized under the following groups of related properties. The properties under each group are described in this topic.

Name & Description
The properties in the Name & Description group have been described below. You can use these properties to specify the name and description for the activity.
Name - This property can be used to specify a name for the activity.
Property Type: Optional (This property needs to be set only if necessary.)
Description - This property specifies a brief description to be displayed for the activity.
Property Type: Optional (This property needs to be set only if necessary.)
Configuration
The properties in the Configuration group have been described below. You can use these properties to configure the functionality of the activity.
Filter Expression - This property is used to filter the incoming SMS. It will add an SMS filter. On execution, the SMTP Notification Engine will be notified about the newly added filter so that it will search for this pattern in the next SMS.
Property Type: Mandatory (This property must be set if the activity is to be assigned to any resource(s).)
Steps to set the Filter Expression property
-
To set the condition to filter the incoming SMS, click the button for the 'Filter Expression' property to open the property window.
-
In this window, build an expression to set the filter. Select an attribute from the first drop down list, then select the operator, type of value (Value, Variable, Content, XMLVariables), and the corresponding value for the property from the corresponding drop downs. Select "End" from the last drop down to complete the expression. If you are building a compound expression, you can select one of the logical operators to connect the different conditions that form the expression.
-
Add the condition to the expression by clicking Add. This will display the expression in the text area.
-
You can remove a condition already added to the expression by clicking Undo.
-
You can also clear an existing expression if necessary by clicking Clear. This is useful if you want to clear large expressions in the text area in order to build a new expression.
-
After building the expression, click Update to save it.
See Wait for SMS: Filter Expression for a detailed description of the Filter Expression property window.
Valid for SMSs - This property is used to specify the number of SMSs for which the activity should wait. It indicates that the activity should wait till the specified number of SMSs are received.
Property Type: Optional (This property needs to be set only if required.)
Escalation & Timeout
The properties in the Escalation & Timeout group have been described below. You can use these properties to specify escalation and timeout settings for the activity.
Timeout Warning - This property is used for setting the Timeout warning.
Property Type: Optional (This property needs to be set only if required.)
Timeout for Action - This property is used for setting timeouts for this activity. If specified, the activity will be timed out after the specified time span.
Property Type: Optional (This property needs to be set only if required.)
Output Values
The properties in the Output Values group have been described below. You can use these properties to specify the input values for the activity.
Set Variables And Contents from SMS - This property is used for assigning the SMS partly/fully to a variable or content.
Property Type: Optional (This property needs to be set only if required.)
Steps to set the Set Variables And Contents from SMS property
-
To set the filtered email can be to variables and contents, click the button for the 'Set Variables And Contents from Email' property to open the property window.
-
In this window, first select the variable from the Variable drop down.
-
Next specify the search criteria in the Search criteria field. You can either enter the regular expression directly or click on the Generate RegExp for Selected Row button to generate a regular expression.
-
If you click the Generate RegExp for Selected Row button it displays a set of fields and buttons at the bottom of the property window.
-
Specify the start string for the regular expression in the Start String field and Start and End delimiters in the corresponding text boxes of the Delimiters fields.
-
After specifying these values, click Generate to generate the regular expression.
-
Click Hide to hide these fields.
-
Specify where to search in by selecting an appropriate option from the Search in drop down. You can set the action to search in the entire email, the subject, and the attachments among other options.
-
Specify the name of a group to which the variable should belong in the Set variable in the named group field.
-
Click the New row tab to add the current search expression and display a blank row to add another expression.
-
If you need to remove any search expressions, you can select them and click Remove selected.
-
After specifying all the search parameters, click Update to save the new settings.
See Wait for SMS: Set Variables and Contents from SMS for a detailed description of the Set Variables And Contents from SMS property window.
Looping Behavior
The property in the Looping Behavior group has been described below. You can use this property to specify the looping behavior of the activity.
Loop through this action if output is - This property is used to specify the condition for looping the activity by selecting an activity output from the drop down.
Property Type: Optional (This property needs to be set only if necessary.)
Activity outputs:
The Wait for SMS Activity returns the following values -
Timeout Warning: Displayed when a warning for timeout is to be generated.
Email Received(Waiting): Displayed when an SMS matching the specified filter condition is received
Timeout: Displayed when the activity has timed out
Exception Behavior
Each activity has the Raise Error on Unhandled Linked Output property on click of which, it shows all the default configured mapped error outputs in red with their check boxes selected.
See Mapped Error Output for more details.