Skip to main content

Web Widget

The Web Widget is the chat bubble that lives on your website. From the Web Widget menu in the sidebar you can switch it on, design how it looks, set up proactive messages and forms, review what visitors submit, and grab the code snippet to install it — all without writing any code.

Web Widget status page

Web Widget vs. Widget SDK

This page covers the no-code widget manager built into your dashboard. If you're a developer looking for the embed snippet, JavaScript API, or advanced theming, see the Widget SDK → Installation docs instead. The two work together: you design the widget here, then install it using the embed code.

How to activate the widget​

The first time you open Web Widget, you'll see a setup screen with a Getting Started card. Activation creates a secure access key, unlocks customization, generates your embed code, and turns on usage analytics.

  1. In the sidebar, open Web Widget.
  2. Read the Getting Started card so you know what activation does.
  3. Click Activate Widget (top right).
  4. Wait for activation to finish. The full management workspace appears and an install dialog opens automatically.
tip

Activation only switches the widget on in Fyncall. It won't appear on your site until you add the embed code — see How to install the widget on your website.

The connected web agent (Luna)​

Activating the Web Widget automatically creates and connects a web AI agent named Luna. Luna is tuned for website chat — she gives short, scannable answers and can help visitors with product questions, order support, and lead collection, and hand off to a human when needed.

You don't have to set Luna up separately:

  • She is enabled when you activate the widget.
  • She is paused when you deactivate it.
  • Replies sent through the widget appear under Luna's name.

To adjust her knowledge, behavior, or escalation rules, open the Agents area.

The Manage workspace​

Once the widget is active, the Web Widget menu shows a left-hand list of sections under Manage:

SectionWhat you do there
Widget StatusSee whether the widget is active, view usage stats, and run a connection test
Widget StudioDesign the widget — branding, colors, launcher, and screens. See Appearance & Branding
EngagementSet up proactive messages, pre-chat forms, and surveys. See Engagement & Forms
ResponsesReview form submissions and survey feedback from visitors
Embed CodeGet the code snippet to install the widget

How to check widget status​

The Widget Status page is your control panel for the widget itself.

  1. Open Web Widget → Widget Status.
  2. Check the status badge — it reads Active or Inactive and shows the date the widget was activated.
  3. Review the three usage cards: Total Sessions, Total Messages, and Total API Calls, plus the last activity time.
  4. To turn the widget off, click Deactivate (top right) and confirm. The widget stops working on your website until you reactivate it.

How to run a connection test​

  1. On the Widget Status page, find the Connection Test section.
  2. (Optional) Enter a test domain, for example https://example.com.
  3. Click Test Connection.
  4. Read the result — Fyncall reports whether the test succeeded or failed so you can confirm everything is wired up correctly.

How to review visitor responses​

The Responses section collects everything visitors submit through the widget — pre-chat form entries and post-chat survey feedback.

  1. Open Web Widget → Responses.
  2. Review the summary cards at the top: Form Submissions, Survey Responses, Average Rating, and a Last 7 Days total.
  3. Search by name, email, or visitor to find a specific entry.
  4. Filter by response type — form submissions, survey feedback, or both.
  5. Open a card to see the visitor's details, their form answers, and any rating or written feedback they left.

How to install the widget on your website​

  1. Open Web Widget → Embed Code.
  2. If your store runs on Shopify, inject the widget directly from this screen.
  3. For every other platform — plain HTML, WordPress, Google Tag Manager, React, Vue, and more — copy the snippet.
  4. Follow the step-by-step guide in Widget SDK → Installation to add it to your site.
Allowed domains

For security, the widget only loads on domains you've approved. Add your website to the allowed list in your widget security settings, as described in the installation guide.

Next steps​