Settings

settings controls the widget's runtime behaviour: polling, throttling, and error-banner timing. Values are numbers (milliseconds or counts).

Plain JavaScript callers may pass numeric strings — they are coerced with a console warning — and all values are clamped to safe ranges.

Example

setConfig({
  apiUrl,
  accountNumber,
  userEmail,
  settings: {
    fetchIntervalMs: 5000,
    fetchAmountPerRequest: 25,
  },
});

Default values

Key	Type	Default	What it controls
fetchIntervalMs	number	10000	Interval between poll ticks while the panel is open and a conversation exists (ms). Ticks are skipped while the tab is hidden. Clamped to 500–60000 ms. See Polling.
fetchPreviousThrottleMs	number	1000	Minimum gap between "load older messages" requests (ms).
fetchAmountPerRequest	number	50	Page size when loading older messages.
sendErrorDismissMs	number	5000	How long the send-error banner stays visible before auto-dismiss (ms).

Tuning refresh timing

The poll interval is the main lever for how quickly inbound messages appear. Lower fetchIntervalMs for snappier updates, at the cost of more requests. See the Polling guide for the full picture, including how tab visibility and panel state affect refresh.