@or-sdk/hitl 0.36.1 → 0.36.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -0
- package/dist/cjs/api/Sessions.js.map +1 -1
- package/dist/esm/api/Sessions.js.map +1 -1
- package/dist/types/api/Agents.d.ts +0 -347
- package/dist/types/api/Agents.d.ts.map +1 -1
- package/dist/types/api/CannedMessages.d.ts +0 -168
- package/dist/types/api/CannedMessages.d.ts.map +1 -1
- package/dist/types/api/Conferences.d.ts +0 -120
- package/dist/types/api/Conferences.d.ts.map +1 -1
- package/dist/types/api/ContactRuleGroups.d.ts +0 -131
- package/dist/types/api/ContactRuleGroups.d.ts.map +1 -1
- package/dist/types/api/EventTemplates.d.ts +0 -135
- package/dist/types/api/EventTemplates.d.ts.map +1 -1
- package/dist/types/api/Filters.d.ts +0 -215
- package/dist/types/api/Filters.d.ts.map +1 -1
- package/dist/types/api/Listeners.d.ts +0 -150
- package/dist/types/api/Listeners.d.ts.map +1 -1
- package/dist/types/api/Migrations.d.ts +0 -222
- package/dist/types/api/Migrations.d.ts.map +1 -1
- package/dist/types/api/RuleGroups.d.ts +0 -127
- package/dist/types/api/RuleGroups.d.ts.map +1 -1
- package/dist/types/api/SessionEvents.d.ts +0 -145
- package/dist/types/api/SessionEvents.d.ts.map +1 -1
- package/dist/types/api/Sessions.d.ts +0 -453
- package/dist/types/api/Sessions.d.ts.map +1 -1
- package/dist/types/api/Settings.d.ts +0 -145
- package/dist/types/api/Settings.d.ts.map +1 -1
- package/dist/types/types/sessions.d.ts +1 -1
- package/dist/types/types/sessions.d.ts.map +1 -1
- package/package.json +3 -3
- package/src/api/Sessions.ts +1 -0
- package/src/types/sessions.ts +1 -1
|
@@ -1,160 +1,15 @@
|
|
|
1
1
|
import { GetNewEventsCountOptions, GetNewEventsCountResponse, SaveLastReadEventOptions } from '../types/read-events';
|
|
2
2
|
import { GetSessionEventsOptions, GetSessionEventsResponse, AddEventsOptions, AddEventsResponse, GetBulkSessionEventsOptions, GetBulkSessionsEventsResponse } from '../types/session-events';
|
|
3
3
|
import { HITLBase } from './HITLBase';
|
|
4
|
-
/**
|
|
5
|
-
* Manages events for Human-in-the-Loop (HitL) sessions
|
|
6
|
-
*
|
|
7
|
-
* This class provides functionality to:
|
|
8
|
-
* - Retrieve and manage session events
|
|
9
|
-
* - Track event read status
|
|
10
|
-
* - Handle bulk event operations
|
|
11
|
-
* - Manage event counts
|
|
12
|
-
*
|
|
13
|
-
* @remarks
|
|
14
|
-
* - All methods interact with the `/session-events` endpoint
|
|
15
|
-
* @public
|
|
16
|
-
*/
|
|
17
4
|
export declare class SessionEvents extends HITLBase {
|
|
18
5
|
protected static MODULE_URL: string;
|
|
19
6
|
protected static GET_BULK_EVENTS_URL: string;
|
|
20
7
|
protected static GET_EVENTS_COUNT_URL: string;
|
|
21
8
|
protected static SAVE_READ_EVENT_URL: string;
|
|
22
|
-
/**
|
|
23
|
-
* Retrieves events for a specific HitL session
|
|
24
|
-
*
|
|
25
|
-
* @param options - Configuration parameters for retrieving session events
|
|
26
|
-
*
|
|
27
|
-
* Required parameters:
|
|
28
|
-
* - `sessionId` - (string) ID of the session to retrieve events for
|
|
29
|
-
*
|
|
30
|
-
* Optional parameters:
|
|
31
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
32
|
-
* - `version` - (string | number) API version to use
|
|
33
|
-
*
|
|
34
|
-
* @returns {Promise<SessionEvent[]>} Promise resolving to the list of session events
|
|
35
|
-
*
|
|
36
|
-
* @example
|
|
37
|
-
* ```typescript
|
|
38
|
-
* const events = await hitlApi.sessionEvents.getSessionEventsList({
|
|
39
|
-
* sessionId: 'session-id'
|
|
40
|
-
* });
|
|
41
|
-
* ```
|
|
42
|
-
*
|
|
43
|
-
* @remarks Makes a GET request to `/session-events`
|
|
44
|
-
* @public
|
|
45
|
-
*/
|
|
46
9
|
static getSessionEventsList(options: GetSessionEventsOptions): Promise<GetSessionEventsResponse>;
|
|
47
|
-
/**
|
|
48
|
-
* Retrieves events for multiple HitL sessions in bulk
|
|
49
|
-
*
|
|
50
|
-
* @param options - Configuration parameters for bulk event retrieval
|
|
51
|
-
*
|
|
52
|
-
* Required parameters:
|
|
53
|
-
* - `sessionIds` - (string[]) Array of session IDs to retrieve events for
|
|
54
|
-
*
|
|
55
|
-
* Optional parameters:
|
|
56
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
57
|
-
* - `version` - (string | number) API version to use
|
|
58
|
-
*
|
|
59
|
-
* @returns {Promise<GetBulkSessionsEventsResponse>} Promise resolving to events for multiple sessions
|
|
60
|
-
*
|
|
61
|
-
* @example
|
|
62
|
-
* ```typescript
|
|
63
|
-
* const bulkEvents = await hitlApi.sessionEvents.getBulkSessionEventsList({
|
|
64
|
-
* sessionIds: ['session-id-1', 'session-id-2']
|
|
65
|
-
* });
|
|
66
|
-
* ```
|
|
67
|
-
*
|
|
68
|
-
* @remarks Makes a POST request to `/session-events/bulk`
|
|
69
|
-
* @public
|
|
70
|
-
*/
|
|
71
10
|
static getBulkSessionEventsList(options: GetBulkSessionEventsOptions): Promise<GetBulkSessionsEventsResponse>;
|
|
72
|
-
/**
|
|
73
|
-
* Adds new events to a HITL session
|
|
74
|
-
*
|
|
75
|
-
* @param options - Configuration parameters for adding session events
|
|
76
|
-
*
|
|
77
|
-
* Required parameters:
|
|
78
|
-
* - `events` - (Partial<SessionEvent>[]) Array of partial event objects
|
|
79
|
-
* - `sessionId` - (string) ID of the session to add events to
|
|
80
|
-
*
|
|
81
|
-
* Optional parameters:
|
|
82
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
83
|
-
* - `version` - (string | number) API version to use
|
|
84
|
-
*
|
|
85
|
-
* @returns {Promise<AddEventsResult>} Promise resolving to the add operation result
|
|
86
|
-
*
|
|
87
|
-
* @example
|
|
88
|
-
* ```typescript
|
|
89
|
-
* const result = await hitlApi.sessionEvents.addEvents({
|
|
90
|
-
* sessionId: 'session-id',
|
|
91
|
-
* events: [
|
|
92
|
-
* { type: 'message', content: 'Hello' },
|
|
93
|
-
* { type: 'status', content: 'typing' }
|
|
94
|
-
* ]
|
|
95
|
-
* });
|
|
96
|
-
* ```
|
|
97
|
-
*
|
|
98
|
-
* @remarks Makes a POST request to `/session-events`
|
|
99
|
-
* @public
|
|
100
|
-
*/
|
|
101
11
|
static addEvents({ sessionId, events, ...options }: AddEventsOptions): Promise<AddEventsResponse>;
|
|
102
|
-
/**
|
|
103
|
-
* Retrieves count of unread events for specified sessions
|
|
104
|
-
*
|
|
105
|
-
* @param options - Configuration parameters for retrieving unread events count
|
|
106
|
-
*
|
|
107
|
-
* Required parameters:
|
|
108
|
-
* - `sessionIds` - (string[]) Array of session IDs to get events count for
|
|
109
|
-
*
|
|
110
|
-
* Optional parameters:
|
|
111
|
-
* - `agentId` - (string) ID of the agent to get unread events for
|
|
112
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
113
|
-
* - `version` - (string | number) API version to use
|
|
114
|
-
*
|
|
115
|
-
* @returns {Promise<NewEventsCount>} Promise resolving to the unread events count
|
|
116
|
-
*
|
|
117
|
-
* @example
|
|
118
|
-
* ```typescript
|
|
119
|
-
* // Basic usage with required parameters
|
|
120
|
-
* const count = await hitlApi.sessionEvents.getNewEventsCount({
|
|
121
|
-
* sessionIds: ['session-id-1', 'session-id-2']
|
|
122
|
-
* });
|
|
123
|
-
* ```
|
|
124
|
-
*
|
|
125
|
-
* @remarks Makes a GET request to `/sessions-events/get-new-events`
|
|
126
|
-
* @public
|
|
127
|
-
*/
|
|
128
12
|
static getNewEventsCount({ agentId, ...options }: GetNewEventsCountOptions): Promise<GetNewEventsCountResponse>;
|
|
129
|
-
/**
|
|
130
|
-
* Records the last read event for a specific session
|
|
131
|
-
*
|
|
132
|
-
* @param options - Configuration parameters for saving last read event
|
|
133
|
-
*
|
|
134
|
-
* Required parameters:
|
|
135
|
-
* - `eventId` - (string) ID of the last read event
|
|
136
|
-
* - `eventTimestamp` - (string | number) Timestamp of the last read event
|
|
137
|
-
* - `sessionId` - (string) ID of the session
|
|
138
|
-
*
|
|
139
|
-
* Optional parameters:
|
|
140
|
-
* - `agentId` - (string) ID of the agent who read the event
|
|
141
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
142
|
-
* - `version` - (string | number) API version to use
|
|
143
|
-
*
|
|
144
|
-
* @returns {Promise<void>} Promise resolving when the read status is saved
|
|
145
|
-
*
|
|
146
|
-
* @example
|
|
147
|
-
* ```typescript
|
|
148
|
-
* await hitlApi.sessionEvents.saveLastReadEvent({
|
|
149
|
-
* sessionId: 'session-id-1',
|
|
150
|
-
* eventId: 'event-id-2',
|
|
151
|
-
* eventTimestamp: Date.now()
|
|
152
|
-
* });
|
|
153
|
-
* ```
|
|
154
|
-
*
|
|
155
|
-
* @remarks Makes a POST request to `/sessions-events/save-read-event`
|
|
156
|
-
* @public
|
|
157
|
-
*/
|
|
158
13
|
static saveReadEventByUserId({ agentId, ...options }: SaveLastReadEventOptions): Promise<void>;
|
|
159
14
|
}
|
|
160
15
|
//# sourceMappingURL=SessionEvents.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SessionEvents.d.ts","sourceRoot":"","sources":["../../../src/api/SessionEvents.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"SessionEvents.d.ts","sourceRoot":"","sources":["../../../src/api/SessionEvents.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAetC,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAS,CAAC,MAAM,CAAC,UAAU,SAAoB;IAC/C,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAU;IAC9C,SAAS,CAAC,MAAM,CAAC,oBAAoB,SAAoB;IACzD,SAAS,CAAC,MAAM,CAAC,mBAAmB,SAAqB;WA0BrC,oBAAoB,CACtC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC;WAsChB,wBAAwB,CAC1C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,6BAA6B,CAAC;WA4C3B,SAAS,CACrB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,gBAAgB,GAClD,OAAO,CAAC,iBAAiB,CAAC;WAsCT,iBAAiB,CACnC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,yBAAyB,CAAC;WA6CjB,qBAAqB,CACvC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,wBAAwB,GAChD,OAAO,CAAC,IAAI,CAAC;CAejB"}
|
|
@@ -1,19 +1,5 @@
|
|
|
1
1
|
import { Session, GetSessionsOptions, GetSessionByIdOptions, GetSessionsResponse, GetQueueSessionOptions, GetQueueSessionResponse, SearchSessionsOptions, SearchSessionsResponse, SearchSessionsWithContactsOptions, SearchSessionsWithContactsResponse, GetInitTriggersOptions, GetInitTriggersResponse, ClaimSessionByAgentOptions, StartConversationOptions, TransferToBotOptions, UpdateSessionOptions, CloseSessionOptions, ReopenSessionOptions, DeleteClosedSessionOptions, CreateSessionsOptions, CreateSessionsResponse, BulkDeleteSessionsOptions } from '../types/sessions';
|
|
2
2
|
import { HITLBase } from './HITLBase';
|
|
3
|
-
/**
|
|
4
|
-
* Manages Human-in-the-Loop sessions and related operations
|
|
5
|
-
*
|
|
6
|
-
* This class provides functionality to:
|
|
7
|
-
* - Manage session lifecycle (create, update, close, reopen, delete)
|
|
8
|
-
* - Handle session assignments and transfers
|
|
9
|
-
* - Search and retrieve sessions
|
|
10
|
-
* - Manage queue sessions
|
|
11
|
-
*
|
|
12
|
-
* @remarks
|
|
13
|
-
* - Makes requests to the `/sessions` endpoints
|
|
14
|
-
* - For the methods `claimSessionByAgent` and `searchSessionsWithContacts`, you must include `{ version: 2 }` in the parameters for the method to execute correctly.
|
|
15
|
-
* @public
|
|
16
|
-
*/
|
|
17
3
|
export declare class Sessions extends HITLBase {
|
|
18
4
|
protected static MODULE_URL: string;
|
|
19
5
|
protected static SEARCH_URL: "search";
|
|
@@ -25,460 +11,21 @@ export declare class Sessions extends HITLBase {
|
|
|
25
11
|
protected static START_CONVERSATION_URL: "start-conversation";
|
|
26
12
|
protected static CLOSE_URL: "close";
|
|
27
13
|
protected static REOPEN_URL: "reopen";
|
|
28
|
-
/**
|
|
29
|
-
* Retrieves a list of HITL sessions
|
|
30
|
-
*
|
|
31
|
-
* @param options - Configuration parameters for retrieving sessions
|
|
32
|
-
*
|
|
33
|
-
* Optional parameters:
|
|
34
|
-
* - `agentId` - (string) ID of agent to filter sessions by
|
|
35
|
-
* - `contactId` - (string) ID of contact to filter sessions by
|
|
36
|
-
* - `ignoreRuleTags` - (boolean) Whether to ignore rule tags in filtering
|
|
37
|
-
* - `limit` - (number) Maximum number of sessions to return
|
|
38
|
-
* - `order` - ('asc' | 'desc') Sort order direction
|
|
39
|
-
* - `orderBy` - (string) Field to sort results by
|
|
40
|
-
* - `page` - ({@link PageOptions}) Pagination options
|
|
41
|
-
* - `projection` - (string[]) Fields to include in the response
|
|
42
|
-
* - `status` - (string[]) Filter by session status(es)
|
|
43
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
44
|
-
* - `version` - (string | number) API version to use
|
|
45
|
-
*
|
|
46
|
-
* @returns {Promise<GetSessionsResponse>} Promise resolving to list of sessions
|
|
47
|
-
*
|
|
48
|
-
* @example
|
|
49
|
-
* ```typescript
|
|
50
|
-
* // Get all active sessions for an agent
|
|
51
|
-
* const sessions = await hitlApi.sessions.getSessions({
|
|
52
|
-
* status: ['ONGOING', 'CLAIMED'],
|
|
53
|
-
* limit: 50
|
|
54
|
-
* });
|
|
55
|
-
* ```
|
|
56
|
-
*
|
|
57
|
-
* @remarks Makes a GET request to `/hitl/sessions`
|
|
58
|
-
*/
|
|
59
14
|
static getSessions(options?: GetSessionsOptions): Promise<GetSessionsResponse>;
|
|
60
|
-
/**
|
|
61
|
-
* Retrieves a specific HitL session by ID
|
|
62
|
-
*
|
|
63
|
-
* @param options - Configuration parameters for retrieving a session
|
|
64
|
-
*
|
|
65
|
-
* Required parameters:
|
|
66
|
-
* - `sessionId` - (string) ID of the session to retrieve
|
|
67
|
-
*
|
|
68
|
-
* Optional parameters:
|
|
69
|
-
* - `agentId` - (string) ID of agent accessing the session
|
|
70
|
-
* - `ignoreRuleTags` - (boolean) Whether to ignore rule tags in filtering
|
|
71
|
-
* - `projection` - (string[]) Fields to include in the response
|
|
72
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
73
|
-
* - `version` - (string | number) API version to use
|
|
74
|
-
*
|
|
75
|
-
* @returns {Promise<Session>} Promise resolving to session details
|
|
76
|
-
*
|
|
77
|
-
* @example
|
|
78
|
-
* ```typescript
|
|
79
|
-
* const session = await hitlApi.sessions.getSessionById({
|
|
80
|
-
* sessionId: 'session-id-1',
|
|
81
|
-
* projection: ['hitlSessionId', 'status', 'transcript']
|
|
82
|
-
* });
|
|
83
|
-
* ```
|
|
84
|
-
*
|
|
85
|
-
* @remarks Makes a GET request to `/sessions/{sessionId}`
|
|
86
|
-
*/
|
|
87
15
|
static getSessionById({ agentId, projection, ...options }: GetSessionByIdOptions): Promise<Session>;
|
|
88
|
-
/**
|
|
89
|
-
* Searches for HitL sessions based on provided criteria
|
|
90
|
-
*
|
|
91
|
-
* @param options - Search configuration and filters
|
|
92
|
-
*
|
|
93
|
-
* Optional parameters:
|
|
94
|
-
* - `agentId` - (string) Filter by assigned agent
|
|
95
|
-
* - `claimedBy` - (string) Filter by currently assigned agent
|
|
96
|
-
* - `claimedByHistory` - (string) Filter by previously assigned agent
|
|
97
|
-
* - `contactIds` - (string[]) Array of contact IDs to filter by
|
|
98
|
-
* - `dateRange` - (DateRangeOptions) Date range filtering options
|
|
99
|
-
* - `meta` - (Record<string, string | number | boolean | MetaWithCondition>) Metadata filters
|
|
100
|
-
* - `needsAction` - (boolean) Filter sessions requiring action
|
|
101
|
-
* - `searchPhrase` - (string) Text search query
|
|
102
|
-
* - `sessionIds` - (string[]) Array of session IDs to filter by
|
|
103
|
-
* - `sessionsSearchOptions` - (SessionSearchOptions) Additional search configuration
|
|
104
|
-
* - `status` - (string[]) Filter by session status(es)
|
|
105
|
-
* - `tags` - (TagsQuery | string[]) Filter by tags
|
|
106
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
107
|
-
* - `type` - (string) Filter by session type
|
|
108
|
-
* - `version` - (string | number) API version to use
|
|
109
|
-
*
|
|
110
|
-
* @returns {Promise<SearchSessionsResponse>} Promise resolving to search results
|
|
111
|
-
*
|
|
112
|
-
* @example
|
|
113
|
-
* ```typescript
|
|
114
|
-
* // Search by different options
|
|
115
|
-
* const results = await hitlApi.sessions.searchSessions({
|
|
116
|
-
* claimedBy: BASIC_USER_ID,
|
|
117
|
-
* status: ['ONGOING', 'CLAIMED'],
|
|
118
|
-
* tags: ['wait_for_agent'],
|
|
119
|
-
* type: 'SMS',
|
|
120
|
-
* limit: 25
|
|
121
|
-
* });
|
|
122
|
-
*
|
|
123
|
-
* // Search by meta with conditions
|
|
124
|
-
* const results = await hitlApi.sessions.searchSessions({
|
|
125
|
-
* meta: {
|
|
126
|
-
* botIdentifier: { value: botIdentifier, condition: 'IS_EQUAL' },
|
|
127
|
-
* hiddenFromHistory: { value: true, condition: 'IS_NOT_EQUAL' },
|
|
128
|
-
* userIdentifier: { value: userIdentifier1.slice(3), condition: 'CONTAINS' },
|
|
129
|
-
* },
|
|
130
|
-
* });
|
|
131
|
-
* ```
|
|
132
|
-
*
|
|
133
|
-
* @remarks Makes a POST request to `/sessions/search`
|
|
134
|
-
*/
|
|
135
16
|
static searchSessions({ agentId, ...options }?: SearchSessionsOptions): Promise<SearchSessionsResponse>;
|
|
136
|
-
/**
|
|
137
|
-
* Searches for HitL sessions and includes associated contact information
|
|
138
|
-
*
|
|
139
|
-
* @param options - Search configuration including contact-related filters
|
|
140
|
-
*
|
|
141
|
-
* Optional parameters:
|
|
142
|
-
* - `agentId` - (string) Filter by assigned agent
|
|
143
|
-
* - `contact` - (ContactSearchParams) Contact search parameters
|
|
144
|
-
* - `contactsSearchOptions` - (ContactSearchOptions) Additional contact search configuration
|
|
145
|
-
* - `dateRange` - (DateRangeOptions) Date range filtering options
|
|
146
|
-
* - `searchPhrase` - (string) Text search query
|
|
147
|
-
* - `sessionsSearchOptions` - (SessionSearchOptions) Additional session search configuration
|
|
148
|
-
* - `tags` - (string[]) Filter by tags
|
|
149
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
150
|
-
* - `version` - (string | number) API version to use
|
|
151
|
-
*
|
|
152
|
-
* @returns {Promise<SearchSessionsWithContactsResponse>} Promise resolving to sessions with contact details
|
|
153
|
-
*
|
|
154
|
-
* @example
|
|
155
|
-
* ```typescript
|
|
156
|
-
* const results = await hitlApi.sessions.searchSessionsWithContacts({
|
|
157
|
-
* searchPhrase: 'billing issue',
|
|
158
|
-
* tags: ['vip', 'missed'],
|
|
159
|
-
* limit: 10,
|
|
160
|
-
* version: 2
|
|
161
|
-
* });
|
|
162
|
-
*
|
|
163
|
-
* // Search sessions by contact info
|
|
164
|
-
* const results = await hitlApi.sessions.searchSessionsWithContacts({
|
|
165
|
-
* contact: { name: 'Alison' },
|
|
166
|
-
* contactsSearchOptions: { size: 2 },
|
|
167
|
-
* version: 2
|
|
168
|
-
* });
|
|
169
|
-
* ```
|
|
170
|
-
*
|
|
171
|
-
* @remarks Makes a POST request to `/sessions/search-with-contacts`
|
|
172
|
-
*/
|
|
173
17
|
static searchSessionsWithContacts({ agentId, ...options }?: SearchSessionsWithContactsOptions): Promise<SearchSessionsWithContactsResponse>;
|
|
174
|
-
/**
|
|
175
|
-
* Retrieves the next session in NEEDS_ACTION state from the queue
|
|
176
|
-
*
|
|
177
|
-
* @param options - Queue configuration including agent and rule tags
|
|
178
|
-
*
|
|
179
|
-
* Required parameters:
|
|
180
|
-
* - `agentId` - (string) ID of agent requesting next session
|
|
181
|
-
*
|
|
182
|
-
* Optional parameters:
|
|
183
|
-
* - `ruleTags` - (string[]) Filter sessions by rule tags
|
|
184
|
-
* - `ignoreRuleTags` - (boolean) Whether to ignore rule tags in filtering
|
|
185
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
186
|
-
* - `version` - (string | number) API version to use
|
|
187
|
-
*
|
|
188
|
-
* @returns {Promise<GetQueueSessionResponse>} Promise resolving to next available session
|
|
189
|
-
*
|
|
190
|
-
* @example
|
|
191
|
-
* ```typescript
|
|
192
|
-
* // Get next session for agent
|
|
193
|
-
* const session = await hitlApi.sessions.getQueueSession({
|
|
194
|
-
* agentId: 'agent-id'
|
|
195
|
-
* });
|
|
196
|
-
* ```
|
|
197
|
-
*
|
|
198
|
-
* @remarks Makes a GET request to `sessions/helpers/queue`
|
|
199
|
-
*/
|
|
200
18
|
static getQueueSession({ agentId, ruleTags, ...options }: GetQueueSessionOptions): Promise<GetQueueSessionResponse>;
|
|
201
|
-
/**
|
|
202
|
-
* Retrieves available initialization triggers for starting new HitL sessions
|
|
203
|
-
*
|
|
204
|
-
* @param options - Configuration parameters for trigger retrieval
|
|
205
|
-
*
|
|
206
|
-
* Optional parameters:
|
|
207
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
208
|
-
* - `version` - (string | number) API version to use
|
|
209
|
-
*
|
|
210
|
-
* @returns {Promise<GetInitTriggersResponse>} Promise resolving to available triggers
|
|
211
|
-
*
|
|
212
|
-
* @example
|
|
213
|
-
* ```typescript
|
|
214
|
-
* // Get all available triggers
|
|
215
|
-
* const triggers = await hitlApi.sessions.getSessionInitTriggers();
|
|
216
|
-
* ```
|
|
217
|
-
*
|
|
218
|
-
* @remarks Makes a GET request to `/sessions/helpers/triggers`
|
|
219
|
-
*/
|
|
220
19
|
static getSessionInitTriggers(options?: GetInitTriggersOptions): Promise<GetInitTriggersResponse>;
|
|
221
|
-
/**
|
|
222
|
-
* Claims a session for a specific agent
|
|
223
|
-
*
|
|
224
|
-
* @param options - Claim configuration including agent and parameters
|
|
225
|
-
*
|
|
226
|
-
* Required parameters:
|
|
227
|
-
* - `sessionId` - (string) ID of session to claim
|
|
228
|
-
* - `claimBy` - (string) ID of agent claiming the session
|
|
229
|
-
*
|
|
230
|
-
* Optional parameters:
|
|
231
|
-
* - `params` - (object) Additional claim parameters
|
|
232
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
233
|
-
* - `version` - (string | number) API version to use
|
|
234
|
-
*
|
|
235
|
-
* @returns {Promise<Session>} Promise resolving to the claimed session
|
|
236
|
-
* @remarks Makes a POST request to `/api/v2/hitl/sessions/{sessionId}/claim`
|
|
237
|
-
*
|
|
238
|
-
* @example
|
|
239
|
-
* ```typescript
|
|
240
|
-
* // Claim session by current token agent
|
|
241
|
-
* const session = await hitlApi.sessions.claimSessionByAgent({
|
|
242
|
-
* sessionId: 'session-id',
|
|
243
|
-
* version: 2
|
|
244
|
-
* });
|
|
245
|
-
* ```
|
|
246
|
-
*/
|
|
247
20
|
static claimSessionByAgent({ claimBy, params, ...options }: ClaimSessionByAgentOptions): Promise<Session>;
|
|
248
|
-
/**
|
|
249
|
-
* Transfers session control back to the bot
|
|
250
|
-
*
|
|
251
|
-
* @param options - Transfer configuration including agent and parameters
|
|
252
|
-
*
|
|
253
|
-
* Required parameters:
|
|
254
|
-
* - `sessionId` - (string) ID of session to transfer
|
|
255
|
-
* - `agentId` - (string) ID of agent transferring the session
|
|
256
|
-
*
|
|
257
|
-
* Optional parameters:
|
|
258
|
-
* - `params` - (object) Additional transfer parameters
|
|
259
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
260
|
-
* - `version` - (string | number) API version to use
|
|
261
|
-
*
|
|
262
|
-
* @returns {Promise<Session>} Promise resolving to transferred session
|
|
263
|
-
* @remarks Makes a POST request to `/api/v2/hitl/sessions/{sessionId}/transfer-to-bot`
|
|
264
|
-
*
|
|
265
|
-
* @example
|
|
266
|
-
* ```typescript
|
|
267
|
-
* // Basic transfer
|
|
268
|
-
* const session = await hitlApi.sessions.transferToBot({
|
|
269
|
-
* sessionId: 'session-id',
|
|
270
|
-
* });
|
|
271
|
-
* ```
|
|
272
|
-
*/
|
|
273
21
|
static transferToBot({ agentId, params, ...options }: TransferToBotOptions): Promise<Session>;
|
|
274
|
-
/**
|
|
275
|
-
* Initiates a new conversation session
|
|
276
|
-
*
|
|
277
|
-
* @param options - Conversation configuration including contact and trigger details
|
|
278
|
-
*
|
|
279
|
-
* Required parameters:
|
|
280
|
-
* - `contactId` - (string) ID of contact to start conversation with
|
|
281
|
-
* - `triggerId` - (string) ID of trigger to initiate conversation
|
|
282
|
-
*
|
|
283
|
-
* Optional parameters:
|
|
284
|
-
* - `params` - (object) Additional conversation parameters
|
|
285
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
286
|
-
* - `version` - (string | number) API version to use
|
|
287
|
-
*
|
|
288
|
-
* @returns {Promise<Session>} Promise resolving to new session
|
|
289
|
-
*
|
|
290
|
-
* @example
|
|
291
|
-
* ```typescript
|
|
292
|
-
* // Start basic conversation
|
|
293
|
-
* const session = await hitlApi.sessions.startConversation({
|
|
294
|
-
* contactId: 'contact-id-1',
|
|
295
|
-
* triggerId: 'trigger-id-2'
|
|
296
|
-
* });
|
|
297
|
-
*
|
|
298
|
-
* // Start conversation with parameters
|
|
299
|
-
* const session = await hitlApi.sessions.startConversation({
|
|
300
|
-
* contactId: 'contact-id',
|
|
301
|
-
* triggerId: 'hitl/init-conversation/voice',
|
|
302
|
-
* params: { visibilityTags: [] }
|
|
303
|
-
* });
|
|
304
|
-
* ```
|
|
305
|
-
*
|
|
306
|
-
* @remarks Makes a POST request to `/sessions/start-conversation`
|
|
307
|
-
*/
|
|
308
22
|
static startConversation({ contactId, triggerId, params, ...options }: StartConversationOptions): Promise<Session>;
|
|
309
|
-
/**
|
|
310
|
-
* Updates an existing session with new information
|
|
311
|
-
*
|
|
312
|
-
* @param options - Update configuration including tags and metadata
|
|
313
|
-
*
|
|
314
|
-
* Required parameters:
|
|
315
|
-
* - `sessionId` - (string) ID of session to update
|
|
316
|
-
*
|
|
317
|
-
* Optional parameters:
|
|
318
|
-
* - `tags` - (string[]) New tags for the session
|
|
319
|
-
* - `contactId` - (string) Updated contact ID
|
|
320
|
-
* - `meta` - (object) Updated metadata
|
|
321
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
322
|
-
* - `version` - (string | number) API version to use
|
|
323
|
-
*
|
|
324
|
-
* @returns {Promise<Session>} Promise resolving to updated session
|
|
325
|
-
*
|
|
326
|
-
* @example
|
|
327
|
-
* ```typescript
|
|
328
|
-
* const session = await hitlApi.sessions.updateSession({
|
|
329
|
-
* sessionId: 'session-id',
|
|
330
|
-
* tags: ['support'],
|
|
331
|
-
* meta: {
|
|
332
|
-
* status: 'in-progress',
|
|
333
|
-
* priority: 'high',
|
|
334
|
-
* notes: 'Customer requesting callback'
|
|
335
|
-
* }
|
|
336
|
-
* });
|
|
337
|
-
* ```
|
|
338
|
-
*
|
|
339
|
-
* @remarks Makes a PUT request to `/sessions/{sessionId}`
|
|
340
|
-
*/
|
|
341
23
|
static updateSession({ sessionId, tags, contactId, meta, ...options }: UpdateSessionOptions): Promise<Session>;
|
|
342
|
-
/**
|
|
343
|
-
* Creates multiple sessions in bulk
|
|
344
|
-
*
|
|
345
|
-
* @param options - Bulk creation configuration including session details
|
|
346
|
-
*
|
|
347
|
-
* Required parameters:
|
|
348
|
-
* - `sessions` - ({@link Session}[]) Array of session configurations to create
|
|
349
|
-
*
|
|
350
|
-
* Optional parameters:
|
|
351
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
352
|
-
* - `version` - (string | number) API version to use
|
|
353
|
-
*
|
|
354
|
-
* @returns {Promise<CreateSessionsResponse>} Promise resolving to creation results
|
|
355
|
-
*
|
|
356
|
-
* @example
|
|
357
|
-
* ```typescript
|
|
358
|
-
* const created = await hitlApi.sessions.createSessions({
|
|
359
|
-
* sessions: [
|
|
360
|
-
* {
|
|
361
|
-
* hitlSessionId: 'session-id',
|
|
362
|
-
* contactId: 'contact-id-1',
|
|
363
|
-
* status: 'CLOSED',
|
|
364
|
-
* isArchived: true,
|
|
365
|
-
* createdAt: new Date('1971'),
|
|
366
|
-
* ruleTags: ['sms'],
|
|
367
|
-
* },
|
|
368
|
-
* {
|
|
369
|
-
* contactId: 'contact-id-2',
|
|
370
|
-
* status: 'ONGOING',
|
|
371
|
-
* ruleTags: ['voice'],
|
|
372
|
-
* },
|
|
373
|
-
* ]
|
|
374
|
-
* });
|
|
375
|
-
* ```
|
|
376
|
-
*
|
|
377
|
-
* @remarks Makes a POST request to `/sessions`
|
|
378
|
-
*/
|
|
379
24
|
static createSessions({ sessions, ...options }: CreateSessionsOptions): Promise<CreateSessionsResponse>;
|
|
380
|
-
/**
|
|
381
|
-
* Closes an active session
|
|
382
|
-
*
|
|
383
|
-
* @param options - Close configuration including session identifier
|
|
384
|
-
*
|
|
385
|
-
* Required parameters:
|
|
386
|
-
* - `sessionId` - (string) ID of session to close
|
|
387
|
-
*
|
|
388
|
-
* Optional parameters:
|
|
389
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
390
|
-
* - `version` - (string | number) API version to use
|
|
391
|
-
*
|
|
392
|
-
* @returns {Promise<Session>} Promise resolving to closed session
|
|
393
|
-
*
|
|
394
|
-
* @example
|
|
395
|
-
* ```typescript
|
|
396
|
-
* // Close a session
|
|
397
|
-
* const session = await hitlApi.sessions.closeSession({
|
|
398
|
-
* sessionId: 'session-id'
|
|
399
|
-
* });
|
|
400
|
-
* ```
|
|
401
|
-
*
|
|
402
|
-
* @remarks Makes a POST request to `sessions/{sessionId}/close`
|
|
403
|
-
*/
|
|
404
25
|
static closeSession(options: CloseSessionOptions): Promise<Session>;
|
|
405
|
-
/**
|
|
406
|
-
* Reopens a previously closed session
|
|
407
|
-
*
|
|
408
|
-
* @param options - Reopen configuration including session identifier
|
|
409
|
-
*
|
|
410
|
-
* Required parameters:
|
|
411
|
-
* - `sessionId` - (string) ID of session to reopen
|
|
412
|
-
*
|
|
413
|
-
* Optional parameters:
|
|
414
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
415
|
-
* - `version` - (string | number) API version to use
|
|
416
|
-
*
|
|
417
|
-
* @returns {Promise<Session>} Promise resolving to reopened session
|
|
418
|
-
*
|
|
419
|
-
* @example
|
|
420
|
-
* ```typescript
|
|
421
|
-
* // Reopen a session
|
|
422
|
-
* const session = await hitlApi.sessions.reopenSession({
|
|
423
|
-
* sessionId: 'session-id'
|
|
424
|
-
* });
|
|
425
|
-
* ```
|
|
426
|
-
*
|
|
427
|
-
* @remarks Makes a POST request to `/sessions/{sessionId}/reopen`
|
|
428
|
-
*/
|
|
429
26
|
static reopenSession(options: ReopenSessionOptions): Promise<Session>;
|
|
430
|
-
/**
|
|
431
|
-
* Deletes a closed session
|
|
432
|
-
*
|
|
433
|
-
* @param options - Delete configuration including session identifier
|
|
434
|
-
*
|
|
435
|
-
* Required parameters:
|
|
436
|
-
* - `sessionId` - (string) ID of session to delete
|
|
437
|
-
*
|
|
438
|
-
* Optional parameters:
|
|
439
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
440
|
-
* - `version` - (string | number) API version to use
|
|
441
|
-
*
|
|
442
|
-
* @returns {Promise<void>} Promise resolving when deletion is complete
|
|
443
|
-
*
|
|
444
|
-
* @example
|
|
445
|
-
* ```typescript
|
|
446
|
-
* // Delete a closed session
|
|
447
|
-
* await hitlApi.sessions.deleteClosedSession({
|
|
448
|
-
* sessionId: 'session-id'
|
|
449
|
-
* });
|
|
450
|
-
* ```
|
|
451
|
-
*
|
|
452
|
-
* @remarks Makes a DELETE request to `/sessions/{sessionId}`
|
|
453
|
-
*/
|
|
454
27
|
static deleteClosedSession(options: DeleteClosedSessionOptions): Promise<unknown>;
|
|
455
|
-
/**
|
|
456
|
-
* @deprecated Use bulkDeleteSessions instead
|
|
457
|
-
*/
|
|
458
28
|
static buldDeleteSessions({ sessionIds, ...options }: BulkDeleteSessionsOptions): Promise<unknown>;
|
|
459
|
-
/**
|
|
460
|
-
* Deletes multiple sessions in bulk
|
|
461
|
-
*
|
|
462
|
-
* @param options - Bulk deletion configuration including session identifiers
|
|
463
|
-
*
|
|
464
|
-
* Required parameters:
|
|
465
|
-
* - `sessionIds` - (string[]) Array of session IDs to delete
|
|
466
|
-
*
|
|
467
|
-
* Optional parameters:
|
|
468
|
-
* - `timeout` - (number) Request timeout in milliseconds
|
|
469
|
-
* - `version` - (string | number) API version to use
|
|
470
|
-
*
|
|
471
|
-
* @returns {Promise<void>} Promise resolving when deletion is complete
|
|
472
|
-
* @remarks Makes a DELETE request to `/api/v2/hitl/sessions`
|
|
473
|
-
*
|
|
474
|
-
* @example
|
|
475
|
-
* ```typescript
|
|
476
|
-
* // Delete multiple sessions
|
|
477
|
-
* await hitlApi.sessions.bulkDeleteSessions({
|
|
478
|
-
* sessionIds: ['session-id-1', 'session-id-2', 'session-id-3']
|
|
479
|
-
* });
|
|
480
|
-
* ```
|
|
481
|
-
*/
|
|
482
29
|
static bulkDeleteSessions({ sessionIds, ...options }: BulkDeleteSessionsOptions): Promise<unknown>;
|
|
483
30
|
}
|
|
484
31
|
//# sourceMappingURL=Sessions.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Sessions.d.ts","sourceRoot":"","sources":["../../../src/api/Sessions.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,OAAO,EAEP,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,iCAAiC,EACjC,kCAAkC,EAClC,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"Sessions.d.ts","sourceRoot":"","sources":["../../../src/api/Sessions.ts"],"names":[],"mappings":"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"}
|