Welcome to the Cyara Knowledge Center

Using Cyara Velocity, you can create Voice Test Cases that can invoke other channel Test Cases (such as SMS or Web) and wait for the results. This system allows you to test scenarios that span across channels, for example an IVR requests the caller to enter a one-time PIN that is sent to them via SMS.

In this scenario, an Inbound voice test case would be used to test the customer calling into and progressing through the IVR prompts. The same voice Test Case can then invoke a SMS Test Case to receive the one-time PIN and pass this info to the Voice Test Case for validation.

In the above example, the Inbound Voice Test Case can be thought of as the "master" test case. It will use Cyara Service Steps to control when other channel (in this case SMS) Test Cases are executed. As with a basic Voice Test Case, this inbound Test Case will have normal Expect to Hear and Reply With steps.

When a different channel test case needs to be run, a Cyara Service Step called "Start Cyara Test Case" will be used. When the results of the SMS test case should be passed back to the initial Voice Test Case, the Cyara Service Step called "Wait for Cyara Test Case Result" will be used.

To add a Cyara Service Step to a Voice Test Case, click the New Step button.

To start a SMS Test Case within a Service Step, select Start Cyara Test Case then click Browse and select the test case you want to start. Click OK to assign the test case.

Any Parameters that have been defined within the SMS test case will be added to the input parameter list. For more info on how to assign Parameters to a test case, read the Parameters article. You can now define what values to use for the listed Parameters. In the example below, we have defined a Parameter called [Mobile] within the customer Mobile Number field of a SMS test case. We can now re-use the same test case and define a different customer mobile number each time.

Here is an example test case using [Mobile] Parameter for the Mobile Number field.

And here is our example Service Step to start this Test Case.

To retrieve SMS Test Case results, select the "Wait for Cyara Test Case Result" Cyara Service Step. Then from the "Wait For" drop down menu, select the Service Step result that you want this Test Case to wait for.

Any Variables that have been defined within the SMS test case will automatically be included in the Output Parameter list. In this example we have defined a Variable called $pin, within an expect to hear field on the SMS Test Case, so it has been added to the Output Parameter list.

To pass the SMS results from the SMS Test Case back to the "Master" Voice Test case, a Variable must be used.

In this example scenario, we have created a SMS Test Case to receive the Pin and assign it to the $pin variable. This variable can then be re-called by the Master Inbound Voice Test Case to extract and use the assigned data.

Below is an example SMS Test Case setup to receive a PIN and assign it to a Variable called $pin.

Note: In SMS test cases the {number} Tag is used to match decimal numbers.

Note: The Mobile field can be used to validate the number the message was sent from. This can be an international mobile number or a plain text sender (e.g NoReply).

Below is the result of combining these two example Test Cases. Here is an example "Master" Inbound Voice Test Case that invokes the SMS test case (called "Get OTP"), waits for the result of the "Get OTP" SMS test case, then replies with the data assigned to the $pin Variable.