Evo Voice

<back to all web services

AppGetHomeInformation

Requires Authentication
The following routes are available for this service:
GET/portal/home
import java.math.*
import java.util.*
import net.servicestack.client.*
import com.google.gson.annotations.*
import com.google.gson.reflect.*


open class AppGetHomeInformation
{
    var accountId:String? = null
    var customerId:String? = null
    var fromDate:String? = null
}

open class AppHomeInformation
{
    var isHostedSuiteCustomer:Boolean? = null
    var conversations:ArrayList<ConversationInfo> = ArrayList<ConversationInfo>()
    var calls:ArrayList<SessionInfo> = ArrayList<SessionInfo>()
    var callMetrics:ArrayList<AppHomeCallMetric> = ArrayList<AppHomeCallMetric>()
    var voicemail:ArrayList<FileInfo> = ArrayList<FileInfo>()
    var forms:ArrayList<HostedSuiteCompletedForm> = ArrayList<HostedSuiteCompletedForm>()
}

open class ConversationInfo
{
    var id:String? = null
    var endpointId:String? = null
    var otherAddress:String? = null
    var mostRecentMessage:MessageInfo? = null
}

open class MessageInfo
{
    var id:String? = null
    var accountId:String? = null
    var customerId:String? = null
    var endpointId:String? = null
    var endpointDisplayName:String? = null
    var date:String? = null
    var direction:MessageDirections? = null
    var otherAddress:String? = null
    var sender:String? = null
    var text:String? = null
    var isUnread:Boolean? = null
}

enum class MessageDirections
{
    Incoming,
    Outgoing,
}

open class SessionInfo : EntityInfo()
{
    /**
    * The state of the session
    */
    @ApiMember(Description="The state of the session")
    var dialState:SessionDialState? = null

    /**
    * The call state of the session
    */
    @ApiMember(Description="The call state of the session")
    var callState:SessionCallState? = null

    /**
    * The queue state of the session
    */
    @ApiMember(Description="The queue state of the session")
    var queueState:SessionQueueStates? = null

    /**
    * The ID of the account associated with the flow
    */
    @ApiMember(Description="The ID of the account associated with the flow")
    var accountId:String? = null

    /**
    * The name of the account associated with the session
    */
    @ApiMember(Description="The name of the account associated with the session")
    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")
    var customerId:String? = null

    /**
    * The customer breadcrumb this session is associated with
    */
    @ApiMember(Description="The customer breadcrumb this session is associated with")
    var customerBreadcrumb:ArrayList<CustomerBreadcrumb> = ArrayList<CustomerBreadcrumb>()

    /**
    * The name of the customer this session is associated with
    */
    @ApiMember(Description="The name of the customer this session is associated with")
    var customerName:String? = null

    /**
    * The ID of the endpoint associated with this session
    */
    @ApiMember(Description="The ID of the endpoint associated with this session")
    var endpointId:String? = null

    /**
    * The name of the endpoint associated with this session
    */
    @ApiMember(Description="The name of the endpoint associated with this session")
    var endpointName:String? = null

    /**
    * The date the call completed
    */
    @ApiMember(Description="The date the call completed")
    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)")
    var destination:String? = null

    /**
    * The to address if any
    */
    @ApiMember(Description="The to address if any")
    var toAddress:String? = null

    /**
    * The from address if any
    */
    @ApiMember(Description="The from address if any")
    var fromAddress:String? = null

    /**
    * The from name if any
    */
    @ApiMember(Description="The from name if any")
    var fromName:String? = null

    /**
    * Answered by name (if any)
    */
    @ApiMember(Description="Answered by name (if any)")
    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")
    var queueMemberId:String? = null

    /**
    * The flow channel
    */
    @ApiMember(Description="The flow channel")
    var channel:FlowChannels? = null

    /**
    * Has the session ended
    */
    @ApiMember(Description="Has the session ended")
    var ended:Boolean? = null

    /**
    * The outcome of the call
    */
    @ApiMember(Description="The outcome of the call")
    var outcome:String? = null

    /**
    * The twilio Call SID of this session
    */
    @ApiMember(Description="The twilio Call SID of this session")
    var callSid:String? = null

    /**
    * Any console data for this session
    */
    @ApiMember(Description="Any console data for this session")
    var consoleData:String? = null

    /**
    * The name of the hold queue for this call
    */
    @ApiMember(Description="The name of the hold queue for this call")
    var holdQueueName:String? = null

    /**
    * The user ID who put this call on hold
    */
    @ApiMember(Description="The user ID who put this call on hold")
    var heldByUserId:String? = null

    /**
    * The reason for the hold
    */
    @ApiMember(Description="The reason for the hold")
    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")
    var conferenceSid:String? = null

    /**
    * The display name for this session
    */
    @ApiMember(Description="The display name for this session")
    var displayName:String? = null

    /**
    * The log entries for this session
    */
    @ApiMember(Description="The log entries for this session")
    var log:ArrayList<SessionLogInfo> = ArrayList<SessionLogInfo>()

    /**
    * The members of this session
    */
    @ApiMember(Description="The members of this session")
    var members:ArrayList<SessionMemberInfo> = ArrayList<SessionMemberInfo>()

    /**
    * The callback number (typically used for SIP to User calls)
    */
    @ApiMember(Description="The callback number (typically used for SIP to User calls)")
    var callbackNumber:String? = null

    /**
    * The ID of the endpoint that answered
    */
    @ApiMember(Description="The ID of the endpoint that answered")
    var answeredById:String? = null

    /**
    * Is this session incoming or outgoing?
    */
    @ApiMember(Description="Is this session incoming or outgoing?")
    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)")
    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")
    var mostRecentParticipantCallSid:String? = null

    /**
    * Was this session missed?
    */
    @ApiMember(Description="Was this session missed?")
    var wasMissed:Boolean? = null

    /**
    * The ring queue that the call is currently in
    */
    @ApiMember(Description="The ring queue that the call is currently in")
    var ringQueueId:String? = null
}

