SMS_SEND
This activity will send an SMS to a mobile number using an e-mail-based service provided for the purpose by a third party SMS provider. Such services require you to hold an account with them (usually paid). Once you have an account, your application sends an e-mail to the provider in a specified format. The SMS_SEND activity uses an e-mail format used by www.streetdata.com.au and other providers in which the key features are:
- the telephone number for the receiver is specified left of the '@' sign in the e-mail address (for example, [email protected])
- the subject specifies the account holder's assigned user name and password
- the e-mail body contains the message text to be sent
To use this Activity you must have an SMTP mail server available and an SMS provider. If your SMS provider expects email in a format different to that generated by this Activity, then the activity processor for the activity may need to be modified to accommodate it.
Details for connecting to and using the SMS provider service and for the SMS message destination and content may be specified in an 2.3.7 SMS Configuration. Refer to the description of 2.3.7 SMS Configuration for additional information.
INPUT Parameters:
SMSCONFIGID : Optional
This parameter may contain the name of an SMS Configuration to be used to send the SMS message. This Configuration can be created and maintained using the SMS Configuration. If the specified SMS configuration is not found or not active, the Activity will return an error and processing will be abandoned. If the SMS configuration name is not provided then the default SMS configuration set in System Settings will be used.
SMSTONUM : Optional
This parameter may contain the SMS number to which the message is to be sent. If specified here, it overrides the value specified in the SMS configuration. If not specified here, then the SMS number must be specified in the SMS configuration.
SMSMSG : Optional
This parameter may contain the SMS message text to be sent. If specified here, it overrides the value specified in the SMS configuration. If not specified here, then the SMS message text must be specified in the SMS configuration. Most SMS providers restrict the SMS message length to a maximum number of characters, for example 160 characters. It is your responsibility to ensure the message text does not exceed the maximum imposed by the service you are using.
OUTPUT Parameters:
There are no output parameters.