@raphaelvserafim/client-api-whatsapp 1.0.8 → 1.2.0

package/README.md

@@ -2,23 +2,22 @@
 
 ## About Our WhatsApp API
 
-🔓 **Unlock the Potential of WhatsApp:** Powerful Integration with Our Unofficial API!
+**Unlock the Potential of WhatsApp:** Powerful Integration with Our Unofficial API!
 
 ### Efficient Group Management on WhatsApp
 
-📋 Our stable, though unofficial, API allows for efficient management of WhatsApp groups. Simplify administration, and easily add or remove members.
+Our stable, though unofficial, API allows for efficient management of WhatsApp groups. Simplify administration, and easily add or remove members.
 
 ### Versatile Message Sending
 
-💬 With our API, you can send text, audio, video, and image messages quickly and easily. Adapt to your business communication needs comprehensively.
+With our API, you can send text, audio, video, and image messages quickly and easily. Adapt to your business communication needs comprehensively.
 
 ### Receive Instant Events
 
-🔔 Stay updated with our API, receiving real-time events when new messages are received. Stay connected and agile in responding to interactions on WhatsApp.
+Stay updated with our API, receiving real-time events when new messages are received. Stay connected and agile in responding to interactions on WhatsApp.
 
-🔗 **Create Your Account:** Visit [https://api-wa.me/sign-up](https://api-wa.me/sign-up) to create your account and start using our API today!
+**Create Your Account:** Visit [https://api-wa.me/sign-up](https://api-wa.me/sign-up) to create your account and start using our API today!
 
-🎁 **Special Discount:** Use the coupon **GIT20** and get 20% off on your first instance!
 
 ## Contact Support
 
@@ -27,364 +26,580 @@
 - **Website:** [https://api-wa.me](https://api-wa.me)
 
 ## Installation
+
 ```bash
 npm i @raphaelvserafim/client-api-whatsapp
 ```
+
 ```bash
 yarn add @raphaelvserafim/client-api-whatsapp
 ```
 
-```js
-import { WhatsApp, StatusPresence, TypeMessage, } from '@raphaelvserafim/client-api-whatsapp';
+## Quick Start
 
-const whatsapp = new WhatsApp({ server: "https://us.api-wa.me", key: "12345678" });
+```ts
+import { WhatsApp, TypeMessage, StatusPresence } from '@raphaelvserafim/client-api-whatsapp';
 
-const to = "559999999999" //  If you want to send it to the group = 123456789@us
-```
+const wa = new WhatsApp({ server: "https://us.api-wa.me", key: "YOUR_KEY" });
 
-### Get Information
-```js
-whatsapp.info().then((response) => {
-  console.log(response)
-}).catch(console.error)
+const to = "559999999999"; // Group: "123456789@g.us"
 ```
 
-### Connect to WhatsApp
-```js
-whatsapp.connect().then((response) => {
- console.log(response)
-}).catch(console.error);
+> **Backward Compatible:** All legacy methods (`wa.sendMessage()`, `wa.groups()`, etc.) still work. The new service-based API is optional.
+
+---
+
+## Instance
+
+```ts
+// Connect via QR Code
+const qr = await wa.instance.connect();
+
+// Connect via Pairing Code
+const code = await wa.instance.pairingCode("559999999999");
+
+// Get instance info
+const info = await wa.instance.info();
+
+// Logout
+await wa.instance.logout();
+
+// Restart
+await wa.instance.restart();
+
+// Settings
+await wa.instance.setting({
+  markMessageRead: true,
+  saveMedia: false,
+  receiveStatusMessage: false,
+  receivePresence: false,
+});
+
+// Webhook
+await wa.instance.updateWebhook({
+  allowWebhook: true,
+  allowNumber: "all",
+  webhookMessage: "https://your-webhook.com/message",
+  webhookGroup: "",
+  webhookConnection: "",
+  webhookQrCode: "",
+  webhookMessageFromMe: "",
+  webhookHistory: "",
+});
+
+// Webhook Statistics
+const stats = await wa.instance.webhookStatistics();
+
+// Profile
+await wa.instance.updateProfileName("My Bot");
+await wa.instance.updateProfileStatus("Online");
+await wa.instance.updateProfilePicture("https://avatars.githubusercontent.com/u/68257896");
+await wa.instance.removeProfilePicture();
+
+// Proxy
+await wa.instance.setProxy("http://user:pass@ip:port");
+
+// MongoDB
+await wa.instance.addMongoDb("mongodb+srv://...", "mydb");
+
+// Mobile Registration (3 steps)
+await wa.instance.mobileRegisterPrepare({
+  phoneNumberCountryCode: "55",
+  phoneNumberNationalNumber: "99999999999",
+  phoneNumberMobileCountryCode: "724",
+  phoneNumberMobileNetworkCode: "11",
+});
+await wa.instance.mobileRequestCode("sms");
+await wa.instance.mobileVerifyCode("123456");
 ```
 
-### Logout
-```js
-whatsapp.logout().then((response) => {
- console.log(response)
-}).catch(console.error);
-```
+## Messages
 
-### Get Contacts
-```js
-whatsapp.contacts().then((response) => {
- console.log(response)
-}).catch(console.error)
-```
+### Send Messages
 
-## Send Messages
+```ts
+// Text
+await wa.message.send({
+  type: TypeMessage.TEXT,
+  body: { to, text: "Hello!" },
+});
 
-### Presence
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.PRESENCE,
+// Image
+await wa.message.send({
+  type: TypeMessage.IMAGE,
+  body: { to, url: "https://a.cdn-hotels.com/gdcs/production190/d988/1071675e-1bd7-4a81-8b40-735eb9241410.jpg", caption: "Toronto" },
+});
+
+// Audio
+await wa.message.send({
+  type: TypeMessage.AUDIO,
+  body: { to, url: "https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3" },
+});
+
+// Video
+await wa.message.send({
+  type: TypeMessage.VIDEO,
+  body: { to, url: "https://www.w3schools.com/html/mov_bbb.mp4", caption: "Big Buck Bunny" },
+});
+
+// Document
+await wa.message.send({
+  type: TypeMessage.DOCUMENT,
+  body: { to, url: "https://raphaelvserafim.com/RaphaelSerafimResume.pdf", mimetype: "application/pdf", fileName: "Resume.pdf" },
+});
+
+// Contact
+await wa.message.send({
+  type: TypeMessage.CONTACT,
   body: {
-    to: to,
-    status: StatusPresence.COMPOSING
-  }
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
-```
+    to,
+    contact: { fullName: "Raphael", phoneNumber: "559999999999", organization: "api-wa.me" },
+  },
+});
 
