Evo Voice

<back to all web services

GetMySessions

Get all your active sessions

Requires Authentication
Required role:User
The following routes are available for this service:
GET/sessions/my
GetMySessionsResponse Parameters:
NameParameterData TypeRequiredDescription
SessionsformList<SessionInfo>No
SessionInfo Parameters:
NameParameterData TypeRequiredDescription
DialStateformSessionDialStateNoThe state of the session
CallStateformSessionCallStateNoThe call state of the session
QueueStateformSessionQueueStatesNoThe queue state of the session
AccountIdformstringNoThe ID of the account associated with the flow
AccountNameformstringNoThe name of the account associated with the session
CustomerIdformstringNoThe ID of the customer this session is associated with
CustomerBreadcrumbformList<CustomerBreadcrumb>NoThe customer breadcrumb this session is associated with
CustomerNameformstringNoThe name of the customer this session is associated with
EndpointIdformstringNoThe ID of the endpoint associated with this session
EndpointNameformstringNoThe name of the endpoint associated with this session
DateCompletedformstringNoThe date the call completed
DestinationformstringNoThe destination of the session (e.g. what was entered into the Dial box)
ToAddressformstringNoThe to address if any
FromAddressformstringNoThe from address if any
FromNameformstringNoThe from name if any
AnsweredByNameformstringNoAnswered by name (if any)
QueueMemberIdformstringNoThe ID of the queue member assigned to this call
ChannelformFlowChannelsNoThe flow channel
EndedformboolNoHas the session ended
OutcomeformstringNoThe outcome of the call
CallSidformstringNoThe twilio Call SID of this session
ConsoleDataformstringNoAny console data for this session
HoldQueueNameformstringNoThe name of the hold queue for this call
HeldByUserIdformstringNoThe user ID who put this call on hold
HoldReasonformSessionHoldReasonsNoThe reason for the hold
ConferenceSidformstringNoThe SID of the conference if in a conference call
DisplayNameformstringNoThe display name for this session
LogformList<SessionLogInfo>NoThe log entries for this session
MembersformList<SessionMemberInfo>NoThe members of this session
CallbackNumberformstringNoThe callback number (typically used for SIP to User calls)
AnsweredByIdformstringNoThe ID of the endpoint that answered
DirectionformSessionDirectionsNoIs this session incoming or outgoing?
FromPhoneNumberformstringNoThe phone number that this session is coming from (used with SMS chats)
MostRecentParticipantCallSidformstringNoThe Call SID of the most recently added conference participant
WasMissedformboolNoWas this session missed?
RingQueueIdformstringNoThe ring queue that the call is currently in
EntityInfo Parameters:
NameParameterData TypeRequiredDescription
IdformstringNoThe ID of the object
DateCreatedformstringNoThe date the object was created
DateLastModifiedformstringNoThe date the object was last modified
CreatedByformstringNoThe user that created this object
LastModifiedByformstringNoThe user that last modified this object
SessionDialState Enum:
None
Active
SessionCallState Enum:
Disconnected
Ringing
Connected
Hold
Passive
SessionQueueStates Enum:
None
Queued
Ringing
Connected
Hold
Disconnected
CustomerBreadcrumb Parameters:
NameParameterData TypeRequiredDescription
IdformstringNo
NameformstringNo
FlowChannels Enum:
Voice
Chat
Fax
SessionHoldReasons Enum:
None
Transferring
SessionLogInfo Parameters:
NameParameterData TypeRequiredDescription
DateformstringNo
MessageformstringNo
SessionMemberInfo Parameters:
NameParameterData TypeRequiredDescription
IdentityformstringNo
EndpointIdformstringNo
DisplayNameformstringNo
IsOriginalMemberformboolNo
AvatarUrlformstringNo
ApplicationDataformDictionary<string, string>No
CallStateformSessionMemberCallStateNo
RoleformSessionMemberRolesNo
CallSidformstringNo
MutedformboolNo
SessionMemberCallState Enum:
None
Ringing
Connected
Hold
SessionMemberRoles Enum:
None
Caller
Agent
Transfer
SessionDirections Enum:
Incoming
Outgoing

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /sessions/my HTTP/1.1 
Host: evovoice.io 
Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetMySessionsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.Sessions">
  <Sessions>
    <SessionInfo>
      <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:d4p1="http://schemas.datacontract.org/2004/07/Voice.Api.Customers">
        <d4p1:CustomerBreadcrumb>
          <d4p1:Id>String</d4p1:Id>
          <d4p1:Name>String</d4p1:Name>
        </d4p1: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:d6p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
            <d6p1:KeyValueOfstringstring>
              <d6p1:Key>String</d6p1:Key>
              <d6p1:Value>String</d6p1:Value>
            </d6p1: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>
  </Sessions>
</GetMySessionsResponse>