Call Forwarding
Function: CALL_FORWARDING
The CALL_FORWARDING function registers, activates, deactivates, deletes or queries call forwarding for a chosen condition. It dials the carrier's service (USSD) code and reads the carrier's reply on screen. This function is essential for testing call forwarding features.
Supported on: Android, except Google Pixel.
Any forwarding the step sets is cancelled automatically when the test case ends, so the device is not left forwarding calls.
Parameters¶
| Parameter Name | Description | Example Values | Required | Default Value |
|---|---|---|---|---|
| CF_TYPE | The type of call forwarding. | CF_Unconditional, CF_Busy, CF_Waiting, CF_NoReply, CF_NotReachable |
Yes | CF_Unconditional |
| CF_ACTION | The action to perform for call forwarding. CF_Waiting accepts only CF_ACT, CF_DEACT and CF_READ. |
CF_READ, CF_REG, CF_ACT, CF_DEACT, CF_DEL |
Yes | CF_READ |
| B_NUMBER | The number to forward calls to. The step editor shows it only when CF_ACTION is CF_REG, and CF_REG cannot be saved without it. In an API payload the key is always required; it is a JSON array ([] when not registering). |
Custom | Yes | |
| EXPECT | The expected result of the call forwarding attempt. It defines what constitutes a successful call forwarding. | SUCCESS, FAIL |
Yes | SUCCESS |
The step editor pre-selects CF_READ. In an API payload CF_ACTION must be present: a step without it is rejected with 400 ("Missing required parameters"). The CF_REG that GET /api/v2/functionparams lists as its default is not filled in for you.