-### Text
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.TEXT,
+// Location
+await wa.message.send({
+  type: TypeMessage.LOCATION,
   body: {
-    to: to,
-    text: "Hey"
-  }
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+    to,
+    location: { latitude: 37.7749, longitude: -122.4194, address: "San Francisco, CA" },
+  },
+});
+
+// Reaction
+await wa.message.send({
+  type: TypeMessage.REACTION,
+  body: { to, msgId: "MESSAGE_ID", text: "👍" },
+});
+
+// Link Preview
+await wa.message.send({
+  type: TypeMessage.LINK,
+  body: {
+    to,
+    title: "API WhatsApp",
+    text: "Check out our API",
+    description: "Powerful WhatsApp integration",
+    thumbnailUrl: "https://avatars.githubusercontent.com/u/68257896",
+    sourceUrl: "https://api-wa.me",
+  },
+});
+
+// Title with Footer
+await wa.message.send({
+  type: TypeMessage.TITLE,
+  body: { to, title: "Order #123", text: "Your order is ready", footer: "Thank you!" },
+});
+
+// Presence
+await wa.message.send({
+  type: TypeMessage.PRESENCE,
+  body: { to, status: StatusPresence.COMPOSING },
+});
 ```
 
+### Reply to a Message
 
-### Cobrança Pix
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.BUTTON_PIX,
-  body:  {
-  to: "14375223417",
-  title: "Pizza",
-  text: "Pizza ",
-  referenceId: "apiwame",
-  code: "0020",
-  key: "23711695000115",
-  merchantName: "CACHE SISTEMAS WEB",
-  keyType: "CNPJ",
-  items: [
-    {
-      id: "123",
-      name: "Pizza G",
-      price: 10,
-      quantity: 10
-    },
-  ],
-  subtotal: "90",
-  totalAmount: "100"
-}
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+Pass `true` as second argument and include `msgId`:
+
+```ts
+await wa.message.send({
+  type: TypeMessage.TEXT,
+  body: { to, text: "This is a reply!", msgId: "ORIGINAL_MSG_ID" },
+}, true);
 ```
 
+### Button Messages
 
-### Buttons Reply
-```js
-whatsapp.sendMessage({
+```ts
+// Quick Reply Buttons
+await wa.message.send({
   type: TypeMessage.BUTTON_REPLY,
   body: {
-  to: "14375223417",
-  header: {
-    title: "Example Header",
+    to,
+    header: { title: "Choose an option" },
+    text: "What do you prefer?",
+    footer: "Select one",
+    buttons: [
+      { type: "quick_reply", id: "1", text: "Yes" },
+      { type: "quick_reply", id: "2", text: "No" },
+    ],
   },
-  text: "This is a test",
-  footer: "choose an option",
-  buttons: [
-    {
-      type: "quick_reply",
-      id: "uniqId1",
-      text: "Yes"
-    },
-    {
-      type: "quick_reply",
-      id: "uniqId2",
-      text: "No"
-    }
-  ]
-}
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
-```
-
+});
 
