Utility Routines

*TOOLS/SMS

Send Short Text Message

Invocation

CALL "*tools/sms;send", sms_service_name$, account_info$, to$, message$

Where:

sms_service_name$

SMS service being used (case insensitive). Supported SMS service names are "smsmatrix", "eztexting", "grouptexting", "nexmo", "twilio", and "smsbroadcast".

(Support for "smsbroadcast" was added in PxPlus 2020.)
(Support for case insensitive SMS service name was added in PxPlus 2022.)

account_info$

A semi-colon separated list of account information required by the SMS service being used. The information required by each service is indicated below.

SMS Service	Required Information
smsmatrix	"username;password"
eztexting	"username;password"
grouptexting	"username;password"
nexmo	"api_key;api_secret;nexmo_phone_number"
twilio	"account_sid;auth_token;twilio_phone_number"
smsbroadcast	"username;password"

(Support for "smsbroadcast" was added in PxPlus 2020.)

to$

Phone number(s) or group(s) to which the text message will be sent. Use a comma to separate multiple items.

Phone numbers must be in the format of 15551234567 with the exception of the two SMS services "eztexting" and "grouptexting" where phone numbers must exclude the beginning country code (i.e. 5551234567).

Groups are only supported by the following SMS services: "smsmatrix", "eztexting" and "grouptexting". To use groups, you must first define the groups through the SMS service website.

message$

Text message that you want to send via the SMS service.

Description

This utility allows you to send short text messages via SMS (Short Message Services) to a list of phone numbers (i.e. mobile devices), as well as to a list of groups that you can define in your SMS service account.

Before you can send text messages using this utility, you must first set up an account with any one of the following supported SMS services:

	www.smsmatrix.com
	www.eztexting.com
	www.grouptexting.com
	www.nexmo.com
	www.twilio.com
	www.smsbroadcast.com.au

Note:
These SMS services may be subject to changes or updates at any time, which may impact the integration to these services.

(The SMS utility was added in PxPlus 2016.)

Utility Routines

Invocation

Description

Note: These SMS services may be subject to changes or updates at any time, which may impact the integration to these services.

Note:
These SMS services may be subject to changes or updates at any time, which may impact the integration to these services.