@developer.notchatbot/webchat 1.4.7 → 1.5.1

package/README.md

@@ -386,6 +386,11 @@ We emit **custom browser events** so you can capture interactions and feed them
 | WebChat | `notchatbot-webchat-closed` | The floating chat is closed | `{ conversationId }` |
 | WebChat | `notchatbot-webchat-message-sent` | The user sends one or more messages | `{ messages: Message[] }` |
 | WebChat | `notchatbot-webchat-message-received` | A message is received from the server | `{ message: Message, role: 'assistant' \| 'employee' }` |
+| WebChat | `notchatbot-webchat-button-click` | The round chat widget activator button is clicked | N/A |
+| WebChat | `notchatbot-chatbubble-popover-click` | The initial presentation chat bubble is clicked | N/A |
+| WebChat | `notchatbot-webchat-menu-whatsapp-click` | The WhatsApp button inside the WebChat multi-option menu is clicked | N/A |
+| WebChat | `notchatbot-webchat-menu-webchat-click` | The standard Webchat button inside the multi-option menu is clicked | N/A |
+| WhatsApp | `notchatbot-whatsapp-button-click` | The standalone WhatsApp widget is clicked | N/A |
 | EmbedChat | `notchatbot-embedchat-message-sent` | The user sends a message | `{ message: Message }` |
 | EmbedChat | `notchatbot-embedchat-message-received` | A message is received | `{ message: Message, role: 'assistant' \| 'employee' }` |
 
@@ -403,7 +408,9 @@ window.addEventListener('notchatbot-webchat-message-received', e => {
 ```
 
 #### Google Tag Manager / Google Analytics (GA4)
-Push data directly to the **dataLayer** and create a trigger in GTM:
+**NEW:** All the events listed above are automatically pushed to the **dataLayer** simultaneously, alongside the window events! This means you can just create a trigger in GTM for `notchatbot-webchat-message-sent` or `notchatbot-whatsapp-button-click` right out of the box, without writing manual JS event listeners. 
+
+If you prefer firing custom data structures or if you need the message contents cleanly mapped, you can still listen to the `window` events and push to dataLayer manually:
 ```js
 window.addEventListener('notchatbot-webchat-message-sent', e => {
   window.dataLayer = window.dataLayer || [];
@@ -414,7 +421,7 @@ window.addEventListener('notchatbot-webchat-message-sent', e => {
   });
 });
 ```
-Then in GTM, add a **Custom Event** trigger called `webchat_message_sent` and link it to a GA4 event tag.
+Then in GTM, add a **Custom Event** trigger called `webchat_message_sent` (or `notchatbot-webchat-message-sent` natively) and link it to a GA4 event tag.
 
 #### Meta / Facebook Pixel
 ```js