-### Buttons ACTION
-```js
-whatsapp.sendMessage({
+// Call to Action Buttons
+await wa.message.send({
   type: TypeMessage.BUTTON_ACTION,
   body: {
-  to: "14375223417",
-  header: {
-    title: "Example Header",
+    to,
+    header: { title: "Actions" },
+    text: "Choose an action",
+    footer: "Select one",
+    buttons: [
+      { type: "cta_url", url: "https://api-wa.me", text: "Visit website" },
+      { type: "cta_call", phone_number: "+559999999999", text: "Call us" },
+      { type: "cta_copy", copy_code: "PROMO2025", text: "Copy code" },
+    ],
   },
-  text: "This is a test",
-  footer: "choose an option",
-  buttons: [
-   {
-      type: "cta_copy",
-      copy_code: "1234567890",
-      text: "Copy barcode"
-    },
-    {
-      type: "cta_url",
-      url: "https://api-wa.me",
-      text: "Access the website"
+});
+
+// Buttons with Media Header
+await wa.message.send({
+  type: TypeMessage.BUTTON_REPLY,
+  body: {
+    to,
+    header: {
+      title: "Check this out",
+      hasMediaAttachment: true,
+      imageMessage: { url: "https://a.cdn-hotels.com/gdcs/production190/d988/1071675e-1bd7-4a81-8b40-735eb9241410.jpg" },
     },
-    {
-      type: "cta_call",
-      phone_number: "+5566996852025",
-      text: "Call us"
-    }
-  ]
-}
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+    text: "What do you think?",
+    buttons: [
+      { type: "quick_reply", id: "1", text: "Like" },
+      { type: "quick_reply", id: "2", text: "Dislike" },
+    ],
+  },
+});
 ```
 
-
 ### List Menu
