@kanaraa/baileys

v3.5.2

Published

10 days ago

Modded Baileys v7, Rebuilt on top of official @whiskeysockets/baileys 7.0.0-rc14, with the interactive & rich-message content types (buttons, lists, carousel, cards, shop/collection, native flow, AI rich response, sticker packs, admin invite, payments, et

0High
0Medium
0Low

kanaraa

whatsapp whatsapp-api whatsapp-web baileys baileys-fork interactive-messages rich-response

@kanaraa/baileys

Modded Baileys v7 — Pesan Interaktif, AI Rich Response & More

Build modifikasi dari WhiskeySockets/Baileys dengan dukungan native untuk pesan interaktif, album, AI rich response, newsletter, status mention, dan berbagai utilitas tambahan.

Package ini adalah distribusi/build repo untuk @kanaraa/baileys. Berisi file runtime yang sudah dikompilasi di lib/ dan protobuf di WAProto/, dirancang untuk digunakan langsung dari npm.

Daftar Isi

Fitur

| Fitur | Deskripsi | Status | |---|---|---| | Pesan Interaktif | Flow button native, list/select menu, carousel | Ya | | Album Messages | Multi-image/video album dengan metadata | Ya | | AI Rich Response | sendTable, sendList, sendCodeBlock, sendRichMessage | Ya | | Unified Response V2 | sendTableV2, sendCodeBlockV2, sendLinkV2 | Ya | | Link Messages | Link inline dengan kutipan dan verifikasi | Ya | | Payment Messages | Pesan pembayaran, split payment, dengan catatan/stiker | Ya | | Produk & Katalog | Pesan produk bisnis, katalog lengkap | Ya | | Event & Poll | Builder pesan event dan hasil polling | Ya | | Newsletter Extras | Follow massal, metadata, admin utilities | Ya | | Komunitas & Grup | CRUD komunitas, undangan, persetujuan | Ya | | Status Mention | sendStatusMention() untuk mention di status | Ya | | LID & Session | Pemetaan LID↔PN, migrasi sesi | Ya | | TypeScript | File .d.ts tersedia untuk semua API | Ya |

Persyaratan

Node.js >= 20.0.0
Proyek ESM ("type": "module" di package.json)
Auth store persisten untuk penggunaan produksi
Opsional: pino, qrcode-terminal, sharp, jimp

Penting: @kanaraa/baileys hanya mendukung ESM. Proyek CommonJS perlu migrasi atau dynamic import wrapper.

Isi Package

| Path | Kegunaan | |---|---| | lib/ | Runtime utama, tipe, socket layer, utilitas | | WAProto/ | Protobuf runtime yang sudah digenerate | | package.json | Metadata package |

Instalasi

Via Terminal (langsung)

npm install @kanaraa/baileys

Package pendamping yang disarankan:

npm install pino qrcode-terminal

Via package.json — Fork Baileys

Jika proyekmu menggunakan fork dari @whiskeysockets/baileys atau @adiwajshing/baileys, tambahkan alias berikut ke package.json:

Fork @whiskeysockets/baileys

{
  "dependencies": {
    "@whiskeysockets/baileys": "npm:@kanaraa/baileys"
  }
}

Fork @adiwajshing/baileys

{
  "dependencies": {
    "@adiwajshing/baileys": "npm:@kanaraa/baileys"
  }
}

Lalu jalankan:

npm install

Via Terminal — Non Fork (alias custom)

npm install kanaraa-bail@npm:@kanaraa/baileys

Menggunakan Alias (generic)

Tambahkan ke package.json:

{
  "dependencies": {
    "baileys": "npm:@kanaraa/baileys@latest"
  }
}

Lalu jalankan:

npm install

Quick Start

1. Setup Proyek

mkdir bot-ku && cd bot-ku
npm init -y

Pastikan package.json memiliki "type": "module":

{
  "name": "bot-ku",
  "type": "module",
  "dependencies": {
    "baileys": "npm:@kanaraa/baileys@latest"
  }
}

2. Install Dependensi

npm install @kanaraa/baileys pino qrcode-terminal

3. Buat `index.js`

import makeWASocket, {
  useMultiFileAuthState,
  DisconnectReason,
  Browsers,
} from '@kanaraa/baileys'
import pino from 'pino'
import qrcode from 'qrcode-terminal'

const logger = pino({ level: 'silent' })

async function startBot() {
  const { state, saveCreds } = await useMultiFileAuthState('./session')

  const sock = makeWASocket({
    auth: state,
    logger,
    browser: Browsers.ubuntu('Chrome'),
    syncFullHistory: false,
  })

  sock.ev.on('creds.update', saveCreds)

  sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {
    if (qr) qrcode.generate(qr, { small: true })

    if (connection === 'close') {
      const shouldReconnect =
        lastDisconnect?.error?.output?.statusCode !== DisconnectReason.loggedOut
      if (shouldReconnect) startBot()
    }
    if (connection === 'open') console.log('Terhubung!')
  })

  sock.ev.on('messages.upsert', async ({ messages }) => {
    const msg = messages[0]
    if (!msg?.message || msg.key.fromMe) return

    const text =
      msg.message.conversation || msg.message.extendedTextMessage?.text || ''

    if (text === '.ping') {
      await sock.sendMessage(msg.key.remoteJid, { text: 'Pong!' })
    }
  })
}

