cuoral-ionic 0.0.4 → 0.0.5

package/README.md

@@ -240,6 +240,65 @@ async login(email: string, firstName: string, lastName: string) {
 - Create a new Cuoral instance for each user login
 - Email, first name, and last name are all required for identified users
 
+## Push Notifications
+
+Cuoral integrates seamlessly with your existing push notification system using webhooks. When an agent sends a message, Cuoral sends a webhook to your backend, allowing you to send push notifications to users when the widget is closed.
+
+**How it works:**
+
+1. **Track widget state** in your app (open/closed)
+2. **Configure webhooks** in your Cuoral dashboard
+3. **Receive webhook** when agent sends message
+4. **Send FCM/APNs push** if widget is closed
+
+**Example Implementation:**
+
+```typescript
+export class MyApp {
+  private isCuoralWidgetOpen = false;
+
+  // When user opens support
+  openSupport() {
+    this.isCuoralWidgetOpen = true;
+    this.cuoral.openModal();
+  }
+
+  // When user closes support
+  closeSupport() {
+    this.isCuoralWidgetOpen = false;
+    this.cuoral.closeModal();
+  }
+
+  // Handle incoming push notifications (your existing FCM handler)
+  async handlePushNotification(message: any) {
+    if (message.data.type === 'cuoral_message') {
+      // Don't show notification if widget is already open
+      if (this.isCuoralWidgetOpen) {
+        return; // User already sees the message
+      }
+
+      // Show notification to user
+      await this.showNotification({
+        title: 'New message from Support',
+        body: message.data.text,
+      });
+
+      // When user taps notification, open widget
+      this.openSupport();
+    }
+  }
+}
+```
+
+**Setup:**
+
+1. Configure your webhook URL in Cuoral Dashboard → Settings → Webhooks
+2. Cuoral sends webhooks for all new messages
+3. Your backend decides whether to send push based on your app's state
+4. User taps notification → your app calls `cuoral.openModal()`
+
+This approach works with your existing FCM/APNs setup - no additional SDK configuration needed!
+
 ## Configuration
 
 ### CuoralOptions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cuoral-ionic",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Cuoral Ionic Framework Library - Proactive customer success platform with support ticketing, customer intelligence, screen recording, and engagement tools",
   "type": "module",
   "main": "dist/index.js",