@nuiisweety/baileys 0.1.11 → 0.1.13

package/README.md.bak

@@ -72,11 +72,16 @@
 [Secure Meta Label](#secure-meta-service-label)
 
 🎛️ **Interactive** —
+[Buttons Location Header](#buttons-dengan-location-header-buttonsmessage-langsung) ·
 [Buttons](#buttons) ·
 [List Message](#list-message) ·
 [Template Buttons](#template-buttons) ·
 [Native Flow](#native-flow) ·
-[Carousel](#carousel)
+[Carousel](#carousel) ·
+[Shop Message](#shop-message) ·
+[Collection Message](#collection-message) ·
+[Order Status Message](#order-status-message) ·
+[Product List Message](#product-list-message)
 
 🤖 **Rich Message (AI)** —
 [Text](#addtext) ·
@@ -927,11 +932,85 @@ await sock.sendMessage(jid, {
 
 ---
 
+<details>
+<summary>📍 Buttons dengan Location Header (buttonsMessage langsung)</summary>
+
+Kirim tombol menggunakan `buttonsMessage` secara langsung — berguna untuk header tipe **Location** (`headerType: 6`) yang tidak bisa dibuat lewat shorthand `buttons`.
+
+```js
+// Tombol dengan header lokasi (headerType 6)
+await sock.sendMessage(jid, {
+  buttonsMessage: {
+    locationMessage: {
+      degreesLatitude: 0,
+      degreesLongitude: 0,
+      name: 'NuiiSweety',
+      address: 'NuiiSweety Bot',
+      jpegThumbnail: './src/img/menu.jpg'  // path file, URL, atau Buffer
+    },
+    contentText: 'Pilih menu di bawah ini',
+    footerText: 'Powered by @nuiisweety/baileys',
+    buttons: [
+      { buttonId: 'allmenu', buttonText: { displayText: 'All Menu' }, type: 1 }
+    ],
+    headerType: 6
+  }
+})
+
+// Dengan quoted (reply ke pesan tertentu)
+await sock.sendMessage(jid, {
+  buttonsMessage: {
+    locationMessage: {
+      degreesLatitude: -6.2,
+      degreesLongitude: 106.8,
+      name: 'Menu Bot',
+      address: 'NuiiSweety',
+      jpegThumbnail: './src/img/menu.jpg'
+    },
+    contentText: 'Halo! Ini menu utama bot',
+    footerText: 'NuiiSweety Bot',
+    buttons: [
+      { buttonId: 'menu1', buttonText: { displayText: '🍱 Menu Utama' }, type: 1 },
+      { buttonId: 'help',  buttonText: { displayText: '❓ Bantuan' },    type: 1 }
+    ],
+    headerType: 6
+  }
+}, { quoted: m })
+
+// Header kosong (teks saja, tanpa media/lokasi) — headerType 1
+await sock.sendMessage(jid, {
+  buttonsMessage: {
+    contentText: 'Pilih opsi',
+    footerText: 'Bot Footer',
+    buttons: [
+      { buttonId: 'yes', buttonText: { displayText: 'Ya' },  type: 1 },
+      { buttonId: 'no',  buttonText: { displayText: 'Tidak' }, type: 1 }
+    ],
+    headerType: 1
+  }
+})
+```
+
+> **Catatan `headerType`:**
+> | Nilai | Tipe Header |
+> |-------|-------------|
+> | `1`   | Teks (`contentText`) |
+> | `2`   | Gambar (`imageMessage`) |
+> | `3`   | Video (`videoMessage`) |
+> | `4`   | Dokumen (`documentMessage`) |
+> | `6`   | Lokasi (`locationMessage`) |
+>
+> `jpegThumbnail` pada `locationMessage` bisa berupa **path file lokal**, **URL**, atau **Buffer** — otomatis diproses oleh Baileys.
+
+</details>
+
+---
+
 <details>
 <summary>🎛️ Buttons</summary>
 
 ```js
-// Teks dengan tombol
+// Teks dengan tombol (quick reply)
 await sock.sendMessage(jid, {
   text: 'Pilih salah satu',
   footer: 'Footer pesan',
@@ -953,7 +1032,28 @@ await sock.sendMessage(jid, {
   ]
 })
 
-// Native flow button
+// Native flow button dalam buttons — pakai name + paramsJson
+await sock.sendMessage(jid, {
+  text: 'Pilih menu',
+  buttons: [
+    {
+      name: 'single_select',
+      text: 'Buka Menu',
+      paramsJson: JSON.stringify({
+        title: 'Buka Menu',
+        sections: [{
+          title: 'Kategori A',
+          rows: [
+            { id: 'row1', title: 'Item 1', description: 'Deskripsi' },
+            { id: 'row2', title: 'Item 2' }
+          ]
+        }]
+      })
+    }
+  ]
+})
+
+// Shorthand: sections langsung di button (otomatis jadi single_select)
 await sock.sendMessage(jid, {
   text: 'Pilih menu',
   buttons: [{
@@ -969,6 +1069,8 @@ await sock.sendMessage(jid, {
 })
 ```
 
+> **Field tombol:** gunakan `text` atau `buttonText` untuk label. Untuk quick reply gunakan `id`/`buttonId`. Untuk native flow gunakan `name` + `paramsJson`.
+
 </details>
 
 ---
@@ -978,10 +1080,10 @@ await sock.sendMessage(jid, {
 
 ```js
 await sock.sendMessage(jid, {
-  text: 'Silakan pilih',
-  title: 'Judul List',
-  buttonText: 'Buka Daftar',
-  footer: 'Footer pesan',
+  text: 'Silakan pilih',       // → description (isi pesan)
+  title: 'Judul List',         // → title (judul di atas list)
+  buttonText: 'Buka Daftar',   // → teks tombol pembuka
+  footer: 'Footer pesan',      // → footerText
   sections: [
     {
       title: 'Bagian 1',
@@ -1000,6 +1102,8 @@ await sock.sendMessage(jid, {
 })
 ```
 
+> **Trigger key:** `sections` (bukan `listMessage`). `listType` otomatis di-set ke `SINGLE_SELECT`. Field `text` di-map ke `description` (isi pesan), bukan judul — gunakan `title` untuk judul list.
+
 </details>
 
 ---
@@ -1010,9 +1114,9 @@ await sock.sendMessage(jid, {
 ```js
 // Teks
 await sock.sendMessage(jid, {
-  text: 'Pesan template',
-  footer: 'Footer',
-  id: 'template-unik',
+  text: 'Pesan template',       // → hydratedContentText
+  footer: 'Footer',             // → hydratedFooterText
+  id: 'template-unik',          // → templateId (opsional, auto-generate jika tidak diisi)
   templateButtons: [
     { id: 'btn1', text: 'Quick Reply' },
     { url: 'https://example.com', text: 'Kunjungi Website' },
@@ -1023,8 +1127,8 @@ await sock.sendMessage(jid, {
 // Gambar sebagai header
 await sock.sendMessage(jid, {
   image: { url: 'https://example.com/img.jpg' },
-  caption: 'Isi pesan',
-  title: 'Judul',
+  caption: 'Isi pesan',         // → hydratedContentText
+  title: 'Judul',               // → hydratedTitleText (hanya aktif jika ada caption)
   footer: 'Footer',
   templateButtons: [
     { id: 'btn1', text: 'Klik Sini' },
@@ -1033,6 +1137,8 @@ await sock.sendMessage(jid, {
 })
 ```
 
+> **Tipe tombol:** `{ id, text }` → quick reply · `{ url, text }` → URL button · `{ call, text }` → call button. `text` atau `buttonText` keduanya diterima. Jika `id` tidak diisi, otomatis `template-<timestamp>`.
+
 </details>
 
 ---
@@ -1041,34 +1147,108 @@ await sock.sendMessage(jid, {
 <summary>🌊 Native Flow</summary>
 
 ```js
-// Teks dengan native flow buttons
+// Quick reply
 await sock.sendMessage(jid, {
   text: 'Pilih aksi',
   footer: 'Footer pesan',
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Opsi 1' },
-    { name: 'quick_reply', paramsJson: '{"id":"2"}', text: 'Opsi 2' }
+    { id: '1', text: 'Opsi 1' },   // id → quick_reply
+    { id: '2', text: 'Opsi 2' }
   ]
 })
 
-// Gambar sebagai header
+// URL button
+await sock.sendMessage(jid, {
+  text: 'Kunjungi kami',
+  nativeFlow: [
+    { url: 'https://example.com', text: 'Buka Website' }
+  ]
+})
+
+// Copy code button
+await sock.sendMessage(jid, {
+  text: 'Kode promo kamu',
+  nativeFlow: [
+    { copy: 'PROMO2025', text: 'Salin Kode' }
+  ]
+})
+
+// Call button
+await sock.sendMessage(jid, {
+  text: 'Hubungi kami',
+  nativeFlow: [
+    { call: '+62812345678', text: 'Telepon Sekarang' }
+  ]
+})
+
+// Single select (list dalam button)
+await sock.sendMessage(jid, {
+  text: 'Pilih menu',
+  nativeFlow: [
+    {
+      sections: [{
+        title: 'Kategori A',
+        rows: [
+          { id: 'row1', title: 'Item 1', description: 'Deskripsi' },
+          { id: 'row2', title: 'Item 2' }
+        ]
+      }],
+      text: 'Buka Daftar'
+    }
+  ]
+})
+
+// Dengan icon pada tombol
+await sock.sendMessage(jid, {
+  text: 'Pilih aksi',
+  nativeFlow: [
+    { id: '1', text: 'Konfirmasi', icon: 'CHECK' },
+    { url: 'https://example.com', text: 'Buka', icon: 'LINK' }
+  ]
+})
+
+// Gambar sebagai header — WAJIB pakai image/video/document/location/product
+// jika tidak ada media valid → throw Error: Invalid media type
 await sock.sendMessage(jid, {
   image: { url: 'https://example.com/img.jpg' },
-  caption: 'Isi pesan',
-  title: 'Judul',
-  subtitle: 'Subjudul',
+  caption: 'Isi pesan',     // → body.text
+  title: 'Judul',           // → header.title
+  subtitle: 'Subjudul',     // → header.subtitle
   footer: 'Footer',
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Tombol 1' }
+    { id: '1', text: 'Tombol 1' }
   ]
 })
 
-// Dengan audio footer
+// Dengan audio footer (menggantikan footer teks)
 await sock.sendMessage(jid, {
   text: 'Pesan dengan audio footer',
   audioFooter: fs.readFileSync('audio.ogg'),
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'OK' }
+    { id: '1', text: 'OK' }
+  ]
+})
+
+// offerText — tampil sebagai limited time offer banner
+await sock.sendMessage(jid, {
+  text: 'Penawaran terbatas!',
+  offerText: 'Diskon 50%',
+  offerUrl: 'https://example.com/promo',
+  offerCode: 'DISKON50',
+  offerExpiration: 1800000000,
+  nativeFlow: [
+    { id: 'claim', text: 'Klaim Sekarang' }
+  ]
+})
+
+// optionText — tombol-tombol masuk ke bottom sheet
+await sock.sendMessage(jid, {
+  text: 'Pilih opsi',
+  optionText: 'Lihat Semua Opsi',
+  optionTitle: 'Daftar Pilihan',
+  nativeFlow: [
+    { id: '1', text: 'Opsi A' },
+    { id: '2', text: 'Opsi B' }
   ]
 })
 
@@ -1076,13 +1256,126 @@ await sock.sendMessage(jid, {
 await sock.sendMessage(jid, {
   text: 'Template interaktif',
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Tombol' }
+    { id: '1', text: 'Tombol' }
   ],
   interactiveAsTemplate: true,
   id: 'template-id-unik'
 })
 ```
 
+> **Tipe tombol ditentukan otomatis** dari field yang ada:
+>
+> | Field pada button | Native Flow yang dihasilkan |
+> |---|---|
+> | `id` | `quick_reply` |
+> | `url` | `cta_url` |
+> | `copy` | `cta_copy` |
+> | `call` | `cta_call` |
+> | `sections` | `single_select` |
+> | `catalog` | `cta_catalog` |
+> | `reminder: true` | `cta_reminder` |
+> | `cancelReminder: true` | `cta_cancel_reminder` |
+> | `address: true` | `address_message` |
+> | `location: true` | `send_location` |
+> | `webview` | `open_webview` |
+> | `productId` | `mpm` |
+> | `transactionId` | `wa_payment_transaction_details` |
+> | `catalogProduct` | `automated_greeting_message_view_catalog` |
+> | `flow` | `galaxy_message` (WA Flow) |
+>
+> Bisa juga pakai `name` + `paramsJson` langsung untuk kontrol penuh. `text` atau `buttonText` keduanya diterima. Field `icon` opsional (string uppercase, e.g. `'CHECK'`, `'LINK'`).
+
+```js
+// Catalog button — buka katalog bisnis
+await sock.sendMessage(jid, {
+  text: 'Lihat produk kami',
+  nativeFlow: [
+    { catalog: '628xxx', text: 'Buka Katalog' }
+  ]
+})
+
+// Reminder button
+await sock.sendMessage(jid, {
+  text: 'Ingatkan saya',
+  nativeFlow: [
+    { reminder: true, text: 'Set Pengingat' },
+    { cancelReminder: true, text: 'Batalkan Pengingat' }
+  ]
+})
+
+// Address & Location button
+await sock.sendMessage(jid, {
+  text: 'Butuh info lokasi',
+  nativeFlow: [
+    { address: true, text: 'Bagikan Alamat' },
+    { location: true, text: 'Kirim Lokasi' }
+  ]
+})
+
+// Open Webview button
+await sock.sendMessage(jid, {
+  text: 'Buka halaman web',
+  nativeFlow: [
+    { webview: 'https://example.com', text: 'Buka', inAppWebview: true }
+  ]
+})
+
+// MPM — Multi-product message button
+await sock.sendMessage(jid, {
+  text: 'Produk pilihan',
+  nativeFlow: [
+    { productId: '8816262248471474', text: 'Lihat Produk' }
+  ]
+})
+
+// Payment transaction details button
+await sock.sendMessage(jid, {
+  text: 'Detail pembayaran',
+  nativeFlow: [
+    { transactionId: '12345848', text: 'Lihat Detail' }
+  ]
+})
+
+// Automated greeting catalog button
+await sock.sendMessage(jid, {
+  text: 'Halo! Cek katalog kami',
+  nativeFlow: [
+    {
+      catalogProduct: { bizPhone: '628xxx', productId: '12345' },
+      text: 'Lihat Katalog'
+    }
+  ]
+})
+
+// WA Flow (galaxy_message)
+await sock.sendMessage(jid, {
+  text: 'Isi formulir pendaftaran',
+  nativeFlow: [
+    {
+      flow: {
+        mode: 'published',
+        flowId: '1307913409923914',
+        flowToken: '1:1307913409923914:293680f87029f5a13d1ec5e35e718af3',
+        flowCta: 'Daftar Sekarang',
+        flowAction: 'navigate',
+        flowActionPayload: {
+          screen: 'QUESTION_ONE',
+          params: { user_id: '123456789' }
+        },
+        flowMetadata: {
+          flow_json_version: '201',
+          data_api_protocol: 'v2',
+          flow_name: 'Lead Qualification',
+          data_api_version: 'v2',
+          categories: ['Lead Generation']
+        }
+      },
+      text: 'Buka Flow'
+    }
+  ]
+})
+```
+
 </details>
 
 ---
@@ -1120,6 +1413,172 @@ await sock.sendMessage(jid, {
 
 ---
 
+<details>
+<summary>🏪 Shop Message</summary>
+
+Menampilkan storefront toko bisnis WhatsApp. Bisa dengan header teks, gambar, video, dokumen, lokasi, atau produk.
+
+```js
+// Teks biasa
+await sock.sendMessage(jid, {
+  text: 'Kunjungi toko kami!',
+  title: 'Toko Kami',
+  subtitle: 'Produk terbaik',
+  footer: 'Belanja sekarang',
+  shop: {
+    surface: 1, // 1 | 2 | 3 | 4
+    id: 'https://example.com'
+  }
+})
+
+// Dengan gambar
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/banner.jpg' },
+  caption: 'Promo spesial hari ini!',
+  title: 'Toko Kami',
+  subtitle: 'Diskon 50%',
+  footer: 'Tap untuk belanja',
+  hasMediaAttachment: true,
+  shop: {
+    surface: 1,
+    id: 'https://example.com'
+  }
+})
+
+// Dengan video
+await sock.sendMessage(jid, {
+  video: { url: 'https://example.com/promo.mp4' },
+  caption: 'Tonton promo kami!',
+  title: 'Promo Bulan Ini',
+  footer: 'Belanja sekarang',
+  hasMediaAttachment: true,
+  shop: { surface: 2, id: 'https://example.com' }
+})
+```
+
+</details>
+
+---
+
+<details>
+<summary>📦 Collection Message</summary>
+
+Menampilkan koleksi produk dari bisnis WhatsApp.
+
+```js
+// Teks biasa
+await sock.sendMessage(jid, {
+  text: 'Koleksi terbaru kami',
+  title: 'Koleksi Musim Ini',
+  subtitle: 'Pilihan terbaik',
+  footer: 'Lihat semua',
+  collection: {
+    bizJid: '628xxx@s.whatsapp.net',
+    id: 'collection-id-123',
+    version: 1
+  }
+})
+
+// Dengan gambar
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/collection.jpg' },
+  caption: 'Temukan koleksi terbaru!',
+  title: 'Koleksi Baru',
+  subtitle: 'Limited edition',
+  footer: 'Stok terbatas!',
+  hasMediaAttachment: true,
+  collection: {
+    bizJid: '628xxx@s.whatsapp.net',
+    id: 'collection-id-456',
+    version: 1
+  }
+})
+```
+
+</details>
+
+---
+
+<details>
+<summary>📦 Order Status Message</summary>
+
+Mengirim kartu status pesanan dengan tampilan native WhatsApp (menggunakan `order_status` native flow, dibungkus view once).
+
+```js
+await sock.sendMessage(jid, {
+  orderStatus: {
+    image: 'path/to/image.jpg',     // string path, URL, atau Buffer — wajib
+    title: 'Status Pesananmu',      // judul header
+    text: 'Pesananmu sedang diproses.',
+    footer: 'Terima kasih sudah belanja!',
+    referenceId: 'ORDER-001',       // ID referensi pesanan
+    status: 'PROCESSING',           // PROCESSING | COMPLETED | CANCELLED | dst
+    subtotalValue: 50000,           // subtotal dalam satuan terkecil
+    subtotalOffset: 100,            // pembagi (100 = dalam rupiah)
+    taxValue: 5000,
+    taxOffset: 100,
+    currency: 'IDR'
+  }
+})
+
+// Status pesanan selesai
+await sock.sendMessage(jid, {
+  orderStatus: {
+    image: { url: 'https://example.com/order.jpg' },
+    title: 'Pesanan Selesai! 🎉',
+    text: 'Pesananmu telah dikirim.',
+    referenceId: 'ORDER-789',
+    status: 'COMPLETED',
+    subtotalValue: 150000,
+    subtotalOffset: 100,
+    taxValue: 0,
+    taxOffset: 100,
+    currency: 'IDR'
+  }
+}, { quoted: m })
+```
+
+> ⚠️ `image` wajib diisi — `orderStatus` selalu dibungkus dalam viewOnceMessage.
+
+</details>
+
+---
+
+<details>
+<summary>🛒 Product List Message</summary>
+
+Menampilkan list produk bisnis (hanya berfungsi di private chat).
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Pilih produk yang kamu inginkan',
+  title: 'Produk Pilihan',
+  buttonText: 'Lihat Daftar Produk',
+  footer: 'Stok terbatas!',
+  businessOwnerJid: '628xxx@s.whatsapp.net',
+  thumbnail: { url: 'https://example.com/thumbnail.jpg' }, // opsional
+  productList: [
+    {
+      title: 'Kategori Makanan',
+      products: [
+        { productId: '111222333' },
+        { productId: '444555666' }
+      ]
+    },
+    {
+      title: 'Kategori Minuman',
+      products: [
+        { productId: '777888999' }
+      ]
+    }
+  ]
+})
+```
+
+</details>
+
+---
+
 <details>
 <summary>🏷️ Status Mention</summary>
 
@@ -1148,16 +1607,46 @@ await sock.sendMessage(['628xxx@s.whatsapp.net'], {
 
 > Rich message menggunakan format `AIRichResponseMessage` yang tampil seperti respons AI di WhatsApp. Semua tipe di bawah bisa dipakai secara flat (field langsung) atau dikombinasikan via `richResponse: [...]`.
 
+> ⚠️ **Penting:** `contentText`, `headerText`, `footerText`, dan `disclaimerText` **bukan** trigger key — artinya jika hanya field itu yang dikirim, pesan **tidak akan** diproses sebagai rich message dan akan menghasilkan **Error: Invalid media type**. Gunakan selalu minimal satu trigger key (`code`, `table`, `richImage`, `richVideo`, `richResponse`, dll), lalu kombinasikan dengan field teks di atas sebagai pelengkap.
+
 ### ✍️ addText
 
 Kirim teks markdown sebagai AI Rich Response. Mendukung hyperlink, citation, dan LaTeX inline.
 
+Karena `contentText` bukan trigger key, gunakan `richResponse: [{ text }]` untuk pesan teks murni:
+
+```js
+// ✅ Cara benar — pakai richResponse array
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Ini teks dari AI dengan *markdown* dan **bold**.' }
+  ],
+  headerText: 'Judul',
+  footerText: 'Footer',
+  disclaimerText: 'Generated by AI'
+})
+```
+
+```js
+// ✅ Alternatif — contentText sebagai pelengkap dari trigger key lain
+await sock.sendMessage(jid, {
+  code: 'console.log("Hello")',
+  language: 'javascript',
+  contentText: 'Penjelasan tambahan di sini.',
+  headerText: 'Judul',
+  footerText: 'Footer',
+  disclaimerText: 'Generated by AI'
+})
+```
+
 ```js
+// ❌ SALAH — contentText saja tidak akan trigger rich message
 await sock.sendMessage(jid, {
-  contentText: 'Ini teks dari AI dengan *markdown* dan **bold**.',
+  contentText: 'halooo',
   headerText: 'Judul',
   footerText: 'Footer',
   disclaimerText: 'Generated by AI'
+  // → Error: Invalid media type
 })
 ```