-```js
-whatsapp.sendMessage({
+
+```ts
+await wa.message.send({
   type: TypeMessage.MENU,
   body: {
-  to: "14375223417",
-  buttonText: "Menu",
-  text: "string",
-  title: "Menu",
-  description: "Description",
-  footer: "footer",
-  sections: [
-    {
-      title: "Pizza",
-      rows: [
-        {
-          title: "Pizza 01",
-          description: "Example pizza 01",
-          rowId: "1"
-        }
-      ]
-    }
-  ]
-}
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+    to,
+    buttonText: "View Menu",
+    text: "Choose an item",
+    title: "Menu",
+    description: "Our products",
+    footer: "Prices may vary",
+    sections: [
+      {
+        title: "Pizzas",
+        rows: [
+          { title: "Margherita", description: "Classic cheese pizza", rowId: "1" },
+          { title: "Pepperoni", description: "Spicy pepperoni", rowId: "2" },
+        ],
+      },
+      {
+        title: "Drinks",
+        rows: [
+          { title: "Cola", description: "350ml", rowId: "3" },
+        ],
+      },
+    ],
+  },
+});
 ```
 
-### POLL
-```js
-whatsapp.sendMessage({
+### Poll / Survey
+
+```ts
+// Survey (via sendMessage)
+await wa.message.send({
   type: TypeMessage.POLL,
-  body: {
-  to: "14375223417",
-  name: "Do you like PHP?",
-  options: [
-    "Yes",
-    "No"
-  ],
-}
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+  body: { to, name: "Do you like TypeScript?", options: ["Yes", "No"] },
+});
+
+// Poll (dedicated method with selectableCount)
+await wa.message.sendPoll(to, "Favorite language?", ["TypeScript", "Python", "Go"], 1);
 ```
 
-### Link
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.LINK,
+### PIX Payment
+
+```ts
+await wa.message.send({
+  type: TypeMessage.BUTTON_PIX,
   body: {
-    to: to,
-    text: "\n",
-    title:"API WhatsApp",
-    description:"Simplify communication, send messages in a versatile way and achieve exceptional results for your business",
-    thumbnailUrl:"",
-    sourceUrl:"https://api-wa.me",
-  }
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+    to,
+    title: "Pizza Order",
+    text: "Your order details",
+    referenceId: "order-123",
+    code: "0020101021226700014br.gov.bcb.pix",
+    key: "23711695000115",
+    merchantName: "MY STORE",
+    keyType: "CNPJ",
+    items: [
+      { id: "1", name: "Pizza G", price: 45, quantity: 2 },
+      { id: "2", name: "Soda", price: 8, quantity: 2 },
+    ],
+    subtotal: "106",
+    totalAmount: "106",
+  },
+});
 ```
 
-### Audio
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.AUDIO,
-  body: {
-    to: to,
-    url: ""
-  }
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+### Sticker, Video Note, Event, Pin, Call Link
+
+```ts
+// Sticker
+await wa.message.sendSticker(to, "https://www.gstatic.com/webp/gallery/1.webp");
+
+// Video Note (circular/PTV)
+await wa.message.sendVideoNote(to, "https://www.w3schools.com/html/mov_bbb.mp4");
+
+// Event
+await wa.message.sendEvent({
+  to,
+  name: "Team Meeting",
+  description: "Weekly sync",
+  startTime: "2025-01-15T14:00:00Z",
+  locationName: "Office",
+  locationAddress: "123 Main St",
+});
+
+// Pin Message
+await wa.message.pin("MESSAGE_ID", 604800); // 7 days in seconds
+
+// Call Link
+await wa.message.sendCallLink(to, "video", "Join the meeting");
 ```
 
-### Image
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.IMAGE,
-  body: {
-    to: to,
-    url: ""
-  }
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+### Base64 Messages
+
+```ts
+await wa.message.sendImageBase64(to, "data:image/png;base64,...", "Caption");
+await wa.message.sendAudioBase64(to, "data:audio/mp3;base64,...");
+await wa.message.sendDocumentBase64(to, "data:application/pdf;base64,...", "application/pdf", "file.pdf", "My document");
 ```
 
-### Video
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.VIDEO,
-  body: {
-    to: to,
-    url: ""
-  }
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+### Forward & List Messages
+
+```ts
+// Forward a message
+await wa.message.forward(to, "MESSAGE_ID");
+
+// List messages from a contact
+const messages = await wa.message.list("559999999999", 1, 20);
 ```
 
+## Chat
 
-### Document
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.DOCUMENT,
-  body: {
-    to: to,
-    url: "",
-    mimetype: "",
-    fileName: ""
-  }
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+```ts
+// List all chats
+const chats = await wa.chat.list();
+
+// Get messages from a chat
+const msgs = await wa.chat.messages("559999999999@s.whatsapp.net");
+
+// Mark as read
+await wa.chat.modify("559999999999@s.whatsapp.net", "markRead", true);
+
+// Pin chat
+await wa.chat.modify("559999999999@s.whatsapp.net", "pin", true);
+
+// Delete chat
+await wa.chat.delete("559999999999@s.whatsapp.net");
 ```
 
-### Contact
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.CONTACT,
-  body: {
-    to: to,
-    contact: {
-      fullName: "Raphael",
-      phoneNumber: to,
-      organization: "api-wa.me"
-    }
-  }
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+## Call
+
+```ts
+// Make a call
+await wa.call.call(to, false);      // audio
+await wa.call.call(to, true);       // video
+
+// Reject a call
+await wa.call.reject("CALL_ID", "559999999999@s.whatsapp.net");
 ```
 
-### Reaction
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.REACTION,
-  body: {
-    to: to,
-    msgId: "ASDDF872AHDURBSG",
-    text: "🤖"
-  }
-}).then((response) => {
- console.log(response)
-}).catch(console.error)
+## Labels
+
+```ts
+// List labels
+const labels = await wa.label.list();
+
+// Create label
+await wa.label.create("VIP");
+
+// Add label to chat
+await wa.label.addToChat("label_id", to);
+
+// Get chats with label
+const labeled = await wa.label.getChats("label_id");
+
+// Remove label from chat
+await wa.label.removeFromChat("label_id", to);
 ```
 
