Evo Voice

<back to all web services

AppGetCallHistory

Requires Authentication
The following routes are available for this service:
GET/portal/call-history
"use strict";
/** @typedef {'Ascend'|'Descend'} */
export var SortOrders;
(function (SortOrders) {
    SortOrders["Ascend"] = "Ascend"
    SortOrders["Descend"] = "Descend"
})(SortOrders || (SortOrders = {}));
/** @typedef T {any} */
export class ListRequest {
    /** @param {{page?:number,all?:boolean,countPerPage?:number,specificIds?:string[],sortField?:string,sortOrder?:SortOrders,simplifiedPaging?:boolean}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description The page of data to retrieve */
    page;
    /**
     * @type {boolean}
     * @description If you want all objects to be returned. This should be used with care */
    all;
    /**
     * @type {number}
     * @description The number per page to retrieve */
    countPerPage;
    /**
     * @type {string[]}
     * @description Specific IDs */
    specificIds;
    /**
     * @type {string}
     * @description Specify a sort field */
    sortField;
    /**
     * @type {SortOrders}
     * @description Specify a sort order */
    sortOrder;
    /**
     * @type {boolean}
     * @description Disables total / page counts - improves performance. Returns only data. If there is no more data, Items will be empty array */
    simplifiedPaging;
}
export class EntityInfo {
    /** @param {{id?:string,dateCreated?:string,dateLastModified?:string,createdBy?:string,lastModifiedBy?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description The ID of the object */
    id;
    /**
     * @type {string}
     * @description The date the object was created */
    dateCreated;
    /**
     * @type {string}
     * @description The date the object was last modified */
    dateLastModified;
    /**
     * @type {string}
     * @description The user that created this object */
    createdBy;
    /**
     * @type {string}
     * @description The user that last modified this object */
    lastModifiedBy;
}
/** @typedef {'None'|'Active'} */
export var SessionDialState;
(function (SessionDialState) {
    SessionDialState["None"] = "None"
    SessionDialState["Active"] = "Active"
})(SessionDialState || (SessionDialState = {}));
/** @typedef {'Disconnected'|'Ringing'|'Connected'|'Hold'|'Passive'} */
export var SessionCallState;
(function (SessionCallState) {
    SessionCallState["Disconnected"] = "Disconnected"
    SessionCallState["Ringing"] = "Ringing"
    SessionCallState["Connected"] = "Connected"
    SessionCallState["Hold"] = "Hold"
    SessionCallState["Passive"] = "Passive"
})(SessionCallState || (SessionCallState = {}));
/** @typedef {'None'|'Queued'|'Ringing'|'Connected'|'Hold'|'Disconnected'} */
export var SessionQueueStates;
(function (SessionQueueStates) {
    SessionQueueStates["None"] = "None"
    SessionQueueStates["Queued"] = "Queued"
    SessionQueueStates["Ringing"] = "Ringing"
    SessionQueueStates["Connected"] = "Connected"
    SessionQueueStates["Hold"] = "Hold"
    SessionQueueStates["Disconnected"] = "Disconnected"
})(SessionQueueStates || (SessionQueueStates = {}));
export class CustomerBreadcrumb {
    /** @param {{id?:string,name?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {string} */
    id;
    /** @type {string} */
    name;
}
/** @typedef {'Voice'|'Chat'|'Fax'} */
export var FlowChannels;
(function (FlowChannels) {
    FlowChannels["Voice"] = "Voice"
    FlowChannels["Chat"] = "Chat"
    FlowChannels["Fax"] = "Fax"
})(FlowChannels || (FlowChannels = {}));
/** @typedef {'None'|'Transferring'} */
export var SessionHoldReasons;
(function (SessionHoldReasons) {
    SessionHoldReasons["None"] = "None"
    SessionHoldReasons["Transferring"] = "Transferring"
})(SessionHoldReasons || (SessionHoldReasons = {}));
export class SessionLogInfo {
    /** @param {{date?:string,message?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {string} */
    date;
    /** @type {string} */
    message;
}
/** @typedef {'None'|'Ringing'|'Connected'|'Hold'} */
export var SessionMemberCallState;
(function (SessionMemberCallState) {
    SessionMemberCallState["None"] = "None"
    SessionMemberCallState["Ringing"] = "Ringing"
    SessionMemberCallState["Connected"] = "Connected"
    SessionMemberCallState["Hold"] = "Hold"
})(SessionMemberCallState || (SessionMemberCallState = {}));
/** @typedef {'None'|'Caller'|'Agent'|'Transfer'} */
export var SessionMemberRoles;
(function (SessionMemberRoles) {
    SessionMemberRoles["None"] = "None"
    SessionMemberRoles["Caller"] = "Caller"
    SessionMemberRoles["Agent"] = "Agent"
    SessionMemberRoles["Transfer"] = "Transfer"
})(SessionMemberRoles || (SessionMemberRoles = {}));
export class SessionMemberInfo {
    /** @param {{identity?:string,endpointId?:string,displayName?:string,isOriginalMember?:boolean,avatarUrl?:string,applicationData?:{ [index:string]: string; },callState?:SessionMemberCallState,role?:SessionMemberRoles,callSid?:string,muted?:boolean}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {string} */
    identity;
    /** @type {string} */
    endpointId;
    /** @type {string} */
    displayName;
    /** @type {boolean} */
    isOriginalMember;
    /** @type {string} */
    avatarUrl;
    /** @type {{ [index:string]: string; }} */
    applicationData;
    /** @type {SessionMemberCallState} */
    callState;
    /** @type {SessionMemberRoles} */
    role;
    /** @type {string} */
    callSid;
    /** @type {boolean} */
    muted;
}
/** @typedef {'Incoming'|'Outgoing'} */
export var SessionDirections;
(function (SessionDirections) {
    SessionDirections["Incoming"] = "Incoming"
    SessionDirections["Outgoing"] = "Outgoing"
})(SessionDirections || (SessionDirections = {}));
export class SessionInfo extends EntityInfo {
    /** @param {{dialState?:SessionDialState,callState?:SessionCallState,queueState?:SessionQueueStates,accountId?:string,accountName?:string,customerId?:string,customerBreadcrumb?:CustomerBreadcrumb[],customerName?:string,endpointId?:string,endpointName?:string,dateCompleted?:string,destination?:string,toAddress?:string,fromAddress?:string,fromName?:string,answeredByName?:string,queueMemberId?:string,channel?:FlowChannels,ended?:boolean,outcome?:string,callSid?:string,consoleData?:string,holdQueueName?:string,heldByUserId?:string,holdReason?:SessionHoldReasons,conferenceSid?:string,displayName?:string,log?:SessionLogInfo[],members?:SessionMemberInfo[],callbackNumber?:string,answeredById?:string,direction?:SessionDirections,fromPhoneNumber?:string,mostRecentParticipantCallSid?:string,wasMissed?:boolean,ringQueueId?:string,id?:string,dateCreated?:string,dateLastModified?:string,createdBy?:string,lastModifiedBy?:string}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /**
     * @type {SessionDialState}
     * @description The state of the session */
    dialState;
    /**
     * @type {SessionCallState}
     * @description The call state of the session */
    callState;
    /**
     * @type {SessionQueueStates}
     * @description The queue state of the session */
    queueState;
    /**
     * @type {string}
     * @description The ID of the account associated with the flow */
    accountId;
    /**
     * @type {string}
     * @description The name of the account associated with the session */
    accountName;
    /**
     * @type {string}
     * @description The ID of the customer this session is associated with */
    customerId;
    /**
     * @type {CustomerBreadcrumb[]}
     * @description The customer breadcrumb this session is associated with */
    customerBreadcrumb;
    /**
     * @type {string}
     * @description The name of the customer this session is associated with */
    customerName;
    /**
     * @type {string}
     * @description The ID of the endpoint associated with this session */
    endpointId;
    /**
     * @type {string}
     * @description The name of the endpoint associated with this session */
    endpointName;
    /**
     * @type {string}
     * @description The date the call completed */
    dateCompleted;
    /**
     * @type {string}
     * @description The destination of the session (e.g. what was entered into the Dial box) */
    destination;
    /**
     * @type {string}
     * @description The to address if any */
    toAddress;
    /**
     * @type {string}
     * @description The from address if any */
    fromAddress;
    /**
     * @type {string}
     * @description The from name if any */
    fromName;
    /**
     * @type {string}
     * @description Answered by name (if any) */
    answeredByName;
    /**
     * @type {string}
     * @description The ID of the queue member assigned to this call */
    queueMemberId;
    /**
     * @type {FlowChannels}
     * @description The flow channel */
    channel;
    /**
     * @type {boolean}
     * @description Has the session ended */
    ended;
    /**
     * @type {string}
     * @description The outcome of the call */
    outcome;
    /**
     * @type {string}
     * @description The twilio Call SID of this session */
    callSid;
    /**
     * @type {string}
     * @description Any console data for this session */
    consoleData;
    /**
     * @type {string}
     * @description The name of the hold queue for this call */
    holdQueueName;
    /**
     * @type {string}
     * @description The user ID who put this call on hold */
    heldByUserId;
    /**
     * @type {SessionHoldReasons}
     * @description The reason for the hold */
    holdReason;
    /**
     * @type {string}
     * @description The SID of the conference if in a conference call */
    conferenceSid;
    /**
     * @type {string}
     * @description The display name for this session */
    displayName;
    /**
     * @type {SessionLogInfo[]}
     * @description The log entries for this session */
    log;
    /**
     * @type {SessionMemberInfo[]}
     * @description The members of this session */
    members;
    /**
     * @type {string}
     * @description The callback number (typically used for SIP to User calls) */
    callbackNumber;
    /**
     * @type {string}
     * @description The ID of the endpoint that answered */
    answeredById;
    /**
     * @type {SessionDirections}
     * @description Is this session incoming or outgoing? */
    direction;
    /**
     * @type {string}
     * @description The phone number that this session is coming from (used with SMS chats) */
    fromPhoneNumber;
    /**
     * @type {string}
     * @description The Call SID of the most recently added conference participant */
    mostRecentParticipantCallSid;
    /**
     * @type {boolean}
     * @description Was this session missed? */
    wasMissed;
    /**
     * @type {string}
     * @description The ring queue that the call is currently in */
    ringQueueId;
}
export class AppGetCallHistory extends ListRequest {
    /** @param {{accountId?:string,customerId?:string,page?:number,all?:boolean,countPerPage?:number,specificIds?:string[],sortField?:string,sortOrder?:SortOrders,simplifiedPaging?:boolean}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /** @type {string} */
    accountId;
    /** @type {string} */
    customerId;
}
export class BillingItem {
    /** @param {{baseCost?:number,rawUnitMultiplier?:number,unitCost?:number,allowance?:number}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {number} */
    baseCost;
    /** @type {number} */
    rawUnitMultiplier;
    /** @type {number} */
    unitCost;
    /** @type {number} */
    allowance;
}
export class BillingSettings {
    /** @param {{base?:BillingItem,localNumbers?:BillingItem,tollFreeNumbers?:BillingItem,inboundVoiceCalls?:BillingItem,outboundVoiceCalls?:BillingItem,inboundFaxes?:BillingItem,outboundFaxes?:BillingItem,inboundSmsMessages?:BillingItem,outboundSmsMessages?:BillingItem,aiInsights?:BillingItem,aiLiveMinutes?:BillingItem}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {BillingItem} */
    base;
    /** @type {BillingItem} */
    localNumbers;
    /** @type {BillingItem} */
    tollFreeNumbers;
    /** @type {BillingItem} */
    inboundVoiceCalls;
    /** @type {BillingItem} */
    outboundVoiceCalls;
    /** @type {BillingItem} */
    inboundFaxes;
    /** @type {BillingItem} */
    outboundFaxes;
    /** @type {BillingItem} */
    inboundSmsMessages;
    /** @type {BillingItem} */
    outboundSmsMessages;
    /** @type {BillingItem} */
    aiInsights;
    /** @type {BillingItem} */
    aiLiveMinutes;
}
export class AccountInfo extends EntityInfo {
    /** @param {{name?:string,parentAccountId?:string,twilioAccountSid?:string,ancestorIds?:string[],maxPhoneNumbers?:number,isBYOA?:boolean,trustHubProfileSid?:string,logoId?:string,logoUri?:string,billingSettings?:BillingSettings,id?:string,dateCreated?:string,dateLastModified?:string,createdBy?:string,lastModifiedBy?:string}} [init] */
    constructor(init) { super(init); Object.assign(this, init) }
    /**
     * @type {string}
     * @description The name of this account */
    name;
    /**
     * @type {string}
     * @description The ID of this account's parent */
    parentAccountId;
    /**
     * @type {string}
     * @description The twilio account SID */
    twilioAccountSid;
    /**
     * @type {string[]}
     * @description The ancestors of this account. Useful for breadcrumbs */
    ancestorIds;
    /**
     * @type {number}
     * @description The max number of phone numbers this account can have */
    maxPhoneNumbers;
    /**
     * @type {boolean}
     * @description This account is BYOA */
    isBYOA;
    /**
     * @type {string}
     * @description TrustHub Profile Sid */
    trustHubProfileSid;
    /**
     * @type {string}
     * @description The ID of the logo file */
    logoId;
    /**
     * @type {string}
     * @description The URI of the logo file */
    logoUri;
    /**
     * @type {BillingSettings}
     * @description The billing settings for this account */
    billingSettings;
}
/** @typedef T {any} */
export class ListResponse {
    /** @param {{items?:AccountInfo[],totalCount?:number,totalPages?:number,hasMorePages?:boolean}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {AccountInfo[]}
     * @description The items */
    items;
    /**
     * @type {number}
     * @description The total number of items */
    totalCount;
    /**
     * @type {number}
     * @description The total number of pages */
    totalPages;
    /**
     * @type {boolean}
     * @description Are there more pages of items? Used with simplified paging */
    hasMorePages;
}

JavaScript AppGetCallHistory DTOs

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

HTTP + JSV

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

GET /portal/call-history HTTP/1.1 
Host: team.evovoice.io 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	items: 
	[
		{
			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
		}
	],
	totalCount: 0,
	totalPages: 0,
	hasMorePages: False
}