startBot()

4. Jalankan

node index.js

Scan QR code, tunggu hingga socket mencapai connection: "open", lalu kirim .ping untuk tes.

5. Contoh Pairing Code

const sock = makeWASocket({
  auth: state,
  logger,
  browser: Browsers.windows('Chrome'),
})

sock.ev.on('connection.update', async ({ connection }) => {
  if (connection === 'connecting') {
    const code = await sock.requestPairingCode('628xxxxxxxxx')
    console.log('Pairing code:', code)
  }
})

Membaca Pesan Pengguna

Saat menerima pesan via messages.upsert, gunakan getContentType dan normalizeMessageContent untuk mendeteksi tipe dan isi pesan.

Setup Awal

import {
  getContentType,
  normalizeMessageContent,
  downloadMediaMessage,
} from '@kanaraa/baileys'

sock.ev.on('messages.upsert', async ({ messages }) => {
  const msg = messages[0]
  if (!msg?.message || msg.key.fromMe) return

  const jid = msg.key.remoteJid
  const content = normalizeMessageContent(msg.message) // handle viewOnce, ephemeral, dll
  const type = getContentType(content)

  // Ambil teks dari tipe apapun
  const text =
    content?.conversation ||
    content?.extendedTextMessage?.text ||
    content?.imageMessage?.caption ||
    content?.videoMessage?.caption ||
    content?.documentMessage?.caption ||
    ''
})

Text Message

if (type === 'conversation' || type === 'extendedTextMessage') {
  const text = content?.conversation || content?.extendedTextMessage?.text || ''
  console.log('Teks:', text)
}

Image Message

if (type === 'imageMessage') {
  const caption = content.imageMessage.caption || ''
  const mimetype = content.imageMessage.mimetype // 'image/jpeg'
  console.log('Gambar diterima, caption:', caption)
}

Video Message

if (type === 'videoMessage') {
  const caption = content.videoMessage.caption || ''
  const seconds = content.videoMessage.seconds // durasi
  console.log('Video diterima, caption:', caption)
}

Audio Message

if (type === 'audioMessage') {
  const isVoiceNote = content.audioMessage.ptt === true
  const seconds = content.audioMessage.seconds
  console.log(isVoiceNote ? 'Voice note' : 'Audio', 'durasi:', seconds, 'detik')
}

Document Message

if (type === 'documentMessage') {
  const fileName = content.documentMessage.fileName || 'unknown'
  const mimetype = content.documentMessage.mimetype
  const caption = content.documentMessage.caption || ''
  console.log('Dokumen:', fileName, '|', mimetype)
}

Sticker Message

if (type === 'stickerMessage') {
  const isAnimated = content.stickerMessage.isAnimated
  const isLottie = content.stickerMessage.isLottie
  console.log('Stiker diterima, animasi:', isAnimated)
}

Location Message

if (type === 'locationMessage') {
  const { degreesLatitude, degreesLongitude, name, address } = content.locationMessage
  console.log(`Lokasi: ${name} — ${degreesLatitude}, ${degreesLongitude}`)
}

Contact Message

if (type === 'contactMessage') {
  const { displayName, vcard } = content.contactMessage
  console.log('Kontak:', displayName)
  console.log('vCard:', vcard)
}

Poll Message

if (
  type === 'pollCreationMessage' ||
  type === 'pollCreationMessageV2' ||
  type === 'pollCreationMessageV3'
) {
  const poll = content[type]
  const name = poll.name
  const options = poll.options.map(o => o.optionName)
  console.log('Poll:', name, '| Opsi:', options)
}

Buttons Response Message

// Saat user memilih dari Buttons Message
if (type === 'buttonsResponseMessage') {
  const selectedId = content.buttonsResponseMessage.selectedButtonId
  const selectedText = content.buttonsResponseMessage.selectedDisplayText
  console.log(`Tombol dipilih: [${selectedId}] ${selectedText}`)
}

List Response Message

// Saat user memilih dari List / Select Menu
if (type === 'listResponseMessage') {
  const rowId = content.listResponseMessage.singleSelectReply.selectedRowId
  const title = content.listResponseMessage.title
  console.log(`List dipilih: [${rowId}] ${title}`)
}

Template Button Reply Message

// Saat user memilih dari Template Buttons
if (type === 'templateButtonReplyMessage') {
  const selectedId = content.templateButtonReplyMessage.selectedId
  const selectedText = content.templateButtonReplyMessage.selectedDisplayText
  console.log(`Template dipilih: [${selectedId}] ${selectedText}`)
}

Interactive Response Message