-### All types of submissions you can respond to a message, so for example
+## Contacts
 
-### Text
-```js
-whatsapp.sendMessage({
-  type: TypeMessage.TEXT,
-  body: {
-    msgId: "SKJH455AJKJ",
-    to: to,
-    text: "Hey"
-  }
-}, true ).then((response) => {
- console.log(response)
-}).catch(console.error)
+```ts
+// List all contacts
+const contacts = await wa.contact.list();
+
+// Get contact profile
+const profile = await wa.contact.profile("559999999999");
+
+// Block / Unblock
+await wa.contact.block("559999999999", "block");
+await wa.contact.block("559999999999", "unblock");
+
+// Check if registered on WhatsApp
+const check = await wa.action.checkRegistered("559999999999");
 ```
 
-## Group Management
+## Groups
+
+```ts
+// List groups
+const groups = await wa.group.list();
+
+// Group info
+const info = await wa.group.info("123456789@g.us");
 
-### List Groups
-```js
-whatsapp.groups().then((response) => {
- console.log(response)
-}).catch(console.error)
+// Create group
+const newGroup = await wa.group.create("Developers", ["559999999999"]);
+
+// Update group
+await wa.group.update("123456789@g.us", "New Name", "New description");
+
+// Change settings
+await wa.group.changeSettings("123456789@g.us", "announcement");     // only admins can send
+await wa.group.changeSettings("123456789@g.us", "not_announcement"); // everyone can send
+await wa.group.changeSettings("123456789@g.us", "locked");           // only admins edit info
+await wa.group.changeSettings("123456789@g.us", "unlocked");         // everyone can edit info
+
+// Invite code
+const invite = await wa.group.getInviteCode("123456789@g.us");
+
+// Group picture
+await wa.group.updatePicture("123456789@g.us", "https://a.cdn-hotels.com/gdcs/production190/d988/1071675e-1bd7-4a81-8b40-735eb9241410.jpg");
+await wa.group.removePicture("123456789@g.us");
+
+// Participants
+await wa.group.addParticipants("123456789@g.us", ["559999999999"]);
+await wa.group.removeParticipants("123456789@g.us", ["559999999999"]);
+await wa.group.updateParticipantRole("123456789@g.us", "promote", ["559999999999"]);
+await wa.group.updateParticipantRole("123456789@g.us", "demote", ["559999999999"]);
+
+// Pending participants
+const pending = await wa.group.getRequestParticipants("123456789@g.us");
+await wa.group.updateRequestParticipants("123456789@g.us", {
+  participants: ["559999999999"],
+  action: "approve",
+});
+
+// Leave group
+await wa.group.leave("123456789@g.us");
+```
+
+## Community
+
+```ts
+// List communities
+const communities = await wa.community.list();
+
+// Create community
+const newComm = await wa.community.create({ name: "My Community", subject: "Tech" });
+
+// Community info
+const commInfo = await wa.community.info("community_id");
+
+// Update community
+await wa.community.update("community_id", { subject: "Updated", description: "New description" });
+
+// Community picture
+await wa.community.updatePicture("community_id", "https://a.cdn-hotels.com/gdcs/production190/d988/1071675e-1bd7-4a81-8b40-735eb9241410.jpg");
+
+// Invite code
+const commInvite = await wa.community.getInviteCode("community_id");
+
+// Participants
+await wa.community.removeParticipants("community_id", ["559999999999"]);
+const commPending = await wa.community.getRequestParticipants("community_id");
+await wa.community.updateRequestParticipants("community_id", {
+  participants: ["559999999999"],
+  action: "approve",
+});
+
+// Leave community
+await wa.community.leave("community_id");
 ```
 
