| Required role: | User |
| POST | /sessions/{sessionId}/hold |
|---|
import java.math.*
import java.util.*
import java.io.InputStream
import net.servicestack.client.*
/**
* Hold the specified session
*/
@Api(Description="Hold the specified session")
open class HoldSession : IPost
{
/**
* The local call SID
*/
@ApiMember(Description="The local call SID")
open var callSid:String? = null
/**
* The ID of the session to hold
*/
@ApiMember(Description="The ID of the session to hold")
open var sessionId:String? = null
/**
* The reason you are holding this call
*/
@ApiMember(Description="The reason you are holding this call")
open var reason:SessionHoldReasons? = null
}
enum class SessionHoldReasons
{
None,
Transferring,
}
open class SessionInfo : EntityInfo()
{
/**
* The state of the session
*/
@ApiMember(Description="The state of the session")
open var dialState:SessionDialState? = null
/**
* The call state of the session
*/
@ApiMember(Description="The call state of the session")
open var callState:SessionCallState? = null
/**
* The queue state of the session
*/
@ApiMember(Description="The queue state of the session")
open var queueState:SessionQueueStates? = null
/**
* The ID of the account associated with the flow
*/
@ApiMember(Description="The ID of the account associated with the flow")
open var accountId:String? = null
/**
* The name of the account associated with the session
*/
@ApiMember(Description="The name of the account associated with the session")
open var accountName:String? = null
/**
* The ID of the customer this session is associated with
*/
@ApiMember(Description="The ID of the customer this session is associated with")
open var customerId:String? = null
/**
* The customer breadcrumb this session is associated with
*/
@ApiMember(Description="The customer breadcrumb this session is associated with")
open var customerBreadcrumb:ArrayList<CustomerBreadcrumb>? = null
/**
* The name of the customer this session is associated with
*/
@ApiMember(Description="The name of the customer this session is associated with")
open var customerName:String? = null
/**
* The ID of the endpoint associated with this session
*/
@ApiMember(Description="The ID of the endpoint associated with this session")
open var endpointId:String? = null
/**
* The name of the endpoint associated with this session
*/
@ApiMember(Description="The name of the endpoint associated with this session")
open var endpointName:String? = null
/**
* The date the call completed
*/
@ApiMember(Description="The date the call completed")
open var dateCompleted:String? = null
/**
* The destination of the session (e.g. what was entered into the Dial box)
*/
@ApiMember(Description="The destination of the session (e.g. what was entered into the Dial box)")
open var destination:String? = null
/**
* The to address if any
*/
@ApiMember(Description="The to address if any")
open var toAddress:String? = null
/**
* The from address if any
*/
@ApiMember(Description="The from address if any")
open var fromAddress:String? = null
/**
* The from name if any
*/
@ApiMember(Description="The from name if any")
open var fromName:String? = null
/**
* Answered by name (if any)
*/
@ApiMember(Description="Answered by name (if any)")
open var answeredByName:String? = null
/**
* The ID of the queue member assigned to this call
*/
@ApiMember(Description="The ID of the queue member assigned to this call")
open var queueMemberId:String? = null
/**
* The flow channel
*/
@ApiMember(Description="The flow channel")
open var channel:FlowChannels? = null
/**
* Has the session ended
*/
@ApiMember(Description="Has the session ended")
open var ended:Boolean? = null
/**
* The outcome of the call
*/
@ApiMember(Description="The outcome of the call")
open var outcome:String? = null
/**
* The twilio Call SID of this session
*/
@ApiMember(Description="The twilio Call SID of this session")
open var callSid:String? = null
/**
* Any console data for this session
*/
@ApiMember(Description="Any console data for this session")
open var consoleData:String? = null
/**
* The name of the hold queue for this call
*/
@ApiMember(Description="The name of the hold queue for this call")
open var holdQueueName:String? = null
/**
* The user ID who put this call on hold
*/
@ApiMember(Description="The user ID who put this call on hold")
open var heldByUserId:String? = null
/**
* The reason for the hold
*/
@ApiMember(Description="The reason for the hold")
open var holdReason:SessionHoldReasons? = null
/**
* The SID of the conference if in a conference call
*/
@ApiMember(Description="The SID of the conference if in a conference call")
open var conferenceSid:String? = null
/**
* The display name for this session
*/
@ApiMember(Description="The display name for this session")
open var displayName:String? = null
/**
* The log entries for this session
*/
@ApiMember(Description="The log entries for this session")
open var log:ArrayList<SessionLogInfo>? = null
/**
* The members of this session
*/
@ApiMember(Description="The members of this session")
open var members:ArrayList<SessionMemberInfo>? = null
/**
* The callback number (typically used for SIP to User calls)
*/
@ApiMember(Description="The callback number (typically used for SIP to User calls)")
open var callbackNumber:String? = null
/**
* The ID of the endpoint that answered
*/
@ApiMember(Description="The ID of the endpoint that answered")
open var answeredById:String? = null
/**
* Is this session incoming or outgoing?
*/
@ApiMember(Description="Is this session incoming or outgoing?")
open var direction:SessionDirections? = null
/**
* The phone number that this session is coming from (used with SMS chats)
*/
@ApiMember(Description="The phone number that this session is coming from (used with SMS chats)")
open var fromPhoneNumber:String? = null
/**
* The Call SID of the most recently added conference participant
*/
@ApiMember(Description="The Call SID of the most recently added conference participant")
open var mostRecentParticipantCallSid:String? = null
/**
* Was this session missed?
*/
@ApiMember(Description="Was this session missed?")
open var wasMissed:Boolean? = null
/**
* The ring queue that the call is currently in
*/
@ApiMember(Description="The ring queue that the call is currently in")
open var ringQueueId:String? = null
}
open class EntityInfo
{
/**
* The ID of the object
*/
@ApiMember(Description="The ID of the object")
open var id:String? = null
/**
* The date the object was created
*/
@ApiMember(Description="The date the object was created")
open var dateCreated:String? = null
/**
* The date the object was last modified
*/
@ApiMember(Description="The date the object was last modified")
open var dateLastModified:String? = null
/**
* The user that created this object
*/
@ApiMember(Description="The user that created this object")
open var createdBy:String? = null
/**
* The user that last modified this object
*/
@ApiMember(Description="The user that last modified this object")
open var lastModifiedBy:String? = null
}
enum class SessionDialState
{
None,
Active,
}
enum class SessionCallState
{
Disconnected,
Ringing,
Connected,
Hold,
Passive,
}
enum class SessionQueueStates
{
None,
Queued,
Ringing,
Connected,
Hold,
Disconnected,
}
open class CustomerBreadcrumb
{
open var id:String? = null
open var name:String? = null
}
enum class FlowChannels
{
Voice,
Chat,
Fax,
}
open class SessionLogInfo
{
open var date:String? = null
open var message:String? = null
}
open class SessionMemberInfo
{
open var identity:String? = null
open var endpointId:String? = null
open var displayName:String? = null
open var isOriginalMember:Boolean? = null
open var avatarUrl:String? = null
open var applicationData:HashMap<String,String>? = null
open var callState:SessionMemberCallState? = null
open var role:SessionMemberRoles? = null
open var callSid:String? = null
open var muted:Boolean? = null
}
enum class SessionMemberCallState
{
None,
Ringing,
Connected,
Hold,
}
enum class SessionMemberRoles
{
None,
Caller,
Agent,
Transfer,
}
enum class SessionDirections
{
Incoming,
Outgoing,
}
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /sessions/{sessionId}/hold HTTP/1.1
Host: evovoice.io
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<HoldSession xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Sessions">
<CallSid>String</CallSid>
<Reason>None</Reason>
<SessionId>String</SessionId>
</HoldSession>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length
<SessionInfo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Sessions">
<CreatedBy xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</CreatedBy>
<DateCreated xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</DateCreated>
<DateLastModified xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</DateLastModified>
<Id xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</Id>
<LastModifiedBy xmlns="http://schemas.datacontract.org/2004/07/Voice.Api">String</LastModifiedBy>
<AccountId>String</AccountId>
<AccountName>String</AccountName>
<AnsweredById>String</AnsweredById>
<AnsweredByName>String</AnsweredByName>
<CallSid>String</CallSid>
<CallState>Disconnected</CallState>
<CallbackNumber>String</CallbackNumber>
<Channel>Voice</Channel>
<ConferenceSid>String</ConferenceSid>
<ConsoleData>String</ConsoleData>
<CustomerBreadcrumb xmlns:d2p1="http://schemas.datacontract.org/2004/07/Voice.Api.Customers">
<d2p1:CustomerBreadcrumb>
<d2p1:Id>String</d2p1:Id>
<d2p1:Name>String</d2p1:Name>
</d2p1:CustomerBreadcrumb>
</CustomerBreadcrumb>
<CustomerId>String</CustomerId>
<CustomerName>String</CustomerName>
<DateCompleted>String</DateCompleted>
<Destination>String</Destination>
<DialState>None</DialState>
<Direction>Incoming</Direction>
<DisplayName>String</DisplayName>
<Ended>false</Ended>
<EndpointId>String</EndpointId>
<EndpointName>String</EndpointName>
<FromAddress>String</FromAddress>
<FromName>String</FromName>
<FromPhoneNumber>String</FromPhoneNumber>
<HeldByUserId>String</HeldByUserId>
<HoldQueueName>String</HoldQueueName>
<HoldReason>None</HoldReason>
<Log>
<SessionLogInfo>
<Date>String</Date>
<Message>String</Message>
</SessionLogInfo>
</Log>
<Members>
<SessionMemberInfo>
<ApplicationData xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d4p1:KeyValueOfstringstring>
<d4p1:Key>String</d4p1:Key>
<d4p1:Value>String</d4p1:Value>
</d4p1:KeyValueOfstringstring>
</ApplicationData>
<AvatarUrl>String</AvatarUrl>
<CallSid>String</CallSid>
<CallState>None</CallState>
<DisplayName>String</DisplayName>
<EndpointId>String</EndpointId>
<Identity>String</Identity>
<IsOriginalMember>false</IsOriginalMember>
<Muted>false</Muted>
<Role>None</Role>
</SessionMemberInfo>
</Members>
<MostRecentParticipantCallSid>String</MostRecentParticipantCallSid>
<Outcome>String</Outcome>
<QueueMemberId>String</QueueMemberId>
<QueueState>None</QueueState>
<RingQueueId>String</RingQueueId>
<ToAddress>String</ToAddress>
<WasMissed>false</WasMissed>
</SessionInfo>