Create Chat Widget
Changed onCreate an additional chat widget for the current customer.
New widgets are never the default; the default is the customer's original widget (created on first legacy update, or promoted via update).
Request
- Base URL: https://api.openintake.ai (the document declares no server; this is the origin it was published from)
- URL: https://api.openintake.ai/settings/chat-widgets
- Auth: none declared
Request body
Whether the chat widget is shown on the customer's website
Primary color hex code (e.g., #B5683C)
Secondary accent color hex code. Set to null to auto-derive from accent color.
Launcher bubble color hex code. Set to null to use the accent color.
Widget position: bottom-right or bottom-left
The first message shown when a visitor opens the chat
Displayed in the chat header
Full system prompt override. Set to null to use assembled prompt from structured fields.
Personality/tone instructions
Firm-specific information. Set to null to fall back to Customer.law_firm_info_prompt.
What to do after collecting info
Extra rules or context
Whether to show a teaser message bubble
Teaser message text
Seconds before teaser appears
Whether to show online indicator
Whether to show unread badge on bubble
Whether to flash unread count in tab title
URL of agent avatar image
URL of a silent looping video shown in place of the avatar image (header and launcher). Takes precedence over avatar_url.
When false, the open panel's header shows the static avatar image and the avatar video only plays on the launcher bubble
When true (and avatar_url is set), the floating launcher shows the avatar image inside an accent-colored ring instead of the default chat bubble icon
When true (and intro_video_url is set), opening the widget plays an intro video full-panel before transitioning into the chat
URL of the intro video (mp4/webm) played when the widget opens
When true, desktop visitors see the muted intro video playing in the widget corner on page load; when false it only plays after they click the launcher
When true, the chat panel opens automatically on page load for desktop visitors (>=768px wide); mobile keeps the collapsed bubble. No conversation is created until the visitor sends their first message
When true, a full-page modal asks visitors if they need help; Yes opens the chat directly, No dismisses it
Question shown in the attention grabber modal
Seconds before the attention grabber modal appears (1-120)
Message shown when visitor is idle
Seconds of inactivity before nudge (10-300)
Privacy Quick Exit: the widget never persists the chat across page loads — the conversation is ended and reset on browser close/refresh
Extra clearance in pixels between the widget and the bottom of the viewport on mobile (0-300). Null = none.
Minutes of inactivity before auto-completing a chat (1-60). Default: 10 minutes.
Allowed origins for CORS. When empty or null, any origin can embed the widget.
When true, any origin may embed the widget regardless of allowed_origins (temporary escape hatch, e.g. during onboarding)
White label: customer-owned hostname serving both widget.js and /chat/* (e.g. chat.theleachfirm.com). Hostname only — no scheme, path or trailing dot. Set to null to go back to the openintake-hosted bundle.
Display label for the widget (e.g. which website it serves)
Response
Successful Response
Whether the chat widget is shown on the customer's website
Primary color for the bubble, header, and assistant messages
Secondary accent color. When null, derived automatically from the accent color.
Overrides the floating launcher bubble color only (e.g. when the accent blends into the site background). When null, the launcher uses the accent color.
Where the chat bubble appears on the page (bottom-right or bottom-left)
The first message shown when a visitor opens the chat
Displayed in the chat header
Full system prompt override. When set, replaces the assembled prompt entirely.
Personality/tone instructions (e.g. 'You are Ashley, a warm and professional intake specialist')
Firm-specific information injected into the prompt. Falls back to Customer.law_firm_info_prompt if not set.
What to do after collecting info (e.g. 'Let them know an attorney will follow up within 24 hours')
Extra rules or context for the AI assistant
Whether to show a teaser message bubble next to the chat button
Teaser message text. Falls back to greeting_message if not set.
Seconds to wait before showing the teaser message
Whether to show an online indicator on the chat bubble and header
Whether to show an unread badge on the chat bubble
Whether to flash unread count in the browser tab title
URL of the agent avatar image for the header and messages
URL of a silent looping video shown in place of the avatar image (header and launcher). Takes precedence over avatar_url.
When false, the open panel's header shows the static avatar image and the avatar video only plays on the launcher bubble
When true (and avatar_url is set), the floating launcher shows the avatar image inside an accent-colored ring instead of the default chat bubble icon
When true (and intro_video_url is set), opening the widget plays an intro video full-panel before transitioning into the chat
URL of the intro video (mp4/webm) played when the widget opens
When true, desktop visitors see the muted intro video playing in the widget corner on page load; when false it only plays after they click the launcher
When true, the chat panel opens automatically on page load for desktop visitors (>=768px wide); mobile keeps the collapsed bubble. No conversation is created until the visitor sends their first message
When true, a full-page modal asks visitors if they need help; Yes opens the chat directly, No dismisses it
Question shown in the attention grabber modal. Falls back to a default when not set.
Seconds to wait before showing the attention grabber modal
Message shown when visitor is idle. Leave empty to disable.
Seconds of inactivity before showing the idle nudge message
Privacy Quick Exit: the widget never persists the chat across page loads — the conversation is ended and reset on browser close/refresh
Extra clearance in pixels between the widget and the bottom of the viewport on mobile, for sites with a fixed bottom bar. Null = none.
Minutes of inactivity before a chat is auto-completed. Default: 10 minutes.
Allowed origins for CORS. When empty or null, any origin can embed the widget.
When true, any origin may embed the widget regardless of allowed_origins (temporary escape hatch, e.g. during onboarding)
White label: customer-owned hostname (e.g. chat.theleachfirm.com) serving both widget.js and /chat/*. Shapes the embed snippet only — the CloudFront distribution and certificate must be provisioned separately, and this value never reaches the public widget config.
Display label for the widget
Whether this is the customer's default widget
Changes
- info
added the new optional request property
- info
added the optional property
to the response with the status
- info
- info
added the new optional request property
- info
added the optional property
to the response with the status
- info