// Saat user memilih dari Interactive / Flow Buttons (termasuk nativeFlowMessage)
if (type === 'interactiveResponseMessage') {
  const raw = content.interactiveResponseMessage?.nativeFlowResponseMessage?.paramsJson
  const parsed = raw ? JSON.parse(raw) : {}
  const selectedId = parsed.id
  console.log('Interaktif dipilih:', parsed)
}

Deteksi Pesan Reply (Quoted)

sock.ev.on('messages.upsert', async ({ messages }) => {
  const msg = messages[0]
  if (!msg?.message) return

  const content = normalizeMessageContent(msg.message)

  // contextInfo ada di dalam tipe pesan terkait
  const contextInfo =
    content?.extendedTextMessage?.contextInfo ||
    content?.imageMessage?.contextInfo ||
    content?.videoMessage?.contextInfo ||
    null

  if (contextInfo?.quotedMessage) {
    const quotedContent = normalizeMessageContent(contextInfo.quotedMessage)
    const quotedType = getContentType(quotedContent)
    const quotedText =
      quotedContent?.conversation ||
      quotedContent?.extendedTextMessage?.text ||
      quotedContent?.imageMessage?.caption || ''

    console.log(`Pesan ini reply ke [${quotedType}]: ${quotedText}`)
  }
})

Download Media dari Pesan

Bisa digunakan untuk imageMessage, videoMessage, audioMessage, stickerMessage, documentMessage.

sock.ev.on('messages.upsert', async ({ messages }) => {
  const msg = messages[0]
  if (!msg?.message) return

  const buffer = await downloadMediaMessage(
    msg,
    'buffer', // atau 'stream'
    {},
    {
      logger,
      reuploadRequest: sock.updateMediaMessage,
    }
  )
  console.log('Media didownload, ukuran:', buffer.length, 'bytes')
})

Referensi API Socket

Koneksi & Autentikasi

const sock = makeWASocket({
  auth: state,
  logger,
  browser: Browsers.ubuntu('Chrome'),
  connectTimeoutMs: 20_000,
  defaultQueryTimeoutMs: 60_000,
  syncFullHistory: false,
})

Kirim Pesan

// Teks
await sock.sendMessage(jid, { text: 'Halo!' })

// Gambar
await sock.sendMessage(jid, {
  image: { url: './foto.jpg' },
  caption: 'Sebuah foto',
})

// Video
await sock.sendMessage(jid, {
  video: { url: './video.mp4' },
  caption: 'Sebuah video',
})

// Audio / Voice Note
await sock.sendMessage(jid, {
  audio: { url: './audio.ogg' },
  mimetype: 'audio/ogg; codecs=opus',
  ptt: true,
})

// Stiker
await sock.sendMessage(jid, {
  sticker: { url: './stiker.webp' },
})

// Dokumen
await sock.sendMessage(jid, {
  document: { url: './file.pdf' },
  fileName: 'dokumen.pdf',
  mimetype: 'application/pdf',
})

// Reaksi
await sock.sendMessage(jid, {
  react: { key: msg.key, text: '👍' },
})

// Polling
await sock.sendMessage(jid, {
  poll: {
    name: 'Vote!',
    values: ['Opsi A', 'Opsi B', 'Opsi C'],
    selectableCount: 1,
  },
})

// Hapus pesan
await sock.sendMessage(jid, { delete: msg.key })

// Edit pesan
await sock.sendMessage(jid, {
  text: 'Teks yang sudah diedit',
  edit: msg.key,
})

Pack Sticker (Sticker Pack)

Kirim koleksi stiker dalam satu pack — bisa dari URL, buffer, atau file lokal.

// Dari URL
await sock.sendMessage(jid, {
  stickerPackMessage: {
    name: 'Pack Keren',
    publisher: 'kanaraa',
    stickers: [
      { url: 'https://example.com/stiker1.webp', emojis: ['😂'] },
      { url: 'https://example.com/stiker2.webp', emojis: ['🔥'] },
      { url: 'https://example.com/stiker3.gif',  emojis: ['✨'], isAnimated: true },
    ],
  },
})

// Dari Buffer
import { readFile } from 'fs/promises'
const buf1 = await readFile('./stiker1.webp')
const buf2 = await readFile('./stiker2.webp')

await sock.sendMessage(jid, {
  stickerPackMessage: {
    name: 'Pack Lokal',
    publisher: 'Bot Ku',
    trayIcon: './tray.png', // opsional, ikon kecil pack (96x96)
    stickers: [
      { buffer: buf1, emojis: ['😎'] },
      { buffer: buf2, emojis: ['💯'], isAnimated: false },
    ],
  },
})

PTV (Push-to-Video / Video Note)

Kirim video berbentuk lingkaran seperti video note Telegram.

await sock.sendMessage(jid, {
  video: { url: './video.mp4' },
  ptv: true,
})

Share / Request Nomor Telepon

// Bagikan nomor telepon kamu ke lawan chat
await sock.sendMessage(jid, { sharePhoneNumber: true })

