Copy the organization-specific snippet
Open Widget in the workspace and copy the installation snippet. The organization identifier in the snippet tells AppsResolve which configuration, knowledge, and AI agent to use.
Add it once to your application shell
Do not place the loader inside a component that mounts more than once. The script protects against duplicate launchers, but loading it once keeps the integration predictable.
- Paste the script before the closing body tag or load it once from your shared application layout.
- Add each exact production or staging origin that should display the widget.
- Publish the change to an approved origin.
- Open the product in a private browser window and select Ask AI.
What the widget can read
The widget runs in an isolated iframe. It receives only the allowlisted page and identity context your integration intentionally supplies. It does not read passwords, payment details, page contents, clipboard data, or unrelated browser storage.
Configure placement and the JavaScript API
Widget settings control left or right placement, offsets, launcher size, delay, desktop and mobile visibility, and z-index. Host code can call AppsResolveWidget.init, open, close, show, hide, destroy, identify, setContext, reset, and on. Identity and context values are bounded before they enter the isolated iframe.
Support single-page applications
The loader observes pushState, replaceState, and popstate navigation, refreshes safe page context, and reapplies include or exclude rules without creating another launcher. Call destroy only when the integration should be removed during a true application unmount.
Update your Content Security Policy
Allow the AppsResolve origin in script-src, frame-src, and connect-src. Add the configured logo host to img-src when you use a remote logo. The loader does not require unsafe-eval.
Troubleshoot a missing launcher
Confirm that the rendered page includes the organization-specific script, the exact scheme and hostname are approved, the organization identifier matches the active workspace, visibility rules allow the current page and device, and your Content Security Policy permits the AppsResolve script, frame, and API connection.