SDK Functions

Here's a list of all the functions supported by Upscope's SDK. These can be called with Upscope('FUNCTION_NAME', ...args);.

Function Name	Arguments	Description
cancelRequestAgent	—	Stops an Agent request.
connect	—	Starts the socket connectionⓘ to the Upscope servers.
expectDisconnect	({ returnTimeSeconds?: number; message?: string; })	Call this before redirecting the Visitor to a page without the SDK installed (e.g. an external log in flow) to indicate to the Agent why the Visitor is offline and that they will return shortly. Optionally set returnTimeSeconds to revert to the default "Visitor is not connected anymore" message after a while.
getLookupCode	(callback: function(code: string))	Returns the lookup code through the callback.
getShortId	(callback: function(shortId: string))	Returns the Visitor's shortId through the callback.
getWatchLink	(callback: function(link: string))	Returns the watch link through the callback.
init	(configuration: Partial<SDKConfiguration>)ⓘ	Used to initiate Upscope. This must be the first function called.
newPageview	—	Triggers a new pageview in a SPA environment.
on	(...events: string, callback: function)	Adds a listener for the events provided.
prefetchAssets	—	Call if you know a Session is about to happen to start prepping for it and make it go live faster.
requestAgent	—	Initiates an Agent request.
reset	(reopenConnection: true)	Used to reset the connection with Upscope and clear all identity from the Visitor. A new Visitor will be generated with a fresh ID. If reopenConnection is false, the connection will not be automatically re-opened, and Upscope will be in its initial idle state.
stopSession	—	Terminates an active Session.
submitRating	(ratings: { userSessionRating?: 1 | 2 | 3 | 4 | 5, userAgentRating: 1 | 2 | 3 | 4 | 5, userAgentFeedback: string)	Submits a user rating after a Session has ended.
updateConnection	(updates: {uniqueId?: string, identities?: string[], tags?: string[], integrationIds?: string[], callName?: string, agentPrompt?: string, allowRemoteConsole?: boolean, allowRemoteClick?: boolean, allowRemoteScroll?: boolean, allowRemoteType?: boolean, allowAgentRedirect?: boolean})	Used to update the identity of the visitor or settings after pageload.