Informizely customer feedback surveys
By using the Aculab site, you agree with our use of cookies.

secondary call

Determines the pages and properties relating to the outbound (secondary) call made during a connect or connect to conference action:

Used by actions connect, connect to conference

language wrappers and examples

It contains the following properties:

PropertyRequired/OptionalDefaultDescription
call recordingoptionalfalsetrue or false. Whether to record the whole of the secondary call. See note on Call Recording.
call recording encryptionoptionalfalsetrue or false. Whether to encrypt the whole call recording.
minutes max call durationoptional240An integer. The maximum duration of the secondary call in minutes. The secondary call is hung up if this is exceeded.
first pageoptional-A web page request object that is requested when the secondary call has been answered (and classification completed, if it has been enabled). This gives the application an opportunity to interact with the secondary call before it is connected to the primary call.
final pageoptional-A web page request object that is requested when either the primary or secondary call is hung up (i.e. the connection has been broken).
error pageoptional-A web page request object that is requested when there is an error during the connect action.

Note: Call Recording records the whole call, mixed inbound and outbound audio, from the point at which the calls are connected. It does not record early media and saves recorded files into the account's Media File Store.


  • Examples:


    •     {
      		"first_page":
      		{
      			"url" : "my_secondary_call_first_page"
      		}
          }
      
    •     {
      		"call_recording" : true,
      		"call_recording_encryption" : true, 
      		"minutes_max_call_duration" : 30,
      		"first_page":
      		{
      			"url" : "my_secondary_call_first_page"
      		},
      		"final_page":
      		{
      			"url" : "my_secondary_call_final_page"
      		},
      		"error_page":
      		{
      			"url" : "my_secondary_call_error_page"
      		}
          }
      
  • SecondaryCall Class
    Namespace: Aculab.Cloud.RestAPIWrapper
    Assembly: Aculab.Cloud.RestAPIWrapper.dll

    A class that represents the secondary outbound call that is made by the Connect or ConnectToConference actions. It determines pages and properties relating to this call.

    public class SecondaryCall 
    {
        // Constructors
        public SecondaryCall();
        public SecondaryCall(WebPageRequest firstPage);
        public SecondaryCall(WebPageRequest firstPage, int minutesMaxCallDuration, bool callRecording);
    
        // Members
        public bool? CallRecording;
        public bool? CallRecordingEncryption;
        public int? MinutesMaxCallDuration;
        public WebPageRequest FirstPage;
        public WebPageRequest FinalPage;
        public WebPageRequest ErrorPage;
    }
    

    Examples:

    • Configure the first page of a secondary call:

      var secondaryCall = new SecondaryCall(new WebPageRequest("MySecondaryCallFirstPage.aspx"));
      
      var connectAction = new Connect("443069990123");
      connectAction.SecondaryCall = secondaryCall;
      
    • Configure multiple options:

      var secondaryCall = new SecondaryCall(new WebPageRequest("MySecondaryCallFirstPage.aspx"), 30, true)
      {
          CallRecordingEncryption = true,
          ErrorPage = new WebPageRequest("MySecondaryCallErrorPage.aspx"),
          FinalPage = new WebPageRequest("MySecondaryCallFinalPage.aspx")
      };
      
      var connectAction = new Connect("443069990123");
      connectAction.SecondaryCall = secondaryCall;
      
  • SecondaryCall Class
    Namespace: Aculab.Cloud.RestAPIWrapper
    Assembly: Aculab.Cloud.RestAPIWrapper.dll

    A class that represents the secondary outbound call that is made by the Connect or ConnectToConference actions. It determines pages and properties relating to this call.

    Public Class SecondaryCall
        ' Constructors
        Public Sub New ()
        Public Sub New (firstPage As Webpagerequest)
        Public Sub New (firstPage As Webpagerequest, minutesMaxCallDuration As Integer, callRecording As Bool)
    
        ' Members
        Public Property CallRecording As Bool?
        Public Property CallRecordingEncryption As Bool?
        Public Property MinutesMaxCallDuration As Integer?
        Public Property FirstPage As Webpagerequest
        Public Property FinalPage As Webpagerequest
        Public Property ErrorPage As Webpagerequest
    End Class
    

    Examples:

    • Configure the first page of a secondary call:

      Dim secondaryCall = New SecondaryCall(New WebPageRequest("MySecondaryCallFirstPage.aspx"))
      
      Dim connectAction = New Connect("443069990123")
      connectAction.SecondaryCall = secondaryCall
      
    • Configure multiple options:

      Dim secondaryCall = New SecondaryCall(New WebPageRequest("MySecondaryCallFirstPage.aspx"), 30, True)
      secondaryCall.CallRecordingEncryption = True
      secondaryCall.ErrorPage = New WebPageRequest("MySecondaryCallErrorPage.aspx")
      secondaryCall.FinalPage = New WebPageRequest("MySecondaryCallFinalPage.aspx")
      
      Dim connectAction = New Connect("443069990123")
      connectAction.SecondaryCall = secondaryCall
      
  • class SecondaryCall extends JSONElement

    Represents the Secondary Call support class.

    Class synopsis:

    // Constructors:
    public SecondaryCall()
    public SecondaryCall(WebPageRequest firstPage)
    public SecondaryCall(WebPageRequest firstPage, int minutesMaxCallDuration, boolean callRecording)
    
    // Members:
    public void setCallRecording(boolean enabled)
    public void setCallRecordingEncryption(boolean enabled)
    public void setMinutesMaxCallDuration(int minutesMaxDuration)
    public void setFirstPage(WebPageRequest firstPage)
    public void setFinalPage(WebPageRequest finalPage)
    public void setErrorPage(WebPageRequest errorPage)
    

    Examples:

    • Configure the first page of a secondary call:

      SecondaryCall secCall = new SecondaryCall();
      secCall.setFirstPage(new WebPageRequest("my_secondary_call_first_page"));
      
    • Configure multiple options:

      SecondaryCall secCall = new SecondaryCall();
      secCall.setCallRecording(true);
      secCall.setMinutesMaxCallDuration(30);
      secCall.setFirstPage(new WebPageRequest("my_secondary_call_first_page"));
      secCall.setFinalPage(new WebPageRequest("my_secondary_call_final_page"));
      secCall.setErrorPage(new WebPageRequest("my_secondary_call_error_page"));
      
  • class SecondaryCall

    Represents the Secondary Call support class.

    Class synopsis:

    # SecondaryCall object:
    SecondaryCall(first_page=None,
                  final_page=None,
                  error_page=None,
                  minutes_max_call_duration=None,
                  call_recording=None,
                  call_recording_encryption=None)
    

    Examples:


    • secondary_call = SecondaryCall(first_page=WebPage(url='my_secondary_call_first_page'))
      
    • secondary_call = SecondaryCall(first_page=WebPage(url='my_secondary_call_first_page'),
                                     final_page=WebPage(url='my_secondary_call_final_page'),
                                     error_page=WebPage(url='my_secondary_call_error_page'),
                                     call_recording=True,
                                     call_recording_encryption=True,
                                     minutes_max_call_duration=30)
      
  • The SecondaryCallConfiguration class

    Introduction

    Represents the secondary call configuration for a connect action.

    Class synopsis

    class SecondaryCallConfiguration {
    
        /* methods */
        public __construct()
        public self setCallRecording(boolean $rec)
        public self setCallRecordingEncryption(boolean $encrypt)
        public self setMinutesMaxCallDuration(int $mins)
        public self setFirstPage(WebPageRequest|string $first_page, string $method = null)
        public self setFinalPage(WebPageRequest|string $final_page, string $method = null)
        public self setErrorPage(WebPageRequest|string $error_page, string $method = null)
    }
    

    Examples:

    • Configure the first page of a secondary call:

      $call_config = new Aculab\TelephonyRestAPI\SecondaryCallConfiguration();
      $call_config->setFirstPage('my_secondary_call_first_page.php');
      $connect->setSecondaryCallConfiguration($call_config);
      
    • Configure multiple options:

      $call_config = new Aculab\TelephonyRestAPI\SecondaryCallConfiguration();
      $call_config->setMinutesMaxCallDuration(30)
          ->setCallRecordingEncryption(true)
          ->setCallRecording(true)
          ->setFirstPage('my_secondary_call_first_page.php')
          ->setErrorPage('my_secondary_call_error_page.php')
          ->setFinalPage('my_secondary_call_final_page.php');
      $connect->setSecondaryCallConfiguration($call_config);