wuzapi 1.4.0 → 1.5.1

package/README.md

@@ -2,9 +2,9 @@
 
 A comprehensive TypeScript client library for the [WuzAPI WhatsApp API](https://github.com/asternic/wuzapi). This library provides a simple and intuitive interface to interact with WhatsApp through the WuzAPI service.
 
-## Features
+## 🚀 Features
 
-- 🔥 **Full TypeScript Support** - Complete type definitions for all API endpoints
+- 🔥 **Full TypeScript Support** - Complete type definitions for all API endpoints  
 - 🏗️ **Modular Architecture** - Organized by functionality (admin, session, chat, user, group, webhook)
 - 🚀 **Promise-based** - Modern async/await support
 - 🛡️ **Error Handling** - Comprehensive error handling with detailed error types
@@ -12,7 +12,7 @@ A comprehensive TypeScript client library for the [WuzAPI WhatsApp API](https://
 - 🔧 **Easy Configuration** - Simple setup with minimal configuration
 - 📖 **Well Documented** - Extensive documentation and examples
 
-## Installation
+## 📦 Installation
 
 ```bash
 npm install wuzapi
@@ -24,9 +24,9 @@ or
 yarn add wuzapi
 ```
 
-## Quick Start
+## ⚡ Quick Start
 
-### Traditional Usage (Global Token)
+### Basic Setup
 
 ```typescript
 import WuzapiClient from "wuzapi";
@@ -42,116 +42,225 @@ await client.session.connect({
   Immediate: false,
 });
 
-// Send a text message
+// Send a message
 await client.chat.sendText({
   Phone: "5491155554444",
-  Body: "Hello from WuzAPI!",
+  Body: "Hello from WuzAPI! 🎉",
 });
+```
 
-// Get session status
-const status = await client.session.getStatus();
-console.log("Connected:", status.Connected);
-console.log("Logged In:", status.LoggedIn);
+### Login Options
+
+#### Option 1: QR Code (Traditional)
+```typescript
+// Get QR code for scanning
+const qr = await client.session.getQRCode();
+console.log("Scan this QR code:", qr.QRCode);
+```
+
+#### Option 2: Phone Pairing (New!)
+```typescript
+// Pair using verification code (SMS/Call)
+await client.session.pairPhone("5491155554444", "123456");
 ```
 
-### Flexible Token Usage
+## 🔧 Configuration
 
 ```typescript
-import WuzapiClient from "wuzapi";
+interface WuzapiConfig {
+  apiUrl: string;     // Your WuzAPI server URL
+  token?: string;     // Authentication token (can be provided per request)
+}
 
-// Create client without token (or with admin token)
+// Global token approach
 const client = new WuzapiClient({
   apiUrl: "http://localhost:8080",
-  token: "admin-token", // Optional: admin token as default
+  token: "your-token",
 });
 
-// Use specific user token for operations
-const userToken = "user-specific-token";
-
-// Connect with user token
-await client.session.connect(
-  {
-    Subscribe: ["Message", "ReadReceipt"],
-    Immediate: false,
-  },
-  { token: userToken }
-);
+// Flexible token approach
+const client = new WuzapiClient({
+  apiUrl: "http://localhost:8080",
+});
 
-// Send message with user token
+// Use different tokens for different operations
 await client.chat.sendText(
-  {
-    Phone: "5491155554444",
-    Body: "Hello from user-specific token!",
-  },
-  { token: userToken }
+  { Phone: "123", Body: "Hello" },
+  { token: "user-specific-token" }
 );
+```
+
+## 💬 Essential Chat Operations
+
+```typescript
+// Send text message
+await client.chat.sendText({
+  Phone: "5491155554444",
+  Body: "Hello World!",
+});
+
+// Send image
+await client.chat.sendImage({
+  Phone: "5491155554444",
+  Image: "data:image/jpeg;base64,/9j/4AAQ...",
+  Caption: "Check this out!",
+});
+
+// Send interactive buttons
+await client.chat.sendButtons({
+  Phone: "5491155554444",
+  Body: "Choose an option:",
+  Buttons: [
+    { ButtonId: "yes", ButtonText: { DisplayText: "Yes" }, Type: 1 },
+    { ButtonId: "no", ButtonText: { DisplayText: "No" }, Type: 1 },
+  ],
+});
+
+// Send list menu
+await client.chat.sendList({
+  Phone: "5491155554444",
+  Body: "Select from menu:",
+  Title: "Options",
+  ButtonText: "View Menu",
+  Sections: [{
+    Title: "Main Options",
+    Rows: [
+      { Title: "Option 1", Description: "First choice", RowId: "opt1" },
+      { Title: "Option 2", Description: "Second choice", RowId: "opt2" },
+    ],
+  }],
+});
+
+// Send poll
+await client.chat.sendPoll({
+  Phone: "5491155554444",
+  Name: "What's your favorite color?",
+  Options: [{ Name: "Red" }, { Name: "Blue" }, { Name: "Green" }],
+  SelectableCount: 1,
+});
+```
+
+## 👥 Group Management
+
+```typescript
+// Create group
+const group = await client.group.create("My Group", [
+  "5491155553934",
+  "5491155553935",
+]);
 
-// Admin operations with admin token (uses default)
-const users = await client.admin.listUsers();
+// Get group info
+const info = await client.group.getInfo(group.JID);
 
-// Or explicitly use admin token
-const newUser = await client.admin.addUser(
-  { name: "John", token: "new-user-token" },
-  { token: "admin-token" }
+// Add participants
+await client.group.updateParticipants(
+  group.JID,
+  "add",
+  ["5491155553936"]
 );
+
+// Set group settings
+await client.group.setName(group.JID, "New Group Name");
+await client.group.setTopic(group.JID, "Welcome message");
+await client.group.setAnnounce(group.JID, true); // Only admins can send
 ```
 
-## Configuration
+## 👤 User Operations
+
+```typescript
+// Check if numbers are WhatsApp users
+const check = await client.user.check(["5491155554444"]);
+
+// Get user info
+const info = await client.user.getInfo(["5491155554444"]);
+
+// Get contacts
+const contacts = await client.user.getContacts();
+
+// Send presence status
+await client.user.sendPresence({
+  Phone: "5491155554444",
+  State: "available",
+});
+```
 
-The client requires a configuration object with the following properties:
+## 🔗 Webhook Setup
 
 ```typescript
-interface WuzapiConfig {
-  apiUrl: string; // The WuzAPI server URL
-  token?: string; // Your user authentication token (optional)
-}
+// Set webhook URL
+await client.webhook.setWebhook("https://your-server.com/webhook");
 
-interface RequestOptions {
-  token?: string; // Token override for specific requests
-}
+// Get webhook config
+const config = await client.webhook.getWebhook();
+
+// Update webhook
+await client.webhook.updateWebhook("https://new-server.com/webhook");
 ```
 
-### Authentication Options
+## 📚 Examples
+
+Check out the complete examples in the `examples/` directory:
+
+- **[basic-usage.js](examples/basic-usage.js)** - Getting started, connection, basic operations
+- **[advanced-features.js](examples/advanced-features.js)** - Phone pairing, interactive messages, advanced group management  
+- **[chatbot-example.js](examples/chatbot-example.js)** - Complete bot with commands and auto-replies
+- **[webhook-events-example.js](examples/webhook-events-example.js)** - Comprehensive webhook event handling
 
-You have two ways to handle authentication:
+### Run Examples
 
-1. **Global Token**: Set a default token in the client configuration
-2. **Per-Request Token**: Override the token for specific API calls
+```bash
+# Basic usage
+node examples/basic-usage.js
+
+# Advanced features  
+node examples/advanced-features.js
+
+# Start chatbot
+node examples/chatbot-example.js
+```
+
+## 🤖 Simple Bot Example
 
 ```typescript
-// Option 1: Global token (traditional usage)
-const client = new WuzapiClient({
-  apiUrl: "http://localhost:8080",
-  token: "your-default-token",
-});
+import WuzapiClient from "wuzapi";
 
-// Option 2: No global token, specify per request
 const client = new WuzapiClient({
   apiUrl: "http://localhost:8080",
-  // token is optional
+  token: "your-token",
 });
 
-// Option 3: Global token with per-request overrides
-const client = new WuzapiClient({
-  apiUrl: "http://localhost:8080",
-  token: "admin-token", // Default admin token
-});
+// Connect and wait for messages
+await client.session.connect({ Subscribe: ["Message"] });
+await client.webhook.setWebhook("https://your-server.com/webhook");
 
-// Use different token for specific operations
-await client.chat.sendText(
-  { Phone: "5491155554444", Body: "Hello!" },
-  { token: "user-specific-token" }
-);
+// In your webhook handler:
+app.post("/webhook", async (req, res) => {
+  const { event } = req.body;
+  
+  if (event?.Message?.conversation) {
+    const message = event.Message.conversation;
+    const from = event.Info.RemoteJid.replace("@s.whatsapp.net", "");
+    
+    if (message.toLowerCase().includes("hello")) {
+      await client.chat.sendText({
+        Phone: from,
+        Body: "Hello! 👋 How can I help you?",
+      });
+    }
+  }
+  
+  res.json({ success: true });
+});
 ```
 
-## API Modules
-
-The client is organized into logical modules:
+---
 
-### Session Module
+## 📖 Complete API Reference
 
-Manage WhatsApp connection and session state.
+<details>
+<summary><strong>📱 Session Module</strong> - Connection and authentication</summary>
 
+### Connection
 ```typescript
 // Connect to WhatsApp
 await client.session.connect({
@@ -162,15 +271,30 @@ await client.session.connect({
 // Get connection status
 const status = await client.session.getStatus();
 
-// Get QR code for initial setup
-const qr = await client.session.getQRCode();
-
 // Disconnect (keeps session)
 await client.session.disconnect();
 
 // Logout (destroys session)
 await client.session.logout();
+```
+
+### Authentication
+```typescript
+// Get QR code for scanning
+const qr = await client.session.getQRCode();
+
+// Pair phone using verification code (alternative to QR)
+await client.session.pairPhone("5491155554444", "123456");
+
+// Request message history sync
+await client.session.requestHistory();
+
+// Configure proxy
+await client.session.setProxy("socks5://user:pass@proxy:port");
+```
 
+### S3 Storage
+```typescript
 // Configure S3 storage
 await client.session.configureS3({
   enabled: true,
@@ -183,29 +307,31 @@ await client.session.configureS3({
   mediaDelivery: "both",
   retentionDays: 30,
 });
+
+// Get S3 configuration
+const s3Config = await client.session.getS3Config();
+
+// Test S3 connection
+await client.session.testS3();
+
+// Delete S3 configuration
+await client.session.deleteS3Config();
 ```
 
-### Chat Module
+</details>
 
-Send messages and manage chat interactions.
+<details>
+<summary><strong>💬 Chat Module</strong> - Send and manage messages</summary>
 
+### Basic Messages
 ```typescript
-// Send text message (using global token)
+// Send text message
 await client.chat.sendText({
   Phone: "5491155554444",
   Body: "Hello World!",
   Id: "optional-message-id",
 });
 
-// Send with specific token override
-await client.chat.sendText(
-  {
-    Phone: "5491155554444",
-    Body: "Hello with custom token!",
-  },
-  { token: "user-specific-token" }
-);
-
 // Reply to a message
 await client.chat.sendText({
   Phone: "5491155554444",
@@ -215,47 +341,97 @@ await client.chat.sendText({
     Participant: "5491155553935@s.whatsapp.net",
   },
 });
+```
 
+### Media Messages
+```typescript
 // Send image
 await client.chat.sendImage({
   Phone: "5491155554444",
-  Image: "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ...",
+  Image: "data:image/jpeg;base64,/9j/4AAQ...",
   Caption: "Check this out!",
 });
 
-// Send template message with buttons
-await client.chat.sendTemplate({
+// Send audio
+await client.chat.sendAudio({
+  Phone: "5491155554444",
+  Audio: "data:audio/ogg;base64,T2dnUw...",
+});
+
+// Send video
+await client.chat.sendVideo({
+  Phone: "5491155554444",
+  Video: "data:video/mp4;base64,AAAAIGZ0eXA...",
+  Caption: "Video caption",
+});
+
+// Send document
+await client.chat.sendDocument({
+  Phone: "5491155554444",
+  Document: "data:application/pdf;base64,JVBERi0x...",
+  FileName: "document.pdf",
+});
+
+// Send sticker
+await client.chat.sendSticker({
+  Phone: "5491155554444",
+  Sticker: "data:image/webp;base64,UklGRuI...",
+});
+```
+
+### Interactive Messages
+```typescript
+// Send buttons
+await client.chat.sendButtons({
   Phone: "5491155554444",
-  Content: "Choose an option:",
-  Footer: "Powered by WuzAPI",
+  Body: "Choose an option:",
+  Footer: "Select one:",
   Buttons: [
-    { DisplayText: "Yes", Type: "quickreply" },
-    { DisplayText: "No", Type: "quickreply" },
-    { DisplayText: "Visit Site", Type: "url", Url: "https://example.com" },
-    { DisplayText: "Call Us", Type: "call", PhoneNumber: "1155554444" },
+    { ButtonId: "option1", ButtonText: { DisplayText: "Option 1" }, Type: 1 },
+    { ButtonId: "option2", ButtonText: { DisplayText: "Option 2" }, Type: 1 },
   ],
 });
 
-// Send location
-await client.chat.sendLocation({
+// Send list message
+await client.chat.sendList({
   Phone: "5491155554444",
-  Latitude: 48.85837,
-  Longitude: 2.294481,
-  Name: "Eiffel Tower, Paris",
+  Body: "Please select from the menu:",
+  Title: "Menu Options",
+  ButtonText: "View Menu",
+  Sections: [
+    {
+      Title: "Main Course",
+      Rows: [
+        { Title: "Pizza", Description: "Delicious pizza", RowId: "pizza" },
+        { Title: "Burger", Description: "Tasty burger", RowId: "burger" },
+      ],
+    },
+  ],
 });
 
-// Send contact
-await client.chat.sendContact({
+// Send poll
+await client.chat.sendPoll({
   Phone: "5491155554444",
-  Name: "John Doe",
-  Vcard:
-    "BEGIN:VCARD\nVERSION:3.0\nN:Doe;John;;;\nFN:John Doe\nTEL:+1234567890\nEND:VCARD",
+  Name: "What's your favorite color?",
+  Options: [{ Name: "Red" }, { Name: "Blue" }, { Name: "Green" }],
+  SelectableCount: 1,
 });
+```
 
-// Mark messages as read
-await client.chat.markRead({
-  Id: ["message-id-1", "message-id-2"],
-  Chat: "5491155553934@s.whatsapp.net",
+### Message Management
+```typescript
+// Delete a message
+await client.chat.deleteMessage({
+  Phone: "5491155554444",
+  Id: "message-id-to-delete",
+  Remote: true, // Delete for everyone
+});
+
+// Edit a message
+await client.chat.editMessage({
+  Phone: "5491155554444",
+  MessageId: "message-id-to-edit",
+  NewText: "This is the updated message text",
 });
 
 // React to message
@@ -265,6 +441,40 @@ await client.chat.react({
   Id: "message-id-to-react-to",
 });
 
+// Mark messages as read
+await client.chat.markRead({
+  Id: ["message-id-1", "message-id-2"],
+  Chat: "5491155553934@s.whatsapp.net",
+});
+
+// Send chat presence (typing indicator)
+await client.chat.sendPresence({
+  Phone: "5491155554444",
+  State: "composing", // or "paused"
+  Media: "text",
+});
+```
+
+### Location and Contacts
+```typescript
+// Send location
+await client.chat.sendLocation({
+  Phone: "5491155554444",
+  Latitude: 48.85837,
+  Longitude: 2.294481,
+  Name: "Eiffel Tower, Paris",
+});
+
+// Send contact
+await client.chat.sendContact({
+  Phone: "5491155554444",
+  Name: "John Doe",
+  Vcard: "BEGIN:VCARD\nVERSION:3.0\nN:Doe;John;;;\nFN:John Doe\nTEL:+1234567890\nEND:VCARD",
+});
+```
+
+### Media Download
+```typescript
 // Download media
 const media = await client.chat.downloadImage({
   Url: "https://mmg.whatsapp.net/d/f/...",
@@ -275,9 +485,10 @@ const media = await client.chat.downloadImage({
 });
 ```
 
-### User Module
+</details>
 
-Get information about WhatsApp users.
+<details>
+<summary><strong>👤 User Module</strong> - User information and contacts</summary>
 
 ```typescript
 // Check if numbers are WhatsApp users
@@ -291,12 +502,21 @@ const avatar = await client.user.getAvatar("5491155554444", true); // true for p
 
 // Get all contacts
 const contacts = await client.user.getContacts();
+
+// Send user presence (online/offline status)
+await client.user.sendPresence({
+  Phone: "5491155554444",
+  State: "available", // or "unavailable"
+  LastSeen: Date.now(),
+});
 ```
 
-### Group Module
+</details>
 
-Manage WhatsApp groups.
+<details>
+<summary><strong>👥 Group Module</strong> - Group management</summary>
 
+### Basic Group Operations
 ```typescript
 // List all groups
 const groups = await client.group.list();
@@ -310,84 +530,108 @@ const newGroup = await client.group.create("My New Group", [
 // Get group info
 const groupInfo = await client.group.getInfo("120362023605733675@g.us");
 
+// Leave a group
+await client.group.leave("120362023605733675@g.us");
+```
+
+### Group Settings
+```typescript
 // Set group name
 await client.group.setName("120362023605733675@g.us", "New Group Name");
 
-// Set group photo (JPEG only)
-await client.group.setPhoto(
+// Set group topic/description
+await client.group.setTopic(
   "120362023605733675@g.us",
-  "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ..."
+  "Welcome to our group! Please read the rules."
 );
 
-// Get invite link
-const invite = await client.group.getInviteLink("120362023605733675@g.us");
+// Set group announcement setting (only admins can send messages)
+await client.group.setAnnounce("120362023605733675@g.us", true);
 
 // Set group locked (only admins can modify info)
 await client.group.setLocked("120362023605733675@g.us", true);
 
 // Set disappearing messages
 await client.group.setEphemeral("120362023605733675@g.us", "24h"); // '24h', '7d', '90d', or 'off'
+```
+
+### Group Media
+```typescript
+// Set group photo (JPEG only)
+await client.group.setPhoto(
+  "120362023605733675@g.us",
+  "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQ..."
+);
 
 // Remove group photo
 await client.group.removePhoto("120362023605733675@g.us");
 ```
 
-### Admin Module
+### Invites and Participants
+```typescript
+// Get invite link
+const invite = await client.group.getInviteLink("120362023605733675@g.us");
 
-Manage users (requires admin token).
+// Join a group using invite link
+const joinResult = await client.group.join("https://chat.whatsapp.com/XXXXXXXXX");
 
-```typescript
-// Option 1: Create dedicated admin client
-const adminClient = new WuzapiClient({
-  apiUrl: "http://localhost:8080",
-  token: "your-admin-token",
-});
+// Get group invite information
+const inviteInfo = await client.group.getInviteInfo("https://chat.whatsapp.com/XXXXXXXXX");
 
-// List all users
-const users = await adminClient.admin.listUsers();
+// Update group participants (add, remove, promote, demote)
+await client.group.updateParticipants(
+  "120362023605733675@g.us",
+  "add", // "add", "remove", "promote", "demote"
+  ["5491155553936", "5491155553937"]
+);
+```
 
-// Option 2: Use shared client with token override
-const client = new WuzapiClient({
-  apiUrl: "http://localhost:8080",
-  // No default token or user token as default
-});
+</details>
 
-// Admin operations with explicit admin token
+<details>
+<summary><strong>👨‍💼 Admin Module</strong> - User management (requires admin token)</summary>
+
+```typescript
+// List all users
 const users = await client.admin.listUsers({ token: "admin-token" });
 
+// Get a specific user by ID
+const user = await client.admin.getUser(2, { token: "admin-token" });
+
 // Add new user
-const newUser = await client.admin.addUser(
-  {
-    name: "John Doe",
-    token: "user-token-123",
-    webhook: "https://example.com/webhook",
-    events: "Message,ReadReceipt",
-    proxyConfig: {
-      enabled: true,
-      proxyURL: "socks5://user:pass@proxy:port",
-    },
-    s3Config: {
-      enabled: true,
-      endpoint: "https://s3.amazonaws.com",
-      region: "us-east-1",
-      bucket: "user-media-bucket",
-      accessKey: "AKIA...",
-      secretKey: "secret...",
-      pathStyle: false,
-      mediaDelivery: "both",
-      retentionDays: 30,
-    },
+const newUser = await client.admin.addUser({
+  name: "John Doe",
+  token: "user-token-123",
+  webhook: "https://example.com/webhook",
+  events: "Message,ReadReceipt",
+  proxyConfig: {
+    enabled: true,
+    proxyURL: "socks5://user:pass@proxy:port",
   },
-  { token: "admin-token" }
-);
+  s3Config: {
+    enabled: true,
+    endpoint: "https://s3.amazonaws.com",
+    region: "us-east-1",
+    bucket: "user-media-bucket",
+    accessKey: "AKIA...",
+    secretKey: "secret...",
+    pathStyle: false,
+    mediaDelivery: "both",
+    retentionDays: 30,
+  },
+}, { token: "admin-token" });
 
 // Delete user
 await client.admin.deleteUser(2, { token: "admin-token" });
+
+// Delete user completely (full deletion including all data)
+await client.admin.deleteUserComplete(2, { token: "admin-token" });
 ```
 
-### Webhook Module
+</details>
 
-Configure webhook settings and handle incoming WhatsApp events.
+<details>
+<summary><strong>🔗 Webhook Module</strong> - Webhook configuration</summary>
 
 ```typescript
 // Set webhook URL
@@ -397,134 +641,44 @@ await client.webhook.setWebhook("https://my-server.com/webhook");
 const webhookConfig = await client.webhook.getWebhook();
 console.log("Webhook URL:", webhookConfig.webhook);
 console.log("Subscribed events:", webhookConfig.subscribe);
-```
 
-## Webhook Event Handling
+// Update webhook URL
+await client.webhook.updateWebhook("https://my-new-server.com/webhook");
 
-WuzAPI sends real-time events to your webhook endpoint. Here's how to handle different types of events:
-
-## Webhook Payload Structure
+// Delete webhook configuration
+await client.webhook.deleteWebhook();
+```
 
-When S3 is enabled, webhook payloads will include S3 information based on the `media_delivery` setting configured in your WuzAPI instance.
+</details>
 
-### Standard Event Payload
+<details>
+<summary><strong>📰 Newsletter Module</strong> - Newsletter management (Business accounts only)</summary>
 
-```json
-{
-  "event": {
-    "Info": {
-      "ID": "3EB06F9067F80BAB89FF",
-      "Type": "text",
-      "PushName": "John Doe",
-      "Timestamp": "2024-12-25T10:30:00Z",
-      "Source": {
-        "Chat": "5491155553934@s.whatsapp.net",
-        "Sender": "5491155553934@s.whatsapp.net",
-        "IsFromMe": false,
-        "IsGroup": false
-      }
-    },
-    "Message": {
-      "conversation": "Hello, this is a test message!"
-    },
-    "IsEphemeral": false,
-    "IsViewOnce": false,
-    "IsDocumentWithCaption": false,
-    "IsEdit": false
-  }
-}
+```typescript
+// List all subscribed newsletters
+const newsletters = await client.newsletter.list();
+
+newsletters.Newsletters.forEach((newsletter) => {
+  console.log(`Newsletter: ${newsletter.Name}`);
+  console.log(`Description: ${newsletter.Description}`);
+  console.log(`Handle: ${newsletter.Handle}`);
+  console.log(`State: ${newsletter.State}`);
+});
 ```
 
-### S3 Only (`media_delivery: "s3"`)
-
-```json
-{
-  "event": {
-    "Info": {
-      "ID": "3EB06F9067F80BAB89FF",
-      "Type": "image",
-      "PushName": "John Doe",
-      "Timestamp": "2024-12-25T10:30:00Z",
-      "Source": {
-        "Chat": "5491155553934@s.whatsapp.net",
-        "Sender": "5491155553934@s.whatsapp.net",
-        "IsFromMe": false,
-        "IsGroup": false
-      }
-    },
-    "Message": {
-      "imageMessage": {
-        "caption": "Check out this photo!",
-        "mimetype": "image/jpeg",
-        "width": 1920,
-        "height": 1080,
-        "fileLength": 245632
-      }
-    },
-    "IsEphemeral": false,
-    "IsViewOnce": false
-  },
-  "s3": {
-    "url": "https://my-bucket.s3.us-east-1.amazonaws.com/users/abc123/inbox/5491155553934/2024/12/25/images/3EB06F9067F80BAB89FF.jpg",
-    "key": "users/abc123/inbox/5491155553934/2024/12/25/images/3EB06F9067F80BAB89FF.jpg",
-    "bucket": "my-bucket",
-    "size": 245632,
-    "mimeType": "image/jpeg",
-    "fileName": "3EB06F9067F80BAB89FF.jpg"
-  }
-}
-```
+</details>
 
-### Both S3 and Base64 (`media_delivery: "both"`)
-
-```json
-{
-  "event": {
-    "Info": { "..." },
-    "Message": {
-      "imageMessage": {
-        "caption": "Check out this photo!",
-        "mimetype": "image/jpeg",
-        "width": 1920,
-        "height": 1080
-      }
-    }
-  },
-  "base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAABAAEDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAv/xAAUEAEAAAAAAAAAAAAAAAAAAAAA/8QAFQEBAQAAAAAAAAAAAAAAAAAAAAX/xAAUEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwCdABmX/9k=",
-  "mimeType": "image/jpeg",
-  "fileName": "3EB06F9067F80BAB89FF.jpg",
-  "s3": {
-    "url": "https://my-bucket.s3.us-east-1.amazonaws.com/users/abc123/inbox/5491155553934/2024/12/25/images/3EB06F9067F80BAB89FF.jpg",
-    "key": "users/abc123/inbox/5491155553934/2024/12/25/images/3EB06F9067F80BAB89FF.jpg",
-    "bucket": "my-bucket",
-    "size": 245632,
-    "mimeType": "image/jpeg",
-    "fileName": "3EB06F9067F80BAB89FF.jpg"
-  }
-}
-```
+---
 
-### Base64 Only (`media_delivery: "base64"`)
+## 🎣 Webhook Event Handling
 
-```json
-{
-  "event": { "..." },
-  "base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAABAAEDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAv/xAAUEAEAAAAAAAAAAAAAAAAAAAAA/8QAFQEBAQAAAAAAAAAAAAAAAAAAAAX/xAAUEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwCdABmX/9k=",
-  "mimeType": "image/jpeg",
-  "fileName": "3EB06F9067F80BAB89FF.jpg"
-}
-```
+WuzAPI sends real-time events to your webhook endpoint. Here's how to handle them:
 
 ### Basic Webhook Setup
 
 ```typescript
 import express from "express";
-import WuzapiClient, {
-  EventType,
-  hasS3Media,
-  hasBase64Media,
-  WebhookPayload,
-} from "wuzapi";
+import WuzapiClient, { getMessageContent, hasS3Media } from "wuzapi";
 
 const app = express();
 app.use(express.json());
@@ -534,787 +688,73 @@ const client = new WuzapiClient({
   token: "your-token",
 });
 
-// Webhook endpoint with S3 media support
 app.post("/webhook", async (req, res) => {
   try {
-    const webhookPayload: WebhookPayload = req.body;
-
-    // Handle S3 media information if present
+    const webhookPayload = req.body;
+    
+    // Handle S3 media if present
     if (hasS3Media(webhookPayload)) {
-      console.log("☁️ S3 Media:", {
-        url: webhookPayload.s3.url,
-        bucket: webhookPayload.s3.bucket,
-        size: webhookPayload.s3.size,
-        type: webhookPayload.s3.mimeType,
-      });
-    }
-
-    if (hasBase64Media(webhookPayload)) {
-      console.log("📦 Base64 media included");
-      // Process base64 media: webhookPayload.base64
+      console.log("S3 Media:", webhookPayload.s3.url);
     }
-
-    // Extract the actual event data
+    
     const event = webhookPayload.event || webhookPayload;
-    const eventType = detectEventType(event);
-
-    // Handle different event types using EventType enum
-    switch (eventType) {
-      case EventType.MESSAGE:
-        await handleMessage(event);
-        break;
-      case EventType.RECEIPT:
-        await handleReceipt(event);
-        break;
-      case EventType.PRESENCE:
-        await handlePresence(event);
-        break;
-      default:
-        console.log(`Unhandled event type: ${eventType}`);
-    }
-
-    res.status(200).json({ success: true });
-  } catch (error) {
-    console.error("Webhook error:", error);
-    res.status(500).json({ error: error.message });
-  }
-});
-
-// Helper function to detect event type
-function detectEventType(event: any): EventType | string {
-  if (event.Message && event.Info) return EventType.MESSAGE;
-  if (event.MessageIDs && event.Type) return EventType.RECEIPT;
-  if (event.From && typeof event.Unavailable !== "undefined")
-    return EventType.PRESENCE;
-  if (event.State && event.MessageSource) return EventType.CHAT_PRESENCE;
-  if (event.Codes) return EventType.QR;
-  // Add more detection logic as needed
-  return "Unknown";
-}
-
-app.listen(3000, () => {
-  console.log("Webhook server running on port 3000");
-});
-```
-
-### Message Events
-
-Handle incoming messages of all types using the comprehensive Message types:
-
-```typescript
-import { getMessageContent } from "wuzapi";
-
-async function handleMessage(event) {
-  const { Info, Message, IsEphemeral, IsViewOnce } = event;
-  const from = Info.RemoteJid.replace("@s.whatsapp.net", "");
-  const isGroup = Info.RemoteJid.includes("@g.us");
-
-  console.log(`New message from ${from}${isGroup ? " (group)" : ""}`);
-
-  if (IsEphemeral) console.log("⏱️ Ephemeral message");
-  if (IsViewOnce) console.log("👁️ View once message");
-
-  // Use the utility function to get structured message content
-  const messageContent = getMessageContent(Message);
-
-  if (!messageContent) {
-    console.log("❓ Unknown message type");
-    return;
-  }
-
-  // Handle different message types with full type safety
-  switch (messageContent.type) {
-    case "text":
-      console.log(`💬 Text: ${messageContent.content}`);
-
-      // Auto-reply to specific messages
-      if (messageContent.content.toLowerCase().includes("hello")) {
-        await client.chat.sendText({
-          Phone: from,
-          Body: "👋 Hello! Thanks for your message.",
-        });
-      }
-      break;
-
-    case "extendedText":
-      console.log(`📝 Extended text: ${messageContent.content.text}`);
-      if (messageContent.content.canonicalUrl) {
-        console.log(`🔗 Link preview: ${messageContent.content.canonicalUrl}`);
-        console.log(`📰 Title: ${messageContent.content.title}`);
-      }
-      break;
-
-    case "image":
-      const imageMsg = messageContent.content;
-      console.log(`🖼️ Image: ${imageMsg.caption || "No caption"}`);
-      console.log(`📏 Dimensions: ${imageMsg.width}x${imageMsg.height}`);
-
-      // Download the image with proper types
-      if (imageMsg.url && imageMsg.mediaKey) {
-        try {
-          const media = await client.chat.downloadImage({
-            Url: imageMsg.url,
-            MediaKey: Array.from(imageMsg.mediaKey),
-            Mimetype: imageMsg.mimetype,
-            FileSHA256: Array.from(imageMsg.fileSha256),
-            FileLength: imageMsg.fileLength,
-          });
-          console.log("✅ Image downloaded successfully");
-        } catch (error) {
-          console.log("❌ Failed to download image:", error.message);
-        }
-      }
-      break;
-
-    case "video":
-      const videoMsg = messageContent.content;
-      console.log(`🎥 Video: ${videoMsg.caption || "No caption"}`);
-      console.log(`⏱️ Duration: ${videoMsg.seconds}s`);
-      if (videoMsg.gifPlayback) {
-        console.log("🎬 GIF playback enabled");
-      }
-      break;
-
-    case "audio":
-      const audioMsg = messageContent.content;
-      console.log(`🎵 Audio: ${audioMsg.seconds}s`);
-      if (audioMsg.ptt) {
-        console.log("🎤 Voice note (Push-to-talk)");
-      }
-      break;
-
-    case "document":
-      const docMsg = messageContent.content;
-      console.log(`📄 Document: ${docMsg.fileName || docMsg.title}`);
-      console.log(`📊 Size: ${docMsg.fileLength} bytes`);
-      console.log(`📋 Type: ${docMsg.mimetype}`);
-      break;
-
-    case "location":
-      const locMsg = messageContent.content;
-      console.log(
-        `📍 Location: ${locMsg.degreesLatitude}, ${locMsg.degreesLongitude}`
-      );
-      if (locMsg.name) console.log(`🏷️ Name: ${locMsg.name}`);
-      if (locMsg.isLiveLocation) console.log("📡 Live location sharing");
-      break;
-
-    case "contact":
-      console.log(`👤 Contact: ${messageContent.content.displayName}`);
-      break;
-
-    case "sticker":
-      const stickerMsg = messageContent.content;
-      console.log(`😀 Sticker`);
-      if (stickerMsg.isAnimated) console.log("🎬 Animated");
-      if (stickerMsg.isLottie) console.log("🎨 Lottie");
-      break;
-
-    case "buttons":
-      const btnMsg = messageContent.content;
-      console.log(`🔘 Interactive buttons: ${btnMsg.contentText}`);
-      console.log(`🔢 ${btnMsg.buttons?.length || 0} buttons`);
-      break;
-
-    case "list":
-      const listMsg = messageContent.content;
-      console.log(`📋 List: ${listMsg.title}`);
-      console.log(`📝 ${listMsg.sections?.length || 0} sections`);
-      break;
-
-    case "buttonsResponse":
-      const btnResponse = messageContent.content;
-      console.log(`✅ Button clicked: ${btnResponse.selectedDisplayText}`);
-      console.log(`🆔 Button ID: ${btnResponse.selectedButtonId}`);
-
-      // Handle button responses
-      switch (btnResponse.selectedButtonId) {
-        case "help":
+    
+    // Handle messages
+    if (event.Message && event.Info) {
+      const messageContent = getMessageContent(event.Message);
+      const from = event.Info.RemoteJid.replace("@s.whatsapp.net", "");
+      
+      if (messageContent?.type === "text") {
+        console.log(`Message from ${from}: ${messageContent.content}`);
+        
+        // Auto-reply
+        if (messageContent.content.toLowerCase().includes("hello")) {
           await client.chat.sendText({
             Phone: from,
-            Body: "🆘 How can I help you?",
+            Body: "Hello! 👋 How can I help you?",
           });
-          break;
-        case "info":
-          await client.chat.sendText({
-            Phone: from,
-            Body: "ℹ️ Here's some information...",
-          });
-          break;
-      }
-      break;
-
-    case "listResponse":
-      const listResponse = messageContent.content;
-      console.log(`✅ List selection: ${listResponse.title}`);
-      if (listResponse.singleSelectReply) {
-        console.log(
-          `🆔 Selected: ${listResponse.singleSelectReply.selectedRowId}`
-        );
-      }
-      break;
-
-    case "poll":
-      const pollMsg = messageContent.content;
-      console.log(`📊 Poll: ${pollMsg.name}`);
-      console.log(`🔢 Options: ${pollMsg.options?.length || 0}`);
-      break;
-
-    case "reaction":
-      const reactionMsg = messageContent.content;
-      console.log(`😊 Reaction: ${reactionMsg.text}`);
-      console.log(`📝 To message: ${reactionMsg.key?.id}`);
-      break;
-
-    case "groupInvite":
-      const inviteMsg = messageContent.content;
-      console.log(`👥 Group invite: ${inviteMsg.groupName}`);
-      console.log(`🔗 Code: ${inviteMsg.inviteCode}`);
-      break;
-
-    default:
-      console.log(`❓ Unhandled message type: ${messageContent.type}`);
-  }
-}
-```
-
-### Read Receipts and Delivery Confirmations
-
-Handle message delivery and read confirmations:
-
-```typescript
-async function handleReceipt(event) {
-  const { MessageSource, MessageIDs, Type, Timestamp } = event;
-  const from = MessageSource.Chat.User;
-
-  console.log(
-    `Receipt from ${from}: ${Type} for ${MessageIDs.length} message(s)`
-  );
-
-  switch (Type) {
-    case "delivery":
-      console.log(`✅ Messages delivered to ${from}`);
-      // Update your database to mark messages as delivered
-      break;
-
-    case "read":
-      console.log(`👀 Messages read by ${from}`);
-      // Update your database to mark messages as read
-      break;
-
-    case "played":
-      console.log(`▶️ Voice/video messages played by ${from}`);
-      // Update your database to mark media as played
-      break;
-  }
-}
-```
-
-### Presence and Typing Indicators
-
-Handle user online/offline status and typing indicators:
-
-```typescript
-// User online/offline status
-async function handlePresence(event) {
-  const { From, Unavailable, LastSeen } = event;
-  const user = From.User;
-
-  if (Unavailable) {
-    console.log(`🔴 ${user} went offline (last seen: ${LastSeen})`);
-  } else {
-    console.log(`🟢 ${user} is online`);
-  }
-}
-
-// Typing indicators
-async function handleChatPresence(event) {
-  const { MessageSource, State, Media } = event;
-  const from = MessageSource.Sender.User;
-  const isGroup = MessageSource.IsGroup;
-
-  if (State === "composing") {
-    if (Media === "text") {
-      console.log(`⌨️ ${from} is typing${isGroup ? " in group" : ""}...`);
-    } else {
-      console.log(
-        `📎 ${from} is sending ${Media}${isGroup ? " in group" : ""}...`
-      );
-    }
-  } else if (State === "paused") {
-    console.log(`⏸️ ${from} stopped typing`);
-  }
-}
-```
-
-### Group Events
-
-Handle group-related events:
-
-```typescript
-// Group info updates
-async function handleGroupInfo(event) {
-  const { JID, GroupName, Participants, Sender } = event;
-  console.log(`👥 Group info updated for ${GroupName} (${JID.User})`);
-  console.log(`👤 Updated by: ${Sender.User}`);
-  console.log(`👥 Participants: ${Participants.length}`);
-}
-
-// When you're added to a group
-async function handleJoinedGroup(event) {
-  const { Reason, Type, Participants } = event;
-  console.log(`🎉 Joined group! Reason: ${Reason}, Type: ${Type}`);
-  console.log(`👥 Group has ${Participants.length} participants`);
-
-  // Send welcome message
-  // Note: You'll need the group JID from the event context
-}
-```
-
-### Connection Events
-
-Handle connection status changes:
-
-```typescript
-async function handleConnected(event) {
-  console.log("🟢 Connected to WhatsApp!");
-  // Your bot is now ready to send messages
-}
-
-async function handleDisconnected(event) {
-  console.log("🔴 Disconnected from WhatsApp");
-  // Attempt to reconnect or notify administrators
-}
-
-async function handleLoggedOut(event) {
-  const { Reason, OnConnect } = event;
-  console.log(`🚪 Logged out from WhatsApp. Reason: ${Reason}`);
-
-  if (OnConnect) {
-    console.log("⚠️ Logout occurred during connection");
-  }
-
-  // You may need to scan QR code again
-}
-```
-
-### QR Code Events
-
-Handle QR code generation for initial setup:
-
-```typescript
-async function handleQR(event) {
-  const { Codes } = event;
-  console.log("📱 New QR codes received:");
-
-  Codes.forEach((code, index) => {
-    console.log(`📷 QR Code ${index + 1}: ${code}`);
-    // Display QR code to user or save to file
-  });
-}
-```
-
-### Profile and Contact Updates
-
-Handle profile picture and contact information changes:
-
-```typescript
-// Profile picture changes
-async function handlePicture(event) {
-  const { JID, Author, Remove, Timestamp } = event;
-  const target = JID.User;
-  const changer = Author.User;
-
-  if (Remove) {
-    console.log(`🗑️ ${changer} removed profile picture for ${target}`);
-  } else {
-    console.log(`🖼️ ${changer} updated profile picture for ${target}`);
-  }
-}
-
-// Contact info updates
-async function handleContact(event) {
-  const { JID, Found, FullName, PushName, BusinessName } = event;
-  console.log(`👤 Contact info: ${FullName || PushName} (${JID.User})`);
-
-  if (BusinessName) {
-    console.log(`🏢 Business: ${BusinessName}`);
-  }
-
-  console.log(`✅ Found in WhatsApp: ${Found}`);
-}
-
-// Name changes
-async function handlePushName(event) {
-  const { JID, OldPushName, NewPushName } = event;
-  console.log(
-    `📝 ${JID.User} changed name from "${OldPushName}" to "${NewPushName}"`
-  );
-}
-```
-
-### Error Handling
-
-Handle various error events:
-
-```typescript
-// Undecryptable messages
-async function handleUndecryptableMessage(event) {
-  const { Info, IsUnavailable, UnavailableType, DecryptFailMode } = event;
-  console.log(`❌ Failed to decrypt message from ${Info.Source.Sender.User}`);
-  console.log(
-    `📊 Unavailable: ${IsUnavailable}, Type: ${UnavailableType}, Mode: ${DecryptFailMode}`
-  );
-
-  // Log for debugging or request message retry
-}
-
-// Stream errors
-async function handleStreamError(event) {
-  const { Code } = event;
-  console.log(`🚨 Stream error: ${Code}`);
-
-  // Handle specific error codes
-  switch (Code) {
-    case "conflict":
-      console.log("Another client connected with same credentials");
-      break;
-    case "stream:error":
-      console.log("General stream error occurred");
-      break;
-    default:
-      console.log("Unknown stream error");
-  }
-}
-```
-
-### Complete Webhook Server Example
-
-Here's a complete webhook server that handles all event types:
-
-```typescript
-import express from "express";
-import WuzapiClient, {
-  Message,
-  Receipt,
-  Presence,
-  EventGroupInfo,
-} from "wuzapi";
-
-const app = express();
-app.use(express.json());
-
-const client = new WuzapiClient({
-  apiUrl: process.env.WUZAPI_URL || "http://localhost:8080",
-  token: process.env.WUZAPI_TOKEN || "your-token",
-});
-
-// Event router
-const eventHandlers = {
-  Message: handleMessage,
-  Receipt: handleReceipt,
-  Presence: handlePresence,
-  ChatPresence: handleChatPresence,
-  GroupInfo: handleGroupInfo,
-  JoinedGroup: handleJoinedGroup,
-  Connected: handleConnected,
-  Disconnected: handleDisconnected,
-  LoggedOut: handleLoggedOut,
-  QR: handleQR,
-  Picture: handlePicture,
-  Contact: handleContact,
-  PushName: handlePushName,
-  UndecryptableMessage: handleUndecryptableMessage,
-  StreamError: handleStreamError,
-};
-
-app.post("/webhook", async (req, res) => {
-  try {
-    const eventData = req.body;
-
-    // Log all events for debugging
-    console.log("📨 Webhook received:", JSON.stringify(eventData, null, 2));
-
-    // Route to appropriate handler based on event structure
-    for (const [eventType, handler] of Object.entries(eventHandlers)) {
-      if (isEventType(eventData, eventType)) {
-        await handler(eventData);
-        break;
-      }
-    }
-
-    res.status(200).json({ success: true });
-  } catch (error) {
-    console.error("❌ Webhook processing error:", error);
-    res.status(500).json({ error: error.message });
-  }
-});
-
-// Helper function to identify event types
-function isEventType(event, type) {
-  switch (type) {
-    case "Message":
-      return event.Message && event.Info;
-    case "Receipt":
-      return event.MessageIDs && event.Type;
-    case "Presence":
-      return event.From && typeof event.Unavailable !== "undefined";
-    case "ChatPresence":
-      return event.State && event.MessageSource;
-    case "GroupInfo":
-      return event.GroupName && event.Participants;
-    case "QR":
-      return event.Codes;
-    // Add more type checks as needed
-    default:
-      return false;
-  }
-}
-
-// Health check
-app.get("/health", (req, res) => {
-  res.json({ status: "healthy", timestamp: new Date().toISOString() });
-});
-
-// Initialize
-async function initialize() {
-  try {
-    // Connect to WhatsApp with all events using EventType enum
-    await client.session.connect({
-      Subscribe: [
-        EventType.MESSAGE,
-        EventType.RECEIPT,
-        EventType.PRESENCE,
-        EventType.CHAT_PRESENCE,
-        EventType.GROUP_INFO,
-        EventType.CONTACT,
-        EventType.PUSH_NAME,
-        EventType.PICTURE,
-        EventType.QR,
-        EventType.CONNECTED,
-        EventType.DISCONNECTED,
-        EventType.LOGGED_OUT,
-        EventType.UNDECRYPTABLE_MESSAGE,
-        EventType.STREAM_ERROR,
-      ],
-      Immediate: false,
-    });
-
-    // Set webhook
-    const webhookUrl =
-      process.env.WEBHOOK_URL || "http://localhost:3000/webhook";
-    await client.webhook.setWebhook(webhookUrl);
-
-    app.listen(3000, () => {
-      console.log("🚀 Webhook server running on port 3000");
-      console.log("🎉 Ready to receive WhatsApp events!");
-    });
-  } catch (error) {
-    console.error("❌ Initialization failed:", error);
-    process.exit(1);
-  }
-}
-
-initialize();
-```
-
-### Event Types Reference
-
-All webhook events are fully typed. Import the specific event types you need:
-
-```typescript
-import {
-  // Event type enum for all possible events
-  EventType,
-
-  // Core message types
-  Message,
-  MessageEvent,
-  MessageContent,
-  getMessageContent,
-
-  // Specific message types
-  ImageMessage,
-  VideoMessage,
-  AudioMessage,
-  DocumentMessage,
-  LocationMessage,
-  ContactMessage,
-  StickerMessage,
-  ButtonsMessage,
-  ListMessage,
-  PollCreationMessage,
-  ReactionMessage,
-
-  // Webhook payload types
-  WebhookPayload,
-  S3MediaInfo,
-  S3OnlyWebhookPayload,
-  Base64OnlyWebhookPayload,
-  BothMediaWebhookPayload,
-  hasS3Media,
-  hasBase64Media,
-  hasBothMedia,
-
-  // Event types
-  Receipt,
-  Presence,
-  ChatPresence,
-  EventGroupInfo,
-  EventContact,
-  QR,
-  Picture,
-  PushName,
-  Connected,
-  Disconnected,
-  LoggedOut,
-  UndecryptableMessage,
-  StreamError,
-  WhatsAppEvent,
-} from "wuzapi";
-
-// Type-safe event handling with EventType enum
-async function handleTypedWebhook(webhookPayload: WebhookPayload) {
-  const event = webhookPayload.event;
-
-  // Type-safe event detection using EventType enum
-  const eventType = detectEventType(event);
-
-  switch (eventType) {
-    case EventType.MESSAGE:
-      const messageEvent = event as MessageEvent;
-      const messageContent = getMessageContent(messageEvent.Message);
-
-      if (messageContent?.type === "image") {
-        // TypeScript knows this is an ImageMessage
-        const imageMsg: ImageMessage = messageContent.content;
-        console.log(`Image dimensions: ${imageMsg.width}x${imageMsg.height}`);
-
-        // Handle S3 media if available
-        if (hasS3Media(webhookPayload)) {
-          console.log(`S3 URL: ${webhookPayload.s3.url}`);
-          // Download from S3 or process as needed
-        }
-
-        // Handle Base64 media if available
-        if (hasBase64Media(webhookPayload)) {
-          console.log("Processing base64 image data");
-          // Process base64 data: webhookPayload.base64
         }
       }
-      break;
-
-    case EventType.RECEIPT:
-      const receiptEvent = event as Receipt;
-      console.log(`Receipt type: ${receiptEvent.Type}`);
-      break;
-
-    case EventType.PRESENCE:
-      const presenceEvent = event as Presence;
-      console.log(`User ${presenceEvent.From.User} presence update`);
-      break;
-
-    default:
-      console.log(`Unhandled event: ${eventType}`);
-  }
-}
-
-// Complete webhook server with S3 support
-app.post("/webhook", async (req, res) => {
-  try {
-    const payload: WebhookPayload = req.body;
-    await handleTypedWebhook(payload);
-    res.status(200).json({ success: true });
+    }
+    
+    res.json({ success: true });
   } catch (error) {
     console.error("Webhook error:", error);
     res.status(500).json({ error: error.message });
   }
 });
-
-// Helper function to handle all message types generically
-function processMessageContent(content: MessageContent) {
-  switch (content.type) {
-    case "text":
-      // content.content is string
-      return content.content.toUpperCase();
-
-    case "image":
-      // content.content is ImageMessage
-      return `Image: ${content.content.caption || "No caption"}`;
-
-    case "video":
-      // content.content is VideoMessage
-      return `Video (${content.content.seconds}s): ${
-        content.content.caption || "No caption"
-      }`;
-
-    // TypeScript ensures you handle all possible types
-    default:
-      return `Unknown message type: ${content.type}`;
-  }
-}
 ```
 
-### Advanced Message Type Handling
+### Message Types
 
-For complex message processing, you can work directly with the typed message structures:
+The `getMessageContent()` utility function returns structured message data:
 
 ```typescript
-import {
-  Message,
-  ExtendedTextMessage,
-  ButtonsMessage,
-  ContextInfo,
-} from "wuzapi";
+const messageContent = getMessageContent(event.Message);
 
-// Check for extended text with link preview
-function hasLinkPreview(message: Message): boolean {
-  return !!message.extendedTextMessage?.canonicalUrl;
-}
-
-// Extract context info from any message
-function getMessageContext(message: Message): ContextInfo | undefined {
-  // Check various message types for context info
-  return (
-    message.extendedTextMessage?.contextInfo ||
-    message.imageMessage?.contextInfo ||
-    message.videoMessage?.contextInfo ||
-    message.audioMessage?.contextInfo
-  );
-}
-
-// Process interactive messages
-function handleInteractiveMessage(message: Message) {
-  if (message.buttonsMessage) {
-    const btns = message.buttonsMessage;
-    console.log(`Interactive message: ${btns.contentText}`);
-
-    btns.buttons?.forEach((button) => {
-      if (button.type === ButtonType.RESPONSE) {
-        console.log(`Response button: ${button.buttonText?.displayText}`);
-      } else if (button.type === ButtonType.NATIVE_FLOW) {
-        console.log(`Native flow: ${button.nativeFlowInfo?.name}`);
-      }
-    });
-  }
-
-  if (message.listMessage) {
-    const list = message.listMessage;
-    console.log(`List: ${list.title}`);
-
-    list.sections?.forEach((section) => {
-      console.log(`Section: ${section.title}`);
-      section.rows?.forEach((row) => {
-        console.log(`- ${row.title}: ${row.description}`);
-      });
-    });
-  }
+switch (messageContent?.type) {
+  case "text":
+    console.log("Text:", messageContent.content);
+    break;
+  case "image":
+    console.log("Image:", messageContent.content.caption);
+    break;
+  case "buttonsResponse":
+    console.log("Button clicked:", messageContent.content.selectedButtonId);
+    break;
+  case "listResponse":
+    console.log("List selection:", messageContent.content.singleSelectReply?.selectedRowId);
+    break;
+  // ... handle other types
 }
 ```
 
-## Error Handling
+---
+
+## 🛠️ Advanced Topics
 
-The library provides comprehensive error handling with detailed error information:
+<details>
+<summary><strong>⚠️ Error Handling</strong></summary>
 
 ```typescript
 import { WuzapiError } from "wuzapi";
@@ -1337,52 +777,37 @@ try {
 }
 ```
 
-### Token Authentication Errors
+### Common Error Codes
+- **401**: Authentication required
+- **404**: Endpoint not found  
+- **500**: Server error
 
-When no token is provided (either globally or per-request), the library will throw a specific error:
+</details>
 
-```typescript
-import { WuzapiError } from "wuzapi";
+<details>
+<summary><strong>🔧 Custom Configuration</strong></summary>
 
-// Client without global token
-const client = new WuzapiClient({
-  apiUrl: "http://localhost:8080",
-  // No token provided
-});
+```typescript
+// Custom axios configuration
+import { BaseClient } from "wuzapi";
 
-try {
-  // This will fail - no token provided
-  await client.chat.sendText({
-    Phone: "5491155554444",
-    Body: "This will fail",
-  });
-} catch (error) {
-  if (error instanceof WuzapiError && error.code === 401) {
-    console.error("Authentication required:", error.message);
-    // "No authentication token provided. Either set a token in the client config or provide one in the request options."
+class CustomClient extends BaseClient {
+  constructor(config) {
+    super(config);
+    
+    // Add custom interceptors
+    this.axios.interceptors.request.use((config) => {
+      console.log("Making request:", config.url);
+      return config;
+    });
   }
 }
-
-// Fix by providing token
-await client.chat.sendText(
-  {
-    Phone: "5491155554444",
-    Body: "Now it works!",
-  },
-  { token: "your-token" }
-);
 ```
 
-### Error Types
-
-- **Network Errors**: Connection issues, timeouts
-- **Authentication Errors**: Invalid tokens, permission denied
-- **API Errors**: Invalid parameters, service unavailable
-- **Validation Errors**: Missing required fields, invalid data formats
-
-## TypeScript Support
+</details>
 
-The library is built with TypeScript and provides complete type definitions:
+<details>
+<summary><strong>📝 TypeScript Support</strong></summary>
 
 ```typescript
 import {
@@ -1402,9 +827,10 @@ const request: SendTextRequest = {
 const response: SendMessageResponse = await client.chat.sendText(request);
 ```
 
-## Legacy Aliases
+</details>
 
-For convenience, the library provides some legacy aliases:
+<details>
+<summary><strong>🔄 Legacy Aliases</strong></summary>
 
 ```typescript
 // These are equivalent:
@@ -1415,130 +841,11 @@ await client.chat.sendText({ Phone: "123", Body: "Hi" });
 await client.message.sendText({ Phone: "123", Body: "Hi" }); // Alias
 ```
 
-## Advanced Usage
-
-### Custom Axios Configuration
-
-You can extend the base client for custom axios configuration:
-
-```typescript
-import { BaseClient } from "wuzapi";
-
-class CustomClient extends BaseClient {
-  constructor(config: WuzapiConfig) {
-    super(config);
-
-    // Add custom interceptors
-    this.axios.interceptors.request.use((config) => {
-      console.log("Making request:", config.url);
-      return config;
-    });
-  }
-}
-```
-
-### Ping Test
-
-Test connectivity to the API:
-
-```typescript
-const isConnected = await client.ping();
-if (isConnected) {
-  console.log("API is reachable");
-} else {
-  console.log("API is not reachable");
-}
-```
-
-## Examples
-
-For complete working examples, check the `examples/` directory:
-
-- **`basic-usage.js`** - Basic client setup and usage
-- **`chatbot-example.js`** - Simple chatbot with command handling
-- **`webhook-events-example.js`** - Comprehensive webhook event handling
-
-### Complete Chat Bot Example
-
-```typescript
-import WuzapiClient from "wuzapi";
-
-const client = new WuzapiClient({
-  apiUrl: "http://localhost:8080",
-  token: "your-token",
-});
-
-async function startBot() {
-  // Connect to WhatsApp
-  await client.session.connect({
-    Subscribe: ["Message"],
-    Immediate: false,
-  });
-
-  // Wait for connection
-  let connected = false;
-  while (!connected) {
-    const status = await client.session.getStatus();
-    if (!status.LoggedIn) {
-      const qr = await client.session.getQRCode();
-      console.log("Scan this QR code:", qr.QRCode);
-      await new Promise((resolve) => setTimeout(resolve, 5000));
-    } else {
-      connected = true;
-      console.log("Bot connected and ready!");
-    }
-  }
-
-  // Set webhook for receiving messages
-  await client.webhook.setWebhook("https://your-server.com/webhook");
-}
-
-// Handle incoming messages in your webhook endpoint
-function handleIncomingMessage(message: any) {
-  const phone = message.Info.RemoteJid.replace("@s.whatsapp.net", "");
-  const text = message.Message?.conversation || "";
-
-  if (text.toLowerCase() === "hello") {
-    client.chat.sendText({
-      Phone: phone,
-      Body: "Hello! How can I help you today?",
-    });
-  }
-}
-
-startBot().catch(console.error);
-```
-
-### Group Management Example
-
-```typescript
-async function manageGroup() {
-  // Create a new group
-  const group = await client.group.create("Project Team", [
-    "5491155553934",
-    "5491155553935",
-  ]);
-
-  console.log("Created group:", group.JID);
-
-  // Set group photo
-  await client.group.setPhoto(group.JID, "data:image/jpeg;base64,...");
-
-  // Configure group settings
-  await client.group.setLocked(group.JID, true); // Only admins can modify
-  await client.group.setEphemeral(group.JID, "7d"); // Messages disappear after 7 days
-
-  // Get and share invite link
-  const invite = await client.group.getInviteLink(group.JID);
-  console.log("Invite link:", invite.InviteLink);
-}
-```
-
-## API Reference
+</details>
 
-For detailed API documentation, refer to the [WuzAPI documentation](https://github.com/asternic/wuzapi/blob/main/API.md).
+---
 
-## Contributing
+## 🤝 Contributing
 
 1. Fork the repository
 2. Create your feature branch (`git checkout -b feature/amazing-feature`)
@@ -1561,43 +868,32 @@ npm run lint
 
 # Build the project
 npm run build
-
-# Run development server
-npm run dev
 ```
 
-### Code Style
-
-This project uses ESLint and TypeScript. Please ensure your code passes all checks:
-
-```bash
-npm run lint
-npm run lint:fix  # Auto-fix issues
-```
-
-## License
+## 📄 License
 
 MIT License - see the [LICENSE](LICENSE) file for details.
 
-## Support
+## 🔗 Links
 
-- 📚 [Documentation](https://github.com/asternic/wuzapi)
+- 📚 [WuzAPI Documentation](https://github.com/asternic/wuzapi)
 - 🐛 [Issue Tracker](https://github.com/gusnips/wuzapi-node/issues)
 - 💬 [Discussions](https://github.com/gusnips/wuzapi-node/discussions)
 
-## Changelog
+---
+
+## 📊 Changelog
 
-### 1.0.0
+### Latest Updates
 
-- Initial release
-- Full TypeScript support
-- Complete API coverage
-- Modular architecture
-- Comprehensive error handling
-- S3 storage integration support
-- Admin user management
-- Group management features
-- Webhook configuration
+- ✅ **Phone Pairing**: Alternative to QR code login
+- ✅ **Interactive Messages**: Buttons, lists, and polls
+- ✅ **Message Management**: Edit and delete messages
+- ✅ **Advanced Groups**: Full participant management
+- ✅ **Newsletter Support**: Business newsletter features
+- ✅ **Enhanced Webhooks**: Update and delete webhook configs
+- ✅ **Proxy Support**: Configure proxy for connections
+- ✅ **History Sync**: Request message history after login
 
 ---