open class EntityInfo
{
    /**
    * The ID of the object
    */
    @ApiMember(Description="The ID of the object")
    var id:String? = null

    /**
    * The date the object was created
    */
    @ApiMember(Description="The date the object was created")
    var dateCreated:String? = null

    /**
    * The date the object was last modified
    */
    @ApiMember(Description="The date the object was last modified")
    var dateLastModified:String? = null

    /**
    * The user that created this object
    */
    @ApiMember(Description="The user that created this object")
    var createdBy:String? = null

    /**
    * The user that last modified this object
    */
    @ApiMember(Description="The user that last modified this object")
    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
{
    var id:String? = null
    var name:String? = null
}

enum class FlowChannels
{
    Voice,
    Chat,
    Fax,
}

enum class SessionHoldReasons
{
    None,
    Transferring,
}

open class SessionLogInfo
{
    var date:String? = null
    var message:String? = null
}

open class SessionMemberInfo
{
    var identity:String? = null
    var endpointId:String? = null
    var displayName:String? = null
    var isOriginalMember:Boolean? = null
    var avatarUrl:String? = null
    var applicationData:HashMap<String,String> = HashMap<String,String>()
    var callState:SessionMemberCallState? = null
    var role:SessionMemberRoles? = null
    var callSid:String? = null
    var muted:Boolean? = null
}

enum class SessionMemberCallState
{
    None,
    Ringing,
    Connected,
    Hold,
}

enum class SessionMemberRoles
{
    None,
    Caller,
    Agent,
    Transfer,
}

enum class SessionDirections
{
    Incoming,
    Outgoing,
}

open class AppHomeCallMetric
{
    var metricKey:String? = null
    var total:Double? = null
    var average:Double? = null
}

open class FileInfo : EntityInfo()
{
    /**
    * The type of file this is
    */
    @ApiMember(Description="The type of file this is")
    @SerializedName("type") var Type:FileTypes? = null

    /**
    * The account ID this file is associated with
    */
    @ApiMember(Description="The account ID this file is associated with")
    var accountId:String? = null

    /**
    * The name of the account this file is associated with
    */
    @ApiMember(Description="The name of the account this file is associated with")
    var accountName:String? = null

    /**
    * The ID of the customer this file is associated with
    */
    @ApiMember(Description="The ID of the customer this file is associated with")
    var customerId:String? = null

    /**
    * The name of the customer this file is associated with
    */
    @ApiMember(Description="The name of the customer this file is associated with")
    var customerName:String? = null

    /**
    * The breadcrumb to the customer for this file
    */
    @ApiMember(Description="The breadcrumb to the customer for this file")
    var customerBreadcrumb:ArrayList<CustomerBreadcrumb> = ArrayList<CustomerBreadcrumb>()

    /**
    * The ID of the user this file is assocaited with
    */
    @ApiMember(Description="The ID of the user this file is assocaited with")
    var userId:String? = null

    /**
    * The name of the user this file is associated with
    */
    @ApiMember(Description="The name of the user this file is associated with")
    var userName:String? = null

    /**
    * The original file name for the file
    */
    @ApiMember(Description="The original file name for the file")
    var fileName:String? = null

    /**
    * The URI of the file
    */
    @ApiMember(Description="The URI of the file")
    var uri:String? = null

