Send SMS

The Send SMS action node sends a custom text message to a given recipient via SMS.

An example setup of Send SMS is showcased in our Showroom! You may view a demo, as well as access the setup in Appfarm Create. If you do not have access, you may register here.

Each Appfarm solution has settings for Daily and Monthly SMS limits, meaning an upper limit on the number of SMSs sent daily and monthly. When this occurs, the Send SMS action node will throw a DailyQuotaExceededException or MonthlyQuotaExceededException. Read more on exception handling and error codes here. By default, the limit is low (20 per day, 100 per month). You may increase the limit by contacting Appfarm.

Usage

Appfarm uses GatewayAPI to deliver SMS messages.

The sending of SMS messages is subject to Appfarm's SMS usage policy. Sent messages are charged according to the price schedule laid out in your customer agreement. The total number of SMS messages sent from a solution is available under Resource Usage Overview on the Dashboard.

Validation

Appfarm does not validate the recipient's number before attempting to send the message. It is your responsibility to verify that the number is in the correct format. The number should include the country code and adhere to the MSISDN format.

Settings

Sender

Set the sender's name. This value can be up to 11 characters long.

We recommend using the name of your business or service. If no value is set, the short name of the solution will be used.

  • Using human names or phone numbers is not allowed

  • Leading or trailing whitespace will be stripped

  • Multiple whitespace characters within text will be replaced with a single space

  • If the provided name is longer than 11 characters, it will be trimmed

  • The string must otherwise adhere to the regex ^[a-zA-Z0-9_\-øæåÆØÅ!]+( [a-zA-Z0-9_\-øæåÆØÅ!]+)*$ (all Nordic characters, numbers, -, _ and !)

Some countries have local restrictions on Sender for SMSs not originating from a personal phone number, which is the case when using Send SMS from Appfarm. Singapore (+65) has introduced such a restriction, and we are working on a solution to this.

Message

Set the message to be sent. The message can be a static text string, a property value from a data binding, or the return value of a function.

You can send a message of any length, but messages of more than 160 characters will be split into separate messages of 153 characters each.

All characters included in the GSM 03.38 standard are supported. If you use any character outside of this range, such as emojis or other non-Western characters, the message will be automatically transcoded to ensure proper delivery. This will take up significantly more of the character limit and potentially increase delivery costs.

If you include a URL in the message body, first generate a shortlink with the Create Shortlink action node. This uses Appfarm's link shortener service, af.link. Links to other domains in the message body will, in some cases, be blocked by the SMS service provider.

To check the length of your message, you may use tools such as the SMS Length Calculator.

Broadcast

Check this box to send to multiple recipients at once. Selecting Broadcast enables further options in order to select the recipients.

Single Recipient

Set the recipient's phone number. The value must be a string. It can be a static text string, a property value from a data binding, or the return value of a function.

The country code (e.g., 47) must be prefixed to the number, but a leading + is not required.

Recipient Data Source

Visible only if Broadcast is checked.

Select the data source that contains the recipients you wish to send the message to.

Selection

Visible only if Broadcast is checked.

Select specific objects to use or apply filters to the data source.

Phone Number Field

Visible only if Broadcast is checked.

Select the field from the data source that contains the recipient's phone number. The value must be a string. The country code (e.g., 47) must be prefixed to the number, but a leading + is not required.

Tags

Add one or more tags. Tags are useful for later filtering SMS logs, particularly if you are using Send SMS for several different use cases in the same solution.

Last updated