(This documentation pertains to TMS v1.3 or higher)

This document describes the different Rule Match Conditions which are currently available in TMS and how to use them.

Rule Match Conditions

Rule Match Conditions are used to set matching conditions for when a new text message is received. A rule may contain 1 or more match conditions. For the rule to perform actions, it must match ALL rule match conditions.

For example, if you have a rule which contains a rule match condition of Sender’s Name contains “Bob” and a rule match condition for Weekday is Friday, then only when you receive a text message on a Friday from Bob the rule’s actions will be performed.

Rule Match conditions are listed in the very first screen after the Rule Name is set. At that screen you will select one or more rule match conditions you’d like to setup for this specific rule. When you hit next, you will be given the chance to go through all rule match conditions one by one and setup any parameters necessary.

Here is a list of currently available Rule Match Conditions and how to use them:

Current Weekday(s):

·         Allows you to match messages based on certain weekday(s).

·         Example: To match only on the weekend, check Saturday and Sunday and leave the other weekdays unchecked.

Current Time of Day

·         Allows you to match messages based on the current time of day. This means when you receive a message between StartTime and EndTime the message will be matched.

·         Example: Set StartTime to 8am and EndTime to 6pm to only match messages received between 8 am and 6pm.

The Text Message Body

·         Matches based on the text in the incoming text message. You will be asked for what text to match and a match condition (ie: Equals or Contains). Regex matching is available for advanced users.

Sender’s Name or Number

·         Matches based on the received text message Sender’s name or phone number.

·         A form pops up to let you select a user from your address book and helps you automatically populate the form with the user’s phone number.

·         Note that you will rarely use the “Equals” match condition here because the match string is actually in the form “Name <Phone>” or could be different if you’re roaming, out of the country, etc. The recommended way to use this match condition is by picking a Sender from the list which will automatically set the form to use the “Contains” comparison type and the user’s phone number with no dashes or other characters.

Match All Messages

·         This will match every message no matter what. It only makes sense to use this match condition by itself, if you’d like to perform action(s) on every message received.

Sender’s Category

·         Match based on the received text message Sender’s Category (or Categories) in the address book. To set categories open the Address Book and look for the “Set Category” option.

·         Note that you may only select 1 category. If you’d like to match on multiple categories you should either create a new “parent” category and match on that instead, or create multiple rules for the different categories.

·         Note that you should always use the Contains comparison type here if you’d like to match a user who has multiple categories, as the Category string comes in the form “Category1; Category2; Category3”. So if you say Equals Category1 it will not match. The picker form does this for you and you should leave the populated fields as is to avoid unwanted behavior.