Settings

settings controls how often the widget polls and how many messages each page holds. 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. Unknown keys are ignored with a console warning that lists the known settings.

Example

setConfig({
  apiUrl,
  accountNumber,
  userHandle,
  settings: {
    pollIntervalOpenMs: 10000,
    messagesPerPage: 25,
  },
});

Default values

Key	Type	Default	What it controls
pollIntervalOpenMs	number	5000	Poll interval while the panel is open (ms), also used for looking up the account's open chat when there is none. Ticks are skipped while the tab is hidden. While requests fail, the delay doubles (up to 60 s) until one succeeds. Clamped to 500–60000 ms. See Polling.
pollIntervalMinimizedMs	number	30000	Poll interval while the panel is minimized and a conversation exists (ms), so the launcher badge shows new replies. 0 turns minimized polling off. Clamped to 5000–300000 ms.
messagesPerPage	number	50	Messages per request, for the latest page and each older page. Clamped to 1–100.

Tuning refresh timing

The widget polls every pollIntervalOpenMs while the panel is open, and every pollIntervalMinimizedMs while it is minimized:

• Lower pollIntervalOpenMs for snappier replies, and to pick up a chat started in another tab sooner. Raise it to reduce server load.
• Raise pollIntervalMinimizedMs, or set it to 0, to reduce requests while the panel is minimized, at the cost of a less timely unread badge.

Each lower value means more requests. See the Polling guide for the full picture, including how tab visibility and panel state affect refresh.