-### Group Information
-```js
-whatsapp.infoGroup("123456789@us").then((response) => {
- console.log(response)
-}).catch(console.error)
+## Business
+
+```ts
+// Get catalog
+const catalog = await wa.business.getCatalog();
+const catalogPage = await wa.business.getCatalog(10, "cursor_token");
+
+// Create product
+await wa.business.createProduct({
+  name: "Premium T-Shirt",
+  description: "100% cotton",
+  originCountryCode: "BR",
+  currency: "BRL",
+  price: 79.90,
+  images: [{ url: "https://a.cdn-hotels.com/gdcs/production190/d988/1071675e-1bd7-4a81-8b40-735eb9241410.jpg" }],
+});
+
+// Update product
+await wa.business.updateProduct("product_id", {
+  name: "Premium T-Shirt v2",
+  price: 89.90,
+});
+
+// Delete product
+await wa.business.deleteProduct("product_id");
 ```
 
-### Create a Group
-```js
-whatsapp.createGroup("Devs", [to]).then((response) => {
- console.log(response)
-}).catch(console.error)
+## Actions
+
+```ts
+// Check if number is on WhatsApp
+const result = await wa.action.checkRegistered("559999999999");
+
+// Download media (deprecated)
+const media = await wa.action.downloadMedia("image", {
+  mediaKey: "...",
+  directPath: "...",
+  url: "...",
+});
+
+// Delete stored media
+await wa.action.deleteStorage();
 ```
 
-### Update a Group
-```js
-whatsapp.updateGroup("123456789@us", "Devs", "Only developers !").then((response) => {
- console.log(response)
-}).catch(console.error)
-```
+## Custom HTTP Client
+
+You can inject your own HTTP client (e.g., `fetch`, `got`, `undici`) for full control:
+
+```ts
+import { WhatsApp, IHttpClient, RequestOptions } from '@raphaelvserafim/client-api-whatsapp';
+
+class MyHttpClient implements IHttpClient {
+  async request<T>(options: RequestOptions): Promise<T> {
+    const response = await fetch(`https://us.api-wa.me/MY_KEY/${options.route}`, {
+      method: options.method,
+      headers: { 'Content-Type': 'application/json' },
+      body: options.body ? JSON.stringify(options.body) : undefined,
+    });
+    return response.json() as Promise<T>;
+  }
+}
+
+const wa = new WhatsApp(
+  { server: "https://us.api-wa.me", key: "MY_KEY" },
+  new MyHttpClient(),
+);
+```
+
+## Error Handling
+
+All API errors throw `WhatsAppError` with status code and response body:
+
+```ts
+import { WhatsAppError } from '@raphaelvserafim/client-api-whatsapp';
+
+try {
+  await wa.message.send({ type: TypeMessage.TEXT, body: { to, text: "Hello" } });
+} catch (error) {
+  if (error instanceof WhatsAppError) {
+    console.error(error.message);       // Error message
+    console.error(error.statusCode);    // HTTP status code (e.g., 401, 404)
+    console.error(error.responseBody);  // API response body
+  }
+}
+```