SMS Send
Function: SMS_SEND
The SMS_SEND function is used to send an SMS message from the test device to a specified target number. This function is essential for testing SMS sending capabilities on mobile devices.
The step passes when the message left the device as sent or delivered rather than failed. On a handset you can pick several recipients; they are sent as one group message on most handsets.
Supported on: Android, iOS and MCM (one recipient on MCM).
Parameters¶
| Parameter Name | Description | Example Values | Required | Default Value |
|---|---|---|---|---|
| B_NUMBER | The phone number(s) to send the SMS to. Pick Mobile IDs or enter custom numbers (+, digits, * and #). In an API payload this is always a JSON array, for example ["+447700900123"]. |
Custom | Yes | |
| MSISDN_FORMAT | The format in which the number is dialled (see below). | E164, INTERNATIONAL, NATIONAL |
No | E164 |
| SMS_TEXT | The text content of the SMS message. | Hello, Test | Yes | |
| TIMEOUT | The maximum time to wait for the message to be sent. Whole seconds, 0-3700. | Recommended 15 - 60 | Yes | |
| EXPECT | The expected result of the SMS send attempt. It defines what constitutes a successful SMS send. | SUCCESS, FAIL |
Yes | SUCCESS |
MSISDN formats
E164:+followed by the country code and the number, for example+447700900123.INTERNATIONAL: the device's international dialling prefix (by default00), then the country code and the number.NATIONAL: the device's national format (by default0followed by the national number).