| Required role: | User |
| POST | /sessions |
|---|
import 'package:servicestack/servicestack.dart';
abstract class EntityInfo
{
/**
* The ID of the object
*/
// @ApiMember(Description="The ID of the object")
String? id;
/**
* The date the object was created
*/
// @ApiMember(Description="The date the object was created")
String? dateCreated;
/**
* The date the object was last modified
*/
// @ApiMember(Description="The date the object was last modified")
String? dateLastModified;
/**
* The user that created this object
*/
// @ApiMember(Description="The user that created this object")
String? createdBy;
/**
* The user that last modified this object
*/
// @ApiMember(Description="The user that last modified this object")
String? lastModifiedBy;
EntityInfo({this.id,this.dateCreated,this.dateLastModified,this.createdBy,this.lastModifiedBy});
EntityInfo.fromJson(Map<String, dynamic> json) { fromMap(json); }
fromMap(Map<String, dynamic> json) {
id = json['id'];
dateCreated = json['dateCreated'];
dateLastModified = json['dateLastModified'];
createdBy = json['createdBy'];
lastModifiedBy = json['lastModifiedBy'];
return this;
}
Map<String, dynamic> toJson() => {
'id': id,
'dateCreated': dateCreated,
'dateLastModified': dateLastModified,
'createdBy': createdBy,
'lastModifiedBy': lastModifiedBy
};
getTypeName() => "EntityInfo";
TypeContext? context = _ctx;
}
enum SessionDialState
{
None,
Active,
}
enum SessionCallState
{
Disconnected,
Ringing,
Connected,
Hold,
Passive,
}
enum SessionQueueStates
{
None,
Queued,
Ringing,
Connected,
Hold,
Disconnected,
}
class CustomerBreadcrumb implements IConvertible
{
String? id;
String? name;
CustomerBreadcrumb({this.id,this.name});
CustomerBreadcrumb.fromJson(Map<String, dynamic> json) { fromMap(json); }
fromMap(Map<String, dynamic> json) {
id = json['id'];
name = json['name'];
return this;
}
Map<String, dynamic> toJson() => {
'id': id,
'name': name
};
getTypeName() => "CustomerBreadcrumb";
TypeContext? context = _ctx;
}
enum FlowChannels
{
Voice,
Chat,
Fax,
}
enum SessionHoldReasons
{
None,
Transferring,
}
class SessionLogInfo implements IConvertible
{
String? date;
String? message;
SessionLogInfo({this.date,this.message});
SessionLogInfo.fromJson(Map<String, dynamic> json) { fromMap(json); }
fromMap(Map<String, dynamic> json) {
date = json['date'];
message = json['message'];
return this;
}
Map<String, dynamic> toJson() => {
'date': date,
'message': message
};
getTypeName() => "SessionLogInfo";
TypeContext? context = _ctx;
}
enum SessionMemberCallState
{
None,
Ringing,
Connected,
Hold,
}
enum SessionMemberRoles
{
None,
Caller,
Agent,
Transfer,
}
class SessionMemberInfo implements IConvertible
{
String? identity;
String? endpointId;
String? displayName;
bool? isOriginalMember;
String? avatarUrl;
Map<String,String?>? applicationData;
SessionMemberCallState? callState;
SessionMemberRoles? role;
String? callSid;
bool? muted;
SessionMemberInfo({this.identity,this.endpointId,this.displayName,this.isOriginalMember,this.avatarUrl,this.applicationData,this.callState,this.role,this.callSid,this.muted});
SessionMemberInfo.fromJson(Map<String, dynamic> json) { fromMap(json); }
fromMap(Map<String, dynamic> json) {
identity = json['identity'];
endpointId = json['endpointId'];
displayName = json['displayName'];
isOriginalMember = json['isOriginalMember'];
avatarUrl = json['avatarUrl'];
applicationData = JsonConverters.toStringMap(json['applicationData']);
callState = JsonConverters.fromJson(json['callState'],'SessionMemberCallState',context!);
role = JsonConverters.fromJson(json['role'],'SessionMemberRoles',context!);
callSid = json['callSid'];
muted = json['muted'];
return this;
}
Map<String, dynamic> toJson() => {
'identity': identity,
'endpointId': endpointId,
'displayName': displayName,
'isOriginalMember': isOriginalMember,
'avatarUrl': avatarUrl,
'applicationData': applicationData,
'callState': JsonConverters.toJson(callState,'SessionMemberCallState',context!),
'role': JsonConverters.toJson(role,'SessionMemberRoles',context!),
'callSid': callSid,
'muted': muted
};
getTypeName() => "SessionMemberInfo";
TypeContext? context = _ctx;
}
enum SessionDirections
{
Incoming,
Outgoing,
}
class SessionInfo extends EntityInfo implements IConvertible
{
/**
* The state of the session
*/
// @ApiMember(Description="The state of the session")
SessionDialState? dialState;
/**
* The call state of the session
*/
// @ApiMember(Description="The call state of the session")
SessionCallState? callState;
/**
* The queue state of the session
*/
// @ApiMember(Description="The queue state of the session")
SessionQueueStates? queueState;
/**
* The ID of the account associated with the flow
*/
// @ApiMember(Description="The ID of the account associated with the flow")
String? accountId;
/**
* The name of the account associated with the session
*/
// @ApiMember(Description="The name of the account associated with the session")
String? accountName;
/**
* The ID of the customer this session is associated with
*/
// @ApiMember(Description="The ID of the customer this session is associated with")
String? customerId;
/**
* The customer breadcrumb this session is associated with
*/
// @ApiMember(Description="The customer breadcrumb this session is associated with")
List<CustomerBreadcrumb>? customerBreadcrumb;
/**
* The name of the customer this session is associated with
*/
// @ApiMember(Description="The name of the customer this session is associated with")
String? customerName;
/**
* The ID of the endpoint associated with this session
*/
// @ApiMember(Description="The ID of the endpoint associated with this session")
String? endpointId;
/**
* The name of the endpoint associated with this session
*/
// @ApiMember(Description="The name of the endpoint associated with this session")
String? endpointName;
/**
* The date the call completed
*/
// @ApiMember(Description="The date the call completed")
String? dateCompleted;
/**
* 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)")
String? destination;
/**
* The to address if any
*/
// @ApiMember(Description="The to address if any")
String? toAddress;
/**
* The from address if any
*/
// @ApiMember(Description="The from address if any")
String? fromAddress;
/**
* The from name if any
*/
// @ApiMember(Description="The from name if any")
String? fromName;
/**
* Answered by name (if any)
*/
// @ApiMember(Description="Answered by name (if any)")
String? answeredByName;
/**
* The ID of the queue member assigned to this call
*/
// @ApiMember(Description="The ID of the queue member assigned to this call")
String? queueMemberId;
/**
* The flow channel
*/
// @ApiMember(Description="The flow channel")
FlowChannels? channel;
/**
* Has the session ended
*/
// @ApiMember(Description="Has the session ended")
bool? ended;
/**
* The outcome of the call
*/
// @ApiMember(Description="The outcome of the call")
String? outcome;
/**
* The twilio Call SID of this session
*/
// @ApiMember(Description="The twilio Call SID of this session")
String? callSid;
/**
* Any console data for this session
*/
// @ApiMember(Description="Any console data for this session")
String? consoleData;
/**
* The name of the hold queue for this call
*/
// @ApiMember(Description="The name of the hold queue for this call")
String? holdQueueName;
/**
* The user ID who put this call on hold
*/
// @ApiMember(Description="The user ID who put this call on hold")
String? heldByUserId;
/**
* The reason for the hold
*/
// @ApiMember(Description="The reason for the hold")
SessionHoldReasons? holdReason;
/**
* The SID of the conference if in a conference call
*/
// @ApiMember(Description="The SID of the conference if in a conference call")
String? conferenceSid;
/**
* The display name for this session
*/
// @ApiMember(Description="The display name for this session")
String? displayName;
/**
* The log entries for this session
*/
// @ApiMember(Description="The log entries for this session")
List<SessionLogInfo>? log;
/**
* The members of this session
*/
// @ApiMember(Description="The members of this session")
List<SessionMemberInfo>? members;
/**
* The callback number (typically used for SIP to User calls)
*/
// @ApiMember(Description="The callback number (typically used for SIP to User calls)")
String? callbackNumber;
/**
* The ID of the endpoint that answered
*/
// @ApiMember(Description="The ID of the endpoint that answered")
String? answeredById;
/**
* Is this session incoming or outgoing?
*/
// @ApiMember(Description="Is this session incoming or outgoing?")
SessionDirections? direction;
/**
* 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)")
String? fromPhoneNumber;
/**
* The Call SID of the most recently added conference participant
*/
// @ApiMember(Description="The Call SID of the most recently added conference participant")
String? mostRecentParticipantCallSid;
/**
* Was this session missed?
*/
// @ApiMember(Description="Was this session missed?")
bool? wasMissed;
/**
* The ring queue that the call is currently in
*/
// @ApiMember(Description="The ring queue that the call is currently in")
String? ringQueueId;
SessionInfo({this.dialState,this.callState,this.queueState,this.accountId,this.accountName,this.customerId,this.customerBreadcrumb,this.customerName,this.endpointId,this.endpointName,this.dateCompleted,this.destination,this.toAddress,this.fromAddress,this.fromName,this.answeredByName,this.queueMemberId,this.channel,this.ended,this.outcome,this.callSid,this.consoleData,this.holdQueueName,this.heldByUserId,this.holdReason,this.conferenceSid,this.displayName,this.log,this.members,this.callbackNumber,this.answeredById,this.direction,this.fromPhoneNumber,this.mostRecentParticipantCallSid,this.wasMissed,this.ringQueueId});
SessionInfo.fromJson(Map<String, dynamic> json) { fromMap(json); }
fromMap(Map<String, dynamic> json) {
super.fromMap(json);
dialState = JsonConverters.fromJson(json['dialState'],'SessionDialState',context!);
callState = JsonConverters.fromJson(json['callState'],'SessionCallState',context!);
queueState = JsonConverters.fromJson(json['queueState'],'SessionQueueStates',context!);
accountId = json['accountId'];
accountName = json['accountName'];
customerId = json['customerId'];
customerBreadcrumb = JsonConverters.fromJson(json['customerBreadcrumb'],'List<CustomerBreadcrumb>',context!);
customerName = json['customerName'];
endpointId = json['endpointId'];
endpointName = json['endpointName'];
dateCompleted = json['dateCompleted'];
destination = json['destination'];
toAddress = json['toAddress'];
fromAddress = json['fromAddress'];
fromName = json['fromName'];
answeredByName = json['answeredByName'];
queueMemberId = json['queueMemberId'];
channel = JsonConverters.fromJson(json['channel'],'FlowChannels',context!);
ended = json['ended'];
outcome = json['outcome'];
callSid = json['callSid'];
consoleData = json['consoleData'];
holdQueueName = json['holdQueueName'];
heldByUserId = json['heldByUserId'];
holdReason = JsonConverters.fromJson(json['holdReason'],'SessionHoldReasons',context!);
conferenceSid = json['conferenceSid'];
displayName = json['displayName'];
log = JsonConverters.fromJson(json['log'],'List<SessionLogInfo>',context!);
members = JsonConverters.fromJson(json['members'],'List<SessionMemberInfo>',context!);
callbackNumber = json['callbackNumber'];
answeredById = json['answeredById'];
direction = JsonConverters.fromJson(json['direction'],'SessionDirections',context!);
fromPhoneNumber = json['fromPhoneNumber'];
mostRecentParticipantCallSid = json['mostRecentParticipantCallSid'];
wasMissed = json['wasMissed'];
ringQueueId = json['ringQueueId'];
return this;
}
Map<String, dynamic> toJson() => super.toJson()..addAll({
'dialState': JsonConverters.toJson(dialState,'SessionDialState',context!),
'callState': JsonConverters.toJson(callState,'SessionCallState',context!),
'queueState': JsonConverters.toJson(queueState,'SessionQueueStates',context!),
'accountId': accountId,
'accountName': accountName,
'customerId': customerId,
'customerBreadcrumb': JsonConverters.toJson(customerBreadcrumb,'List<CustomerBreadcrumb>',context!),
'customerName': customerName,
'endpointId': endpointId,
'endpointName': endpointName,
'dateCompleted': dateCompleted,
'destination': destination,
'toAddress': toAddress,
'fromAddress': fromAddress,
'fromName': fromName,
'answeredByName': answeredByName,
'queueMemberId': queueMemberId,
'channel': JsonConverters.toJson(channel,'FlowChannels',context!),
'ended': ended,
'outcome': outcome,
'callSid': callSid,
'consoleData': consoleData,
'holdQueueName': holdQueueName,
'heldByUserId': heldByUserId,
'holdReason': JsonConverters.toJson(holdReason,'SessionHoldReasons',context!),
'conferenceSid': conferenceSid,
'displayName': displayName,
'log': JsonConverters.toJson(log,'List<SessionLogInfo>',context!),
'members': JsonConverters.toJson(members,'List<SessionMemberInfo>',context!),
'callbackNumber': callbackNumber,
'answeredById': answeredById,
'direction': JsonConverters.toJson(direction,'SessionDirections',context!),
'fromPhoneNumber': fromPhoneNumber,
'mostRecentParticipantCallSid': mostRecentParticipantCallSid,
'wasMissed': wasMissed,
'ringQueueId': ringQueueId
});
getTypeName() => "SessionInfo";
TypeContext? context = _ctx;
}
/**
* Create a new session
*/
// @Api(Description="Create a new session")
class NewSession implements IPost, IConvertible
{
/**
* A display name for this session
*/
// @ApiMember(Description="A display name for this session")
String? displayName;
/**
* The type of session
*/
// @ApiMember(Description="The type of session")
FlowChannels? channel;
/**
* The session direction (defaults to Outgoing)
*/
// @ApiMember(Description="The session direction (defaults to Outgoing)")
SessionDirections? direction;
/**
* The current session call state (defaults to Connected)
*/
// @ApiMember(Description="The current session call state (defaults to Connected)")
SessionCallState? callState;
/**
* The From address for the session (defaults to user's email)
*/
// @ApiMember(Description="The From address for the session (defaults to user's email)")
String? fromAddress;
/**
* The From name for the session
*/
// @ApiMember(Description="The From name for the session")
String? fromName;
/**
* The To address for the session
*/
// @ApiMember(Description="The To address for the session")
String? toAddress;
/**
* Parent session (e.g. for billing purposes)
*/
// @ApiMember(Description="Parent session (e.g. for billing purposes)")
String? parentSessionId;
/**
* Specify a customer to associate with this session
*/
// @ApiMember(Description="Specify a customer to associate with this session")
String? customerId;
/**
* Start a chat session with a specified user/team (e.g. user:userid or team:teamid)
*/
// @ApiMember(Description="Start a chat session with a specified user/team (e.g. user:userid or team:teamid)")
String? withAddress;
/**
* Use the specified caller ID (if dialing out)
*/
// @ApiMember(Description="Use the specified caller ID (if dialing out)")
String? fromPhoneNumber;
/**
* The dialed destination value
*/
// @ApiMember(Description="The dialed destination value")
String? destination;
/**
* User email addresses to add as members
*/
// @ApiMember(Description="User email addresses to add as members")
List<String>? memberEmailAddresses;
/**
* Start the session's flow?
*/
// @ApiMember(Description="Start the session's flow?")
bool? startSession;
NewSession({this.displayName,this.channel,this.direction,this.callState,this.fromAddress,this.fromName,this.toAddress,this.parentSessionId,this.customerId,this.withAddress,this.fromPhoneNumber,this.destination,this.memberEmailAddresses,this.startSession});
NewSession.fromJson(Map<String, dynamic> json) { fromMap(json); }
fromMap(Map<String, dynamic> json) {
displayName = json['displayName'];
channel = JsonConverters.fromJson(json['channel'],'FlowChannels',context!);
direction = JsonConverters.fromJson(json['direction'],'SessionDirections',context!);
callState = JsonConverters.fromJson(json['callState'],'SessionCallState',context!);
fromAddress = json['fromAddress'];
fromName = json['fromName'];
toAddress = json['toAddress'];
parentSessionId = json['parentSessionId'];
customerId = json['customerId'];
withAddress = json['withAddress'];
fromPhoneNumber = json['fromPhoneNumber'];
destination = json['destination'];
memberEmailAddresses = JsonConverters.fromJson(json['memberEmailAddresses'],'List<String>',context!);
startSession = json['startSession'];
return this;
}
Map<String, dynamic> toJson() => {
'displayName': displayName,
'channel': JsonConverters.toJson(channel,'FlowChannels',context!),
'direction': JsonConverters.toJson(direction,'SessionDirections',context!),
'callState': JsonConverters.toJson(callState,'SessionCallState',context!),
'fromAddress': fromAddress,
'fromName': fromName,
'toAddress': toAddress,
'parentSessionId': parentSessionId,
'customerId': customerId,
'withAddress': withAddress,
'fromPhoneNumber': fromPhoneNumber,
'destination': destination,
'memberEmailAddresses': JsonConverters.toJson(memberEmailAddresses,'List<String>',context!),
'startSession': startSession
};
getTypeName() => "NewSession";
TypeContext? context = _ctx;
}
TypeContext _ctx = TypeContext(library: 'evovoice.io', types: <String, TypeInfo> {
'EntityInfo': TypeInfo(TypeOf.AbstractClass),
'SessionDialState': TypeInfo(TypeOf.Enum, enumValues:SessionDialState.values),
'SessionCallState': TypeInfo(TypeOf.Enum, enumValues:SessionCallState.values),
'SessionQueueStates': TypeInfo(TypeOf.Enum, enumValues:SessionQueueStates.values),
'CustomerBreadcrumb': TypeInfo(TypeOf.Class, create:() => CustomerBreadcrumb()),
'FlowChannels': TypeInfo(TypeOf.Enum, enumValues:FlowChannels.values),
'SessionHoldReasons': TypeInfo(TypeOf.Enum, enumValues:SessionHoldReasons.values),
'SessionLogInfo': TypeInfo(TypeOf.Class, create:() => SessionLogInfo()),
'SessionMemberCallState': TypeInfo(TypeOf.Enum, enumValues:SessionMemberCallState.values),
'SessionMemberRoles': TypeInfo(TypeOf.Enum, enumValues:SessionMemberRoles.values),
'SessionMemberInfo': TypeInfo(TypeOf.Class, create:() => SessionMemberInfo()),
'SessionDirections': TypeInfo(TypeOf.Enum, enumValues:SessionDirections.values),
'SessionInfo': TypeInfo(TypeOf.Class, create:() => SessionInfo()),
'List<CustomerBreadcrumb>': TypeInfo(TypeOf.Class, create:() => <CustomerBreadcrumb>[]),
'List<SessionLogInfo>': TypeInfo(TypeOf.Class, create:() => <SessionLogInfo>[]),
'List<SessionMemberInfo>': TypeInfo(TypeOf.Class, create:() => <SessionMemberInfo>[]),
'NewSession': TypeInfo(TypeOf.Class, create:() => NewSession()),
});
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 HTTP/1.1
Host: evovoice.io
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<NewSession xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Sessions">
<CallState>Disconnected</CallState>
<Channel>Voice</Channel>
<CustomerId>String</CustomerId>
<Destination>String</Destination>
<Direction>Incoming</Direction>
<DisplayName>String</DisplayName>
<FromAddress>String</FromAddress>
<FromName>String</FromName>
<FromPhoneNumber>String</FromPhoneNumber>
<MemberEmailAddresses xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d2p1:string>String</d2p1:string>
</MemberEmailAddresses>
<ParentSessionId>String</ParentSessionId>
<StartSession>false</StartSession>
<ToAddress>String</ToAddress>
<WithAddress>String</WithAddress>
</NewSession>
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>