Resume

During a programmable SIP call, the RCML <Resume> Verb instructs Restcomm to resume a call after it was put on hold through the RCML <Hold> Verb.

This verb will trigger a SIP RE-INVITE towards the remote party SIP Infrastructure.

The <Resume> feature can also be invoked via REST API.

If <Resume> is used while a call was never put on hold before it will be ignored!

Resume Attributes

Name	Allowed Values	Default Value
action	Relative or absolute URL	none
method	GET, POST	POST

Name

Allowed Values

Default Value

action

Relative or absolute URL

none

method

GET, POST

POST

Action Attribute

The 'action' attribute takes a URL as an argument. After the verb finishes executing, Restcomm will make a GET or POST request to this URL including the parameters below.

The request made to this URL may include the following additional parameters:

Parameter	Description	Allowed Values
ResumeStatus	Provides the application with our understanding (based on SIP re-INVITE transaction messages) of the status of the Resume operation.	resumed, failed, no-answer
ResumeSipResponseCode	The SIP response code received in response to the RESUME request sent to the SIP endpoint.	integer

Parameter

Description

Allowed Values

ResumeStatus

Provides the application with our understanding (based on SIP re-INVITE transaction messages) of the status of the Resume operation.

resumed, failed, no-answer

ResumeSipResponseCode

The SIP response code received in response to the RESUME request sent to the SIP endpoint.

integer

Notice that Restcomm will also send the standard RCML Voice parameters in the request.

Method Attribute

The 'method' attribute defines whether action URL invocation uses HTTP GET or POST method.

Nesting

<Resume> does not support nesting.

Examples

Resume a call leg

<Response>
   <Resume/>
</Response>

Resume Call Flows

The following flow diagrams illustrate the possible call flow scenarios for the RCML <Resume> verb.

Successful Resume

The diagram below outlines dialing to a Restcomm IVR. After the subscriber press a digit, call is held to the destination subscriber.