Skip to content

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
connect — Starts the socket connection to the Upscope servers.1
getLookupCode (callback: function(link: string)) Returns the lookup code through the callback.
getLookupCode (callback: function(link: 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: dictionary)2 Used to initiate Upscope. This must be the first function called.
logEvent (eventType: string, eventMessage: string) Logs a new event in the history of the visitor. eventType must be one of success, error, info, warn, contact.
newPageview — Triggers a new pageview in a SPA environment.
on (...events: string, callback: function) Adds a listener for the events provided.
redirect (url: string) If a session is active, it will redirect the visitor to the provided URL through the Upscope proxy, otherwise it will send the visitor directly to the URL.
reset — Used to reset the connection with Upscope.
saveHistory — Persists the visitor's history and screenshots to Upscope's servers.
stopSession — Terminates an active session.
updateConnection (newIdentities: dictionary) Used to update the identity of the visitor after pageload.3

  1. This is only needed if autoconnect is false. ↩

  2. Full list of configuration options found here. ↩

  3. Only identities, uniqueId, tags, and agentPrompt are allowed. ↩