// Minta nomor telepon lawan chat
await sock.sendMessage(jid, { requestPhoneNumber: true })

Keep in Chat (Simpan Pesan)

await sock.sendMessage(jid, {
  keep: {
    key: msg.key,   // key pesan yang ingin disimpan
    type: 1,        // 1 = simpan, 2 = hapus dari simpan
  },
})

Pin Pesan

// Pin pesan selama 24 jam (86400 detik)
await sock.sendMessage(jid, {
  pin: msg.key,
  type: 1,         // 1 = pin, 2 = unpin
  time: 86400,     // durasi pin dalam detik (untuk pin)
})

Limit Sharing (Batasi Forward)

await sock.sendMessage(jid, {
  limitSharing: true,  // true = batasi, false = lepas batasan
})

Scheduled Call (Jadwalkan Panggilan)

await sock.sendMessage(jid, {
  call: {
    name: 'Meeting Mingguan',
    time: Date.now() + 3600_000, // 1 jam dari sekarang (ms)
    type: 1,   // 1 = audio, 2 = video
  },
})

Group Invite (Undangan Grup)

await sock.sendMessage(jid, {
  groupInvite: {
    jid: '[email protected]',
    code: 'ABCDEFGH',          // kode invite
    name: 'Grup Saya',
    caption: 'Gabung yuk!',
    expiration: Math.floor(Date.now() / 1000) + 86400, // expired besok
  },
})

Newsletter Admin Invite

await sock.sendMessage(jid, {
  adminInvite: {
    jid: '120363xxxxxx@newsletter',
    name: 'Saluran Saya',
    caption: 'Jadi admin yuk!',
    expiration: Math.floor(Date.now() / 1000) + 86400,
  },
})

Payment Invite

await sock.sendMessage(jid, {
  paymentInvite: {
    type: 2,           // tipe layanan pembayaran
    expiry: 0,
  },
})

Order Status

await sock.sendMessage(jid, {
  orderStatus: {
    title: 'Status Pesanan',
    text: 'Silakan cek status pesanan Anda.',
    footer: 'Eval test',
    image: './image.jpg',        // wajib ada
    referenceId: 'LV-001',
    status: 'PROCESSING',        // PROCESSING | COMPLETED | CANCELLED
    subtotalValue: 50000,
    subtotalOffset: 100,
    taxValue: 2500,
    taxOffset: 100,
    currency: 'IDR',
  },
})

Split Payment

Ajak lawan chat patungan/bayar bareng untuk satu order.

await sock.sendMessage(jid, {
  splitPayment: {
    text: 'Yuk bayar split sama-sama',
    referenceId: 'LV-002',
    currency: 'IDR',
    value: 5000000,
    offset: 100,
    orderType: 'ORDER',
  },
})

Event Message

await sock.sendMessage(jid, {
  event: {
    name: 'Meetup Developer',
    description: 'Kumpul bareng developer lokal!',
    startDate: new Date('2025-08-01T10:00:00+07:00'),
    endDate: new Date('2025-08-01T13:00:00+07:00'),
    location: 'Jakarta, Indonesia',
    extraGuestsAllowed: true,
    isCancelled: false,
  },
})

Poll Result Snapshot

await sock.sendMessage(jid, {
  pollResult: {
    name: 'Hasil Vote Bahasa Favorit',
    values: [
      ['JavaScript', 42],
      ['Python', 38],
      ['Go', 20],
    ],
  },
})

Native Flow Message (Tombol Fleksibel)

Versi fleksibel dari interactiveMessage dengan berbagai tipe tombol. Ada 8 tipe tombol pendek yang bisa langsung dipakai lewat type + text tanpa perlu mikirin format buttonParamsJson manual: reply, url, call, copy, location, address, reminder, dan cancel_reminder.

Contoh lengkap 8 tipe tombol sekaligus:

await sock.sendMessage(jid, {
  nativeFlowMessage: {
    body: 'Contoh semua jenis tombol native flow',
    footer: 'Eval test - semua tombol',
    buttons: [
      { type: 'reply',           text: 'Quick Reply',    id: 'qr1' },
      { type: 'url',             text: 'Buka Website',   url: 'https://example.com' },
      { type: 'call',            text: 'Telepon Saya',   id: '628xxxxxxxxx' },
      { type: 'copy',            text: 'Copy Kode',      copy_code: 'PROMO2025' },
      { type: 'location',        text: 'Kirim Lokasi' },
      { type: 'address',         text: 'Pilih Alamat',   id: 'addr1' },
      { type: 'reminder',        text: 'Set Reminder',   id: 'remind1' },
      { type: 'cancel_reminder', text: 'Batalkan Reminder', id: 'remind1' },
    ],
  },
})

Contoh sederhana — quick reply dengan gambar:

await sock.sendMessage(jid, {
  nativeFlowMessage: {
    image: './image.jpg',
    body: 'Ini contoh quick_reply pakai gambar',
    footer: 'Eval test',
    buttons: [
      { type: 'reply', text: 'Tombol 1', id: 'tes1' },
      { type: 'reply', text: 'Tombol 2', id: 'tes2' },
      { type: 'reply', text: 'Tombol 3', id: 'tes3' },
    ],
  },
})

