Placement & Rendering

allowAgentDrag

Determines whether users can click and drag the agent widget to reposition it anywhere on the screen.

Type: boolean
Default Value: true

renderMode

Specifies how the SDK is embedded within the host page — either as an iframe or inline component.

Type: string
Default Value: "IFRAME"
Accepted Values: "IFRAME" | "INLINE"

sessionTimeout

Defines the maximum idle time (in minutes) before a new conversation is automatically started.
Minimum: 5 minutes
Maximum: 1440 minutes (24 hours)

Type: number
Default Value: 30

initialAgentPosition

Sets the default on-screen location where the agent widget appears when first loaded.

Type: string
Default Value: "CENTER_RIGHT"
Accepted Values: "TOP_RIGHT" | "TOP_LEFT" | "BOTTOM_RIGHT" | "BOTTOM_LEFT" | "CENTER_RIGHT" | "CENTER_LEFT"

Example

foldspace.agent('API-KEY').setConfiguration({
  renderMode: "IFRAME",
  allowAgentDrag: true,

  // Position property (format: "VERTICAL_HORIZONTAL")
  initialAgentPosition: "BOTTOM_RIGHT",
  
  // Session timeout in minutes
  sessionTimeout: 30,
});