@moveo-ai/web-client 0.110.0-true.1 → 0.110.0-true.2

package/README.md

@@ -215,13 +215,20 @@ payload listed below.
 | `onNoUnreadMessages(cb)`   | The unread indicator clears                    | —                                               |
 | `onUserActivity(cb)`       | The visitor interacts with the widget          | —                                               |
 | `onMemberLeave(cb)`        | An agent leaves the conversation               | —                                               |
-| `onAnalyticsEvent(cb)`     | Any interaction event (see below)              | `{ timestamp, event, session_id?, properties }` |
+| `onAnalyticsEvent(cb)`     | The widget loads, and every interaction        | `{ timestamp, event, session_id?, properties }` |
 
 `onAnalyticsEvent` receives every interaction the widget tracks, identified by
 the `event` field: `session_start`, `session_end`, `message_sent` (the user sent
 a message — never carries the text), `launcher_clicked`, `rating_submitted`, and
 the rest of the `AnalyticsEvent` enum in `src/hooks/useAnalytics.ts`.
 
+It also receives one event that is not an interaction: **`widget_loaded`**,
+raised as soon as the widget renders on the page. It carries no `session_id`,
+because a session opens only when the visitor opens the chat. Register the
+callback at any time — a callback added after the widget loaded still receives
+`widget_loaded` on registration, so the event cannot be missed in the race
+between `init()` resolving and your `.then()` running.
+
 ### Forward widget events into your analytics
 
 The widget never writes into your analytics tools. If you want chat activity in
@@ -232,9 +239,17 @@ and where. With Quantum Metric, for example:
 MoveoAI.init({ integrationId: 'YOUR_INTEGRATION_ID' }).then((controller) => {
   // Event ids must exist in your Quantum Metric configuration first:
   // sendEvent() silently drops ids that are not defined for the page.
-  const QM_MOVEO_SESSION = 901; // example ids — define your own
+  const QM_MOVEO_LOADED = 900; // example ids — define your own
+  const QM_MOVEO_SESSION = 901;
   const QM_MOVEO_MESSAGE = 902;
 
+  controller.onAnalyticsEvent(({ event }) => {
+    if (event === 'widget_loaded') {
+      // Fires on every page that carries the widget, with no visitor action.
+      window.QuantumMetricAPI?.sendEvent(QM_MOVEO_LOADED, 0, '');
+    }
+  });
+
   controller.onSessionCreated(({ session_id }) => {
     // The Moveo session id becomes searchable on the QM session,
     // joining every replay to its Moveo conversation.

package/dist/63.min.js.LICENSE.txt

@@ -1,6 +1,6 @@
 /*!
  * 
- *   @moveo-ai/web-client v0.110.0-true.1
+ *   @moveo-ai/web-client v0.110.0-true.2
  *   Copyright (c) Moveo.ai (TM)
  *
  */

package/dist/752.min.js.LICENSE.txt

@@ -1,6 +1,6 @@
 /*!
  * 
- *   @moveo-ai/web-client v0.110.0-true.1
+ *   @moveo-ai/web-client v0.110.0-true.2
  *   Copyright (c) Moveo.ai (TM)
  *
  */

package/dist/882.min.js.LICENSE.txt

@@ -1,6 +1,6 @@
 /*!
  * 
- *   @moveo-ai/web-client v0.110.0-true.1
+ *   @moveo-ai/web-client v0.110.0-true.2
  *   Copyright (c) Moveo.ai (TM)
  *
  */

package/dist/929.min.js.LICENSE.txt

@@ -1,6 +1,6 @@
 /*!
  * 
- *   @moveo-ai/web-client v0.110.0-true.1
+ *   @moveo-ai/web-client v0.110.0-true.2
  *   Copyright (c) Moveo.ai (TM)
  *
  */

package/dist/audio-client.min.js.LICENSE.txt

@@ -1,6 +1,6 @@
 /*!
  * 
- *   @moveo-ai/web-client v0.110.0-true.1
+ *   @moveo-ai/web-client v0.110.0-true.2
  *   Copyright (c) Moveo.ai (TM)
  *
  */