Make Call
Function: MAKE_CALL
The MAKE_CALL function is used to initiate a phone call from the test device to a specified target number. This function is essential for testing call connectivity, quality, and other call-related features on mobile devices.
The step dials through the handset's dialler (or the modem's call interface) and waits for the call to begin connecting. Progress is read from the device's own telephony state, not from what is drawn on screen.
Supported on: Android, iOS and MCM.
Parameters¶
| Parameter Name | Description | Example Values | Required | Default Value |
|---|---|---|---|---|
| B_NUMBER | The phone number to call. Pick a Mobile ID or enter a custom number. In an API payload this is 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 |
| TIMEOUT | The maximum time to wait for the call to be established before considering it a failure. Whole seconds, 0-3700. | Recommended 15 - 60 | Yes | |
| EXPECT | The expected result of the call attempt. It defines what constitutes a successful call. | 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).