Contoh campuran — reply, url, dan copy dalam satu pesan:

await sock.sendMessage(jid, {
  nativeFlowMessage: {
    image: './image.jpg',
    body: 'Pilih salah satu opsi di bawah',
    footer: 'Eval test',
    buttons: [
      { type: 'reply', text: 'Konfirmasi',         id: 'confirm1' },
      { type: 'url',   text: 'Kunjungi Website',   url: 'https://example.com' },
      { type: 'copy',  text: 'Copy No. Rekening',  copy_code: '1234567890' },
    ],
  },
})

List Menu Khusus (single_select) — via generateWAMessageFromContent:

single_select bukan salah satu dari 8 tipe pendek di atas, jadi cara paling reliable buat dipakai adalah bangun langsung interactiveMessage-nya lewat generateWAMessageFromContent, lalu kirim pakai relayMessage. Ini juga jalur yang sama dipakai sock.sendMessage() di balik layar, jadi hasilnya konsisten.

const { generateWAMessageFromContent } = await import('@kanaraa/baileys')

const msg = generateWAMessageFromContent(
  jid,
  {
    viewOnceMessage: {
      message: {
        interactiveMessage: {
          header: { title: '', subtitle: '', hasMediaAttachment: false },
          body: { text: 'test single select' },
          footer: { text: 'Vøid' },
          nativeFlowMessage: {
            buttons: [
              {},
              {
                name: 'single_select',
                buttonParamsJson: JSON.stringify({
                  display_text: '\u0000',
                  title: 'Pilih Opsi',
                  sections: [
                    {
                      title: 'Kategori 1',
                      rows: [
                        { title: 'Opsi 1', description: 'deskripsi 1', id: 'opt1' },
                        { title: 'Opsi 2', description: 'deskripsi 2', id: 'opt2' },
                      ],
                    },
                    {
                      title: 'Kategori 2',
                      rows: [
                        { title: 'Opsi 3', description: 'deskripsi 3', id: 'opt3' },
                        { title: 'Opsi 4', description: 'deskripsi 4', id: 'opt4' },
                      ],
                    },
                  ],
                }),
              },
            ],
            messageParamsJson: '{}',
          },
        },
      },
    },
  },
  {}
)

await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })

sock di sini maksudnya socket bot kamu — ganti sesuai nama variabel yang kamu pakai sendiri (gara, client, conn, apapun). Begitu juga jid, ganti dengan JID tujuan pesan.

Beberapa hal yang perlu diperhatikan dari contoh di atas: array buttons sengaja diisi {} kosong di posisi pertama sebelum objek single_select-nya — pola ini yang paling stabil dites di lapangan. header di sini nggak wajib kosong seperti contoh — kalau mau nambahin gambar, tinggal isi header dengan properti media, misalnya:

header: {
  title: 'Pilih Menu',
  hasMediaAttachment: true,
  imageMessage: { url: './image.jpg' }, // atau isi hasil dari prepareWAMessageMedia
}

Jadi gambar di sini sifatnya opsional, tinggal disesuaikan sama kebutuhan pesan kamu — nggak harus selalu ada.

Tombol Khusus (quick_reply, cta_url, cta_copy) — via generateWAMessageFromContent:

Pola yang sama juga bisa dipakai buat gabung beberapa jenis tombol native flow sekaligus dalam satu pesan, di luar cara shorthand type/text yang sudah dibahas di atas:

const { generateWAMessageFromContent } = await import('@kanaraa/baileys')

const msg = generateWAMessageFromContent(
  jid,
  {
    viewOnceMessage: {
      message: {
        interactiveMessage: {
          header: { title: '', subtitle: '', hasMediaAttachment: false },
          body: { text: 'test button nativeflow' },
          footer: { text: 'Vøid' },
          nativeFlowMessage: {
            buttons: [
              {},
              {
                name: 'quick_reply',
                buttonParamsJson: JSON.stringify({ display_text: '\u0000', id: 'qr1', icon: 'PROMOTION' })
              },
              {
                name: 'cta_url',
                buttonParamsJson: JSON.stringify({ display_text: '\u0000', url: 'https://github.com/kanaraa', merchant_url: 'https://github.com/kanaraa', icon: 'REVIEW' })
              },
              {
                name: 'cta_copy',
                buttonParamsJson: JSON.stringify({ display_text: '\u0000', copy_code: 'KANARAA2025', icon: 'DEFAULT' })
              },
            ],
            messageParamsJson: '{}',
          },
        },
      },
    },
  },
  {}
)

await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })

Sama seperti contoh sebelumnya: sock dan jid tinggal disesuaikan ke variabel socket & JID tujuan yang kamu pakai di bot kamu sendiri.