    /**
    * The Content type of the file
    */
    @ApiMember(Description="The Content type of the file")
    var contentType:String? = null

    /**
    * The size of the file
    */
    @ApiMember(Description="The size of the file")
    var contentLength:Long? = null

    /**
    * The Twilio ID of the recording
    */
    @ApiMember(Description="The Twilio ID of the recording")
    var recordingSid:String? = null

    /**
    * The duration of the recording in seconds
    */
    @ApiMember(Description="The duration of the recording in seconds")
    var recordingDuration:Int? = null

    /**
    * Who is the recording from?
    */
    @ApiMember(Description="Who is the recording from?")
    var recordingFrom:String? = null

    /**
    * Transcription (if available)
    */
    @ApiMember(Description="Transcription (if available)")
    var transcription:String? = null

    /**
    * From Address (e.g. caller ID) for incoming calls
    */
    @ApiMember(Description="From Address (e.g. caller ID) for incoming calls")
    var fromAddress:String? = null

    /**
    * To Address (e.g. dialed number) for outgoing calls
    */
    @ApiMember(Description="To Address (e.g. dialed number) for outgoing calls")
    var toAddress:String? = null
}

enum class FileTypes
{
    Upload,
    VoiceMessage,
    CallRecording,
    Fax,
    Attachment,
    FaxOutgoing,
}

open class HostedSuiteCompletedForm
{
    var id:String? = null
    var name:String? = null
    var dateCreated:String? = null
    var dateCompleted:String? = null
    var formId:String? = null
    var formName:String? = null
    var clientId:String? = null
    var clientName:String? = null
    var contactId:String? = null
    var contactName:String? = null
    var contactsIds:ArrayList<String> = ArrayList<String>()
    var contactsNames:ArrayList<String> = ArrayList<String>()
    var emailSubject:String? = null
    var callerNumber:String? = null
    var fields:ArrayList<HostedSuiteCompletedFormField> = ArrayList<HostedSuiteCompletedFormField>()
}

open class HostedSuiteCompletedFormField
{
    var name:String? = null
    var values:ArrayList<String> = ArrayList<String>()
}

Kotlin AppGetHomeInformation DTOs

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

GET /portal/home HTTP/1.1 
Host: evovoice.io 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"isHostedSuiteCustomer":false,"conversations":[{"id":"String","endpointId":"String","otherAddress":"String","mostRecentMessage":{"id":"String","accountId":"String","customerId":"String","endpointId":"String","endpointDisplayName":"String","date":"String","direction":"Incoming","otherAddress":"String","sender":"String","text":"String","isUnread":false}}],"calls":[{"dialState":"None","callState":"Disconnected","queueState":"None","accountId":"String","accountName":"String","customerId":"String","customerBreadcrumb":[{"id":"String","name":"String"}],"customerName":"String","endpointId":"String","endpointName":"String","dateCompleted":"String","destination":"String","toAddress":"String","fromAddress":"String","fromName":"String","answeredByName":"String","queueMemberId":"String","channel":"Voice","ended":false,"outcome":"String","callSid":"String","consoleData":"String","holdQueueName":"String","heldByUserId":"String","holdReason":"None","conferenceSid":"String","displayName":"String","log":[{"date":"String","message":"String"}],"members":[{"identity":"String","endpointId":"String","displayName":"String","isOriginalMember":false,"avatarUrl":"String","applicationData":{"String":"String"},"callState":"None","role":"None","callSid":"String","muted":false}],"callbackNumber":"String","answeredById":"String","direction":"Incoming","fromPhoneNumber":"String","mostRecentParticipantCallSid":"String","wasMissed":false,"ringQueueId":"String","id":"String","dateCreated":"String","dateLastModified":"String","createdBy":"String","lastModifiedBy":"String"}],"callMetrics":[{"metricKey":"String","total":0,"average":0}],"voicemail":[{"type":"Upload","accountId":"String","accountName":"String","customerId":"String","customerName":"String","customerBreadcrumb":[{"id":"String","name":"String"}],"userId":"String","userName":"String","fileName":"String","uri":"String","contentType":"String","contentLength":0,"recordingSid":"String","recordingDuration":0,"recordingFrom":"String","transcription":"String","fromAddress":"String","toAddress":"String","id":"String","dateCreated":"String","dateLastModified":"String","createdBy":"String","lastModifiedBy":"String"}],"forms":[{"id":"String","name":"String","dateCreated":"String","dateCompleted":"String","formId":"String","formName":"String","clientId":"String","clientName":"String","contactId":"String","contactName":"String","contactsIds":["String"],"contactsNames":["String"],"emailSubject":"String","callerNumber":"String","fields":[{"name":"String","values":["String"]}]}]}