A SMS Received event trigger executes when a SMS message is received by the cellular modem in the node.
For this trigger event type to execute, the cellular network provider plan must support SMS messaging and the modem signal strength must be strong enough to allow the reception of SMS messages.
Defining a SMS received event trigger
To define a SMS received event trigger, follow these steps:
- From the Workbench left pane, expand the node where you want to define the SMS received event trigger.
- Select the Project icon to display
the Projects window, right-click a
specific project tab to display its pop-up menu, and
then select New.
You also can select the New button at the bottom of the Projects window when a specific project tab has already been selected. - The new Trigger window
appears.
Name the trigger. The trigger name can be up to 64 characters and include letters, numbers, and the underscore character. Spaces are allowed. - From the Event tab, select the
Trigger Event Type down-arrow, expand
the Cellular Modem category, and then
select SMS received.
The Event tab becomes active with parameters that accommodate the SMS received event.
| Parameter | Description |
|---|---|
| Sending Number | Optional. Allows filtering messages
based on the originating SMS phone
number. The number must be begin with
the area code and contain no formatting
characters. For example:
9991231234. International numbers are not recognized. If a phone number is added to the Sending Number parameter, the trigger will execute only when a received SMS message originates from the specified phone number. If left blank, the trigger will execute when a received SMS message originates from any phone number. Note that the Sending Number parameter only accepts a single originating phone number. If the application logic calls for a trigger to execute for each received SMS message from multiple specific numbers, then a trigger must be created for each specific originating phone number. The alternative is to leave the Sending Number parameter blank, which will cause the trigger to execute when a received SMS message originates from any phone number. |
SMS received event type trigger event variables
The input event variables available to a SMS received event trigger are:
| Event variable | Data type | Description |
|---|---|---|
| Message | STRING | The content of the SMS message. |
| Message Source | STRING | The originating phone number that sent the SMS message. |
| Message Timestamp | TIMESTAMP | The date and time the SMS message was received. |