Sama seperti contoh sebelumnya, header di sini juga opsional buat ditambahin gambar — kalau nggak butuh gambar, biarin seperti contoh (kosong), kalau butuh tinggal tambahin hasMediaAttachment: true plus imageMessage/videoMessage sesuai media yang mau ditampilkan. icon di tiap tombol juga cuma variasi tampilan (PROMOTION, REVIEW, DEFAULT, dan seterusnya) — boleh dipakai boleh nggak, nggak ngaruh ke fungsi tombolnya.

Dengan header gambar (versi shorthand biasa):

await sock.sendMessage(jid, {
  nativeFlowMessage: {
    title: 'Flash Sale!',
    body: 'Diskon 50% hari ini saja.',
    footer: 'Berlaku hingga tengah malam',
    image: 'https://example.com/banner.jpg',
    buttons: [
      { type: 'reply', text: 'Beli Sekarang', id: 'buy' },
      { type: 'url',   text: 'Lihat Katalog', url: 'https://example.com/katalog' },
    ],
  },
})

Carousel Message

await sock.sendMessage(jid, {
  carouselMessage: {
    body: 'Pilih produk favoritmu!',
    footer: 'Swipe untuk lihat lebih banyak',
    cards: [
      {
        title: 'Produk A',
        body: 'Deskripsi produk A yang keren.',
        footer: 'Rp 99.000',
        image: 'https://example.com/produk-a.jpg',
        buttons: [
          { type: 'reply', text: 'Pilih Produk A', id: 'produk_a' },
          { type: 'url',   text: 'Detail', url: 'https://example.com/a' },
        ],
      },
      {
        title: 'Produk B',
        body: 'Deskripsi produk B yang lebih keren.',
        footer: 'Rp 149.000',
        image: 'https://example.com/produk-b.jpg',
        buttons: [
          { type: 'reply', text: 'Pilih Produk B', id: 'produk_b' },
          { type: 'url',   text: 'Detail', url: 'https://example.com/b' },
        ],
      },
    ],
  },
})

Cards (Carousel dengan helper)

// Helper shorthand untuk carousel
await sock.sendMessage(jid, {
  cards: [
    {
      title: 'Item 1',
      body: 'Deskripsi item 1',
      footer: 'Rp 50.000',
      image: { url: 'https://example.com/img1.jpg' },
      buttons: [{ name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Pilih', id: 'item1' }) }],
    },
    {
      title: 'Item 2',
      body: 'Deskripsi item 2',
      footer: 'Rp 75.000',
      video: { url: 'https://example.com/video2.mp4' },
      buttons: [{ name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Pilih', id: 'item2' }) }],
    },
  ],
  text: 'Pilih item berikut:',
  footer: 'Kanaraa Shop',
})

Button Reply (Balas Tombol secara Programatis)

// Balas list
await sock.sendMessage(jid, {
  buttonReply: { title: 'Game', rowId: '.kuis' },
  type: 'list',
})

// Balas template button
await sock.sendMessage(jid, {
  buttonReply: { displayText: 'Konfirmasi', id: 'btn_confirm', index: 0 },
  type: 'template',
})

// Balas plain button
await sock.sendMessage(jid, {
  buttonReply: { id: 'btn_ok', displayText: 'OK' },
  type: 'plain',
})

// Balas interactive/flow button
await sock.sendMessage(jid, {
  buttonReply: {
    displayText: 'Menu',
    nativeFlows: {
      name: 'quick_reply',
      paramsJson: JSON.stringify({ id: 'menu' }),
      version: '1',
    },
  },
  type: 'interactive',
})

Pesan Interaktif

// Tombol Flow
await sock.sendMessage(jid, {
  interactiveMessage: {
    title: 'Selamat Datang!',
    footer: 'Powered by Kanaraa',
    buttons: [
      {
        name: 'quick_reply',
        buttonParamsJson: JSON.stringify({
          display_text: 'Menu',
          id: 'menu',
        }),
      },
      {
        name: 'cta_url',
        buttonParamsJson: JSON.stringify({
          display_text: 'Website',
          url: 'https://example.com',
        }),
      },
    ],
    header: 'Pilih opsi',
  },
})

// List Menu
await sock.sendMessage(jid, {
  interactiveMessage: {
    title: 'Pilih Kategori',
    footer: 'Powered by Kanaraa',
    buttons: [
      {
        name: 'single_select',
        buttonParamsJson: JSON.stringify({
          title: 'Menu',
          sections: [
            {
              title: 'Game',
              rows: [
                { title: 'Kuis', id: '.kuis' },
                { title: 'Tebak Gambar', id: '.tebakgambar' },
              ],
            },
          ],
        }),
      },
    ],
    header: 'Menu Bot',
  },
})

AI Rich Response

// Tabel
await sock.sendTable(
  jid,
  'Java vs JavaScript',
  ['Fitur', 'Java', 'JavaScript'],
  [
    ['Tipe', 'Compiled', 'Interpreted'],
    ['Typing', 'Static', 'Dynamic'],
    ['Kegunaan', 'Enterprise', 'Web, Full-stack'],
  ],
  quoted,
  { headerText: 'Perbandingan:', footer: 'Semoga membantu!' }
)

// List
await sock.sendList(
  jid,
  'Info Bot',
  [
    ['Nama', 'Kanaraa AI'],
    ['Versi', '7.0.0'],
    ['Developer', 'kanaraa'],
  ],
  quoted,
  { footer: '© Kanaraa AI' }
)

// Code Block
await sock.sendCodeBlock(
  jid,
  `const salam = "Halo Dunia"
function kataSalam(nama) {
    return salam + " " + nama
}
kataSalam("Kanaraa")`,
  quoted,
  {
    language: 'javascript',
    title: 'Contoh Kode',
    footer: 'Powered by Kanaraa',
  }
)

Rich Message

// Teks & Markdown
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    text: `# Halo Dunia\n## GARA\n\n---\n\n=={ Yellow Text }==\n\n---\n\n[Google](https://google.com)\n\n[](https://openai.com)\n\n[Shiroko|1429|1897]<https://example.com/image.png>`,
  }
}, { quoted: m })

// Tip / Metadata Text
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    tip: 'Ini adalah text tip (Metadata Text)',
  }
}, { quoted: m })

// Produk
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    product: [
      {
        title: 'Nama Produk',
        brand: 'GARA',
        price: 'Rp 1000',
        sale_price: 'Rp 0',
        url: 'https://wa.me/628xxx',
        icon: 'https://example.com/icon.png',
        image: 'https://example.com/image.jpg',
      }
    ],
  }
}, { quoted: m })

// Code Block
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    code: {
      language: 'javascript',
      code: `class GARA {\n\tstatic hello() {\n\t\treturn 'Hello World';\n\t}\n}`,
    },
  }
}, { quoted: m })

// Tabel
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    table: [
      ['Nama', 'Role'],
      ['GARA', 'Developer'],
      ['Fiora Sylvie', 'Assistant'],
    ],
  }
}, { quoted: m })

// Source / Sumber
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    source: [
      ['https://example.com/favicon.jpg', 'https://github.com/kanaraa/', 'GitHub'],
      ['https://example.com/favicon.jpg', 'https://example.com/', 'Website'],
    ],
  }
}, { quoted: m })

// Gambar
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    image: 'https://example.com/image.jpg',
  }
}, { quoted: m })

// Video
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    video: 'https://example.com/video.mp4|10', // url|durasi(detik)
  }
}, { quoted: m })

// Reels
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    reels: [
      {
        username: 'GARA',
        profile_url: 'https://example.com/avatar.jpg',
        thumbnail: 'https://example.com/thumb.jpg',
        url: 'https://example.com/',
        title: 'Demo Reel',
        like: 12000,
        share: 500,
        view: 999999,
        source: 'IG',
        verified: true,
      }
    ],
  }
}, { quoted: m })

// Post
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    post: [
      {
        profile_url: 'https://example.com/avatar.jpg',
        username: 'GARA',
        title: 'Demo Post',
        subtitle: 'vøid',
        caption: 'Caption post disini.',
        verified: true,
        url: 'https://example.com/',
        thumbnail: 'https://example.com/thumb.jpg',
        source: 'INSTAGRAM',
        footer: 'vøid',
        deeplink: 'https://example.com/',
        icon: 'https://example.com/icon.jpg',
        orientation: 'LANDSCAPE',
        post_type: 'PHOTO',
        comment: 1,
        share: 1,
        like: 1,
      }
    ],
  }
}, { quoted: m })

// Suggest / Pill
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    suggest: ['GARA', 'vøid', 'Fiora Sylvie'],
  }
}, { quoted: m })

// Gabungan (video + tip + suggest + text)
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    video: 'https://example.com/video.mp4|10',
    tip: 'Ini adalah text tip',
    suggest: ['gara', 'kanaraa', 'yuuki'],
    text: `- [Beli Script](https://wa.me/628xxx)\n- [Sewa Bot](https://wa.me/628xxx)\n- [Support](https://wa.me/628xxx)`,
  }
}, { quoted: m })

// Footer Action / Click Button
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    text: 'Halo, silakan klik tombol di bawah untuk info lebih lanjut:',
    footerAction: {
      text: 'Kunjungi Website',
      url: 'https://kanara.my.id',
    }
  }
}, { quoted: m })

// Game (Embedded HTML WebView / Mini App)
// Catatan: nama/properti game bersifat opsional (default: '*Click to Play*')
await sock.sendMessage(jid, {
  richMessage: {
    title: 'vøid',
    game: 'Mainkan Game', // opsional: string judul pill tombol (atau tanpa 'game' jika hanya html)
    html: `<!DOCTYPE html>
<html>
<head><title>Mini App</title></head>
<body><h1>Hello World Game</h1></body>
</html>`,
  }
}, { quoted: m })

Metode Newsletter

await sock.newsletterFollow('id@newsletter')
await sock.newsletterUnfollow('id@newsletter')
await sock.newsletterMute('id@newsletter')
await sock.newsletterUnmute('id@newsletter')
await sock.newsletterCreate('Saluran Saya', 'Deskripsi')
await sock.newsletterUpdate('id@newsletter', { name: 'Nama Baru' })
const { subscribers } = await sock.newsletterSubscribers('id@newsletter')
await sock.newsletterMultipleFollow('id1@newsletter id2@newsletter')

Metode Grup

const meta = await sock.groupMetadata('[email protected]')
const grup = await sock.groupCreate('Grup Baru', ['[email protected]'])
await sock.groupLeave('[email protected]')
await sock.groupUpdateSubject('[email protected]', 'Nama Baru')
await sock.groupUpdateDescription('[email protected]', 'Deskripsi Baru')
await sock.groupParticipantsUpdate('[email protected]', ['[email protected]'], 'add')
const kode = await sock.groupInviteCode('[email protected]')
await sock.groupRevokeInvite('[email protected]')
await sock.groupSettingUpdate('[email protected]', 'announcement')

Metode Komunitas

const komunitas = await sock.communityCreate('Komunitas Kami', 'Deskripsi')
await sock.communityLinkGroup('[email protected]', '[email protected]')
await sock.communityUnlinkGroup('[email protected]', '[email protected]')
await sock.communityLeave('[email protected]')

Pengaturan Privasi

await sock.updateLastSeenPrivacy('all')       // 'all' | 'contacts' | 'nobody'
await sock.updateOnlinePrivacy('all')
await sock.updateProfilePicturePrivacy('contacts')
await sock.updateStatusPrivacy('contacts')
await sock.updateReadReceiptsPrivacy('all')   // 'all' | 'none'
await sock.updateGroupsAddPrivacy('all')
await sock.updateCallPrivacy('everyone')

Referensi Event

sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {})
sock.ev.on('creds.update', (update) => {})
sock.ev.on('messages.upsert', ({ messages, type }) => {})
sock.ev.on('messages.update', (updates) => {})
sock.ev.on('messages.delete', (keys) => {})
sock.ev.on('messages.reaction', (reactions) => {})
sock.ev.on('groups.update', (updates) => {})
sock.ev.on('group-participants.update', (update) => {})
sock.ev.on('contacts.upsert', (contacts) => {})
sock.ev.on('contacts.update', (updates) => {})
sock.ev.on('chats.upsert', (chats) => {})
sock.ev.on('chats.update', (updates) => {})
sock.ev.on('call', (calls) => {})
sock.ev.on('newsletter.update', (updates) => {})
sock.ev.on('settings.update', (settings) => {})

Utilitas

import {
  // Auth
  useMultiFileAuthState,
  makeCacheableSignalKeyStore,
  initAuthCreds,
  BufferJSON,
  fetchLatestBaileysVersion,

  // JID
  jidEncode,
  jidDecode,
  jidNormalizedUser,
  areJidsSameUser,
  isJidGroup,
  isJidNewsletter,
  isJidBroadcast,

  // Koneksi
  DisconnectReason,
  Browsers,
} from '@kanaraa/baileys'

Repo dan seluruh kode di dalamnya dikelola oleh kanaraa. Gunakan sesuai kebutuhan proyekmu sendiri, dan pastikan penggunaannya tetap mengikuti Syarat Layanan WhatsApp.

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

@kanaraa/baileys

Modded Baileys v7 — Pesan Interaktif, AI Rich Response & More

Daftar Isi

Fitur

Persyaratan

Isi Package

Instalasi

Via Terminal (langsung)

Via package.json — Fork Baileys

Via Terminal — Non Fork (alias custom)

Menggunakan Alias (generic)

Quick Start

1. Setup Proyek

2. Install Dependensi

3. Buat index.js

4. Jalankan

5. Contoh Pairing Code

Membaca Pesan Pengguna

Setup Awal

Text Message

Image Message

Video Message

Audio Message

Document Message

Sticker Message

Location Message

Contact Message

Poll Message

Buttons Response Message

List Response Message

Template Button Reply Message

Interactive Response Message

Deteksi Pesan Reply (Quoted)

Download Media dari Pesan

Referensi API Socket

Koneksi & Autentikasi

Kirim Pesan

Pack Sticker (Sticker Pack)

PTV (Push-to-Video / Video Note)

Share / Request Nomor Telepon

Keep in Chat (Simpan Pesan)

Pin Pesan

Limit Sharing (Batasi Forward)

Scheduled Call (Jadwalkan Panggilan)

Group Invite (Undangan Grup)

Newsletter Admin Invite

Payment Invite

Order Status

Split Payment

Event Message

Poll Result Snapshot

Native Flow Message (Tombol Fleksibel)

Carousel Message

Cards (Carousel dengan helper)

Button Reply (Balas Tombol secara Programatis)

Pesan Interaktif

AI Rich Response

Rich Message

Metode Newsletter

Metode Grup

Metode Komunitas

Pengaturan Privasi

Referensi Event

Utilitas

3. Buat `index.js`