Skip to content

Action Result

Contains the result of a previous action for those actions that generate a result.

Used by actions connect, connect to conference, get input, get number, receive fax, record, run menu, run speech menu, send fax, start transcription and in HTTP Request

language wrappers and examples

It contains the following properties:

PropertyAvailabilityDescription
actionalwaysThe name of the action that generated this result.
resultalways unless interrupted A JSON object that contains the result of the action specified. The following actions generate an action result: record, get number, get input, run menu, run speech menu, connect, connect to conference, send fax and receive fax. See these actions for details of the contents of this object.
If interrupted is true this property will be omitted.
interruptedinterrupted actions onlyA boolean to indicate whether the action was interrupted by the web-services interrupt command

Examples:

The action result of a record action:
{
    "action" : "record",
    "result" :
    {
        "filename" : "/rest_api/recordings/2013/07/16/14_35_03_04f01fb92e8913a8.62100.wav",
        "contains_sound" : true,
        "seconds_duration" : 16.7
    }
}
The action result of an interrupted get input action:
{
    "action" : "get_input",
    "interrupted" : true
}

ActionResult Class

Namespace: Aculab.Cloud.RestAPIWrapper

Assembly: Aculab.Cloud.RestAPIWrapper.dll

Base class for all result classes.

These provide result information for an action.

public class ActionResult 
{
    // Members
    public string Action;
    public bool Interrupted;
}

Examples:

Get the details of the recording from the result of a record action:
// Unpack the request
var telephonyRequest = new TelephonyRequest(Request);

var recordResult = (RecordResult)telephonyRequest.InstanceInfo.ActionResult;
var filename = recordResult.Filename;
Get the action that was interrupted:
// Unpack the request
var telephonyRequest = new TelephonyRequest(Request);

var actionResult = telephonyRequest.InstanceInfo.ActionResult;
if (actionResult.Interrupted)
{
    // Determine which ation was interrupted
    var actionInterrupted = actionResult.Action;

    // ...
}
public class ActionResult 
{
    // Members
    public string Action;
    public bool Interrupted;
}

Examples:

Get the details of the recording from the result of a record action:
// Unpack the request
var telephonyRequest = new TelephonyRequest(Request);

var recordResult = (RecordResult)telephonyRequest.InstanceInfo.ActionResult;
var filename = recordResult.Filename;
Get the action that was interrupted:
// Unpack the request
var telephonyRequest = new TelephonyRequest(Request);

var actionResult = telephonyRequest.InstanceInfo.ActionResult;
if (actionResult.Interrupted)
{
    // Determine which ation was interrupted
    var actionInterrupted = actionResult.Action;

    // ...
}
public class ActionResult 
{
    // Members
    public string Action;
    public bool Interrupted;
}

Examples:

Get the details of the recording from the result of a record action:
// Unpack the request
var telephonyRequest = await TelephonyRequest.UnpackRequestAsync(Request);

var recordResult = (RecordResult)telephonyRequest.InstanceInfo.ActionResult;
var filename = recordResult.Filename;
Get the action that was interrupted:
// Unpack the request
var telephonyRequest = await TelephonyRequest.UnpackRequestAsync(Request);

var actionResult = telephonyRequest.InstanceInfo.ActionResult;
if (actionResult.Interrupted)
{
    // Determine which ation was interrupted
    var actionInterrupted = actionResult.Action;

    // ...
}

ActionResult Class

Namespace: Aculab.Cloud.RestAPIWrapper

Assembly: Aculab.Cloud.RestAPIWrapper.dll

Base class for all result classes.

These provide result information for an action.

Public Class ActionResult
    ' Members
    Public Property Action As String
    Public Property Interrupted As Bool
End Class

Examples:

Get the details of the recording from the result of a record action:
' Unpack the request
Dim telephonyRequest = New TelephonyRequest(Request)

Dim recordResult As RecordResult = telephonyRequest.InstanceInfo.ActionResult
Dim filename = recordResult.Filename
Get the action that was interrupted:
' Unpack the request
Dim telephonyRequest = New TelephonyRequest(Request)

Dim actionResult = telephonyRequest.InstanceInfo.ActionResult
If actionResult.Interrupted Then
    ' Determine which ation was interrupted
    Dim actionInterrupted = actionResult.Action

    ' ...
End If
Public Class ActionResult
    ' Members
    Public Property Action As String
    Public Property Interrupted As Bool
End Class

Examples:

Get the details of the recording from the result of a record action:
' Unpack the request
Dim telephonyRequest = New TelephonyRequest(Request)

Dim recordResult As RecordResult = telephonyRequest.InstanceInfo.ActionResult
Dim filename = recordResult.Filename
Get the action that was interrupted:
' Unpack the request
Dim telephonyRequest = New TelephonyRequest(Request)

Dim actionResult = telephonyRequest.InstanceInfo.ActionResult
If actionResult.Interrupted Then
    ' Determine which ation was interrupted
    Dim actionInterrupted = actionResult.Action

    ' ...
End If

class ActionResult

Base class for all result classes. These provide result information for an action.

Class synopsis:

// Members:
public final String getAction()
public final boolean getInterrupted()

Examples:

Get the details of the recording from the result of a record action:
TelephonyRequest myRequest = new TelephonyRequest(request);
ActionResult actionResult = myRequest.getInstanceInfo().getActionResult();

if (actionResult.getAction() == "record")
{
    RecordResult recordResult = (RecordResult)actionResult;
    String filename = recordResult.getFilename();
    boolean containsSound = recordResult.containsSound();
    double secsDurection = recordResult.getSecondsDuration();

    // Your code here...
}
Get the action that was interrupted:
TelephonyRequest myRequest = new TelephonyRequest(request);
ActionResult actionResult = myRequest.getInstanceInfo().getActionResult();

if (actionResult.getAction() == "get_input")
{
    if (actionResult.getInterrupted())
    {
        // The GetInput action was interrupted

        // Your code here...
    }
}

TelephonyRequest.get_action_result()

Returns a dictionary that represents a Action Result support class.

Examples:

Get the details of the recording from the result of a record action:
my_request = TelephonyRequest(request)
action_result = my_request.get_action_result()

if action_result.get("action") == "record":
    is_interrupted = action_result.get("interrupted", False)

    if is_interrupted == False:
        result = action_result.get("result")
        filename = result.get("filename")
        contains_sound = result.get("contains_sound")
        seconds_duration = result.get("seconds_duration")
Get the action that was interrupted:
if action_result.get("action") == "get_input":
    is_interrupted = action_result.get("interrupted", False)

    if is_interrupted == True:
        print("action result unavailable - get input was interrupted")

The ActionResult class

Introduction

Represents the result of an action.

Class synopsis

class ActionResult extends PropertyHolder {

    /* methods */
    public string getAction()
    public boolean getInterrupted()
}

Examples:

Get the details of the recording from the result of a record action
$info = InstanceInfo::getInstanceInfo();
$recordResult = $info->getActionResult();
$filename = $recordResult->getFilename();
$containsSound = $recordResult->getContainsSound();
$duration = $recordResult->getSecondsDuration();
Get the action that was interrupted
$info = InstanceInfo::getInstanceInfo();
$actionResult = $info->getActionResult();
if ($actionResult->getInterrupted()) {
    $interruptedAction = $actionResult->getAction();
}