Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.talview.com/llms.txt

Use this file to discover all available pages before exploring further.

InitOptions

AttributeTypeDescriptionDefault
dsn*stringThe DSN tells the SDK where to send the events. If this is not set, the SDK will not send any events.
session_identifier*stringValue that can identify the proctored session in the source platform.
allowed_languages[locale.languages][]This will limit language options for users to select from the supported listAll supported languages
language[locale.languages]Explicitly set the SDK languageBrowser default if its not supported then fallback to English (en-US).

Error

AttributeTypeDescriptionDefault
codestringThis will identify predefined error by code. Ref Error Code section
messagestringMessage will contain reason for the error.
TypeWarning/CriticalError could be of type warning or critical. When critical error is raised it will impact core proctoring feature delivery.
ValidationErrorsValidationError[]

Validation Error

AttributeTypeDescriptionDefault
pathstringPath of the attribute
messagestringvalidation error message
codestringValidation error code

Session Type Definitions

session.constant.type

Its of type enum which contains following values.
  • Recorded
  • RecordedAndReview
  • Live
  • Dynamic

session.constant.state

Its of type enum which contains following values.
  • init
  • registered
  • running
  • paused
  • suspended
  • terminated
  • stopped
  • completed

SessionOptions

AttributeTypeDescriptionDefault
typesession.constant.type
identifierstringunique session identifier from the source system. It will be the session external id in the Talview platform.

SessionOutput

AttributeTypeDescriptionDefault
uuidGUIDReference Talview identifier for client application to track.
statesession.constant.state
attendeeAttendee
workflow_stepWorkflowIf not passed then system will generate email based on identifier. e.g: Att0001@dnd.talview.com
identifierstringunique session identifier from the source system. It will be the session external id in the Talview platform.

Attendee Type Definitions

Attendee

AttributeTypeDescriptionDefault
identifier*stringunique user identifier from the source system. It will be the external id in the Talview platform.
first_namestring
last_namestring
middle_namestring
emailstringIf not passed then system will generate email based on identifier. e.g: Att0001@dnd.talview.com
country_codestring (3)ISO country code
countrystringCountry code is passed then system will auto identify the country otherwise system will identify country code from country.
phonestring (15)E164 format
idintTalview unique id generated for the course

Workflow Type Definitions

Exam Workflow

AttributeTypeDescriptionDefault
identifier*stringUnique identifier for the exam from the calling application. It will be the external id in the Talview platform.
namestringName of the examIf name is not passed then external id will be used.
flow_idintThis is the proctor session onboarding flow identifier.if not passed then detail flow will be mapped based on project DSN
durationintduration of the exam in min
resource[{string,string}]Array of key value pair to persist additional info related to exam.
course[Course]
idintTalview unique id generated for the course

Course

AttributeTypeDescriptionDefault
idintTalview unique id generated for the course
namestringName of the Course the exam is part of.Exam workflow name
identifierstringUnique identifier for the course from the calling application. If not set then exam identifier will be used.Exam workflow external id
resource[{string,string}]Array of key value pair to persist additional info related to course.

Locale

AttributeTypeDescriptionDefault
languagestringbased on browser info
currencystringISO 4217 currency codesbased on browser info
timezonestringTimezonebased on browser info