@revizahoshii/baileys

v0.5.4

Published

16 days ago

Fork Baileys milik Reviza — pesan interaktif, album, newsletter, auto-follow saluran, dan panggilan suara (VoIP).

0High
0Medium
0Low

revizahoshii

automation baileys bot interactive-messages js-whatsapp multi-device whatsapp whatsapp-api whatsapp-bot whatsapp-web

Pustaka WhatsApp berbasis WebSockets untuk kebutuhan bot dan aplikasi Reviza.

Berasal dari Baileys (@whiskeysockets/baileys) dan disesuaikan dengan kebutuhan Reviza.

Daftar Isi

Nama Paket

@revizahoshii/baileys

Prasyarat

| Kebutuhan | Keterangan | |---|---| | Node.js 20 atau lebih baru | Wajib. Saat npm install, ada script preinstall (engine-requirements.js) yang akan menghentikan instalasi jika versi Node Anda di bawah 20. | | ESM | Paket ini "type": "module". Kalau project Anda CommonJS, pakai import() dinamis (lihat di bawah). | | pino | Untuk logger. Sudah ikut terpasang sebagai dependency. |

Instalasi

Dari registry npm:

npm install @revizahoshii/baileys

Langsung dari repository GitHub ini:

npm install github:revizahoshii-no/reviza-baileys

Lalu impor di kode Anda:

import makeWASocket from "@revizahoshii/baileys";

Di project CommonJS (require):

async function main() {
  const { default: makeWASocket } = await import("@revizahoshii/baileys");
  // ... lanjutkan di sini
}
main();

Cara Menghubungkan Akun

WhatsApp menyediakan API multi-device yang membuat paket ini bisa autentikasi sebagai perangkat WhatsApp kedua — pindai QR code atau pakai pairing code dari HP.

Lewat QR Code

[!IMPORTANT] Kode QR dikirim lewat event connection.update sebagai properti qr — ambil dari situ, jangan mengandalkan opsi printQRInTerminal (sudah deprecated, tidak mencetak QR).

import makeWASocket, { Browsers } from "@revizahoshii/baileys";

const sock = makeWASocket({
    browser: Browsers.ubuntu("Reviza App")
});

sock.ev.on("connection.update", ({ qr }) => {
    if (qr) console.log("Scan kode QR ini dengan WhatsApp Anda:\n", qr);
});

Pindai lewat WhatsApp → Perangkat Tertaut → Tautkan Perangkat, dan Anda langsung masuk.

Mau QR yang bisa dibaca mata (bukan string teks) di terminal? Tambahkan dependency kecil:

npm install qrcode-terminal

import qrcode from "qrcode-terminal";

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

Lewat Pairing Code

Pairing code dipakai kalau tidak bisa memindai QR (misalnya di server/VPS). Nomor tanpa +, (), atau - — awali dengan kode negara. Untuk Indonesia pakai 62.

import makeWASocket from "@revizahoshii/baileys";

const sock = makeWASocket({});

if (!sock.authState.creds.registered) {
    const nomor = "6281234567890";
    const kode = await sock.requestPairingCode(nomor);
    console.log("Masukkan kode ini di WhatsApp:", kode);
}

Anda juga bisa menentukan kode sendiri, dengan syarat panjangnya harus pas 8 karakter:

const kode = await sock.requestPairingCode("6281234567890", "REVIZA01");

Kalau panjangnya bukan 8, akan error: Custom pairing code must be exactly 8 chars.

Menyimpan & Memulihkan Sesi

Supaya tidak perlu memindai QR berulang kali, simpan kredensial ke folder:

import makeWASocket, { useMultiFileAuthState } from "@revizahoshii/baileys";

const { state, saveCreds } = await useMultiFileAuthState("auth_info_reviza");

const sock = makeWASocket({
    auth: state         // perhatikan: namanya `auth`, bukan `authState`
});

// dipanggil setiap kali kredensial diperbarui
sock.ev.on("creds.update", saveCreds);

[!WARNING] Folder auth_info_reviza berisi kunci sesi akun WhatsApp Anda. Siapa pun yang memegang folder itu bisa mengambil alih sesi. Jangan pernah commit ke Git — tambahkan ke .gitignore:
auth_info_reviza/

Agar sesi makin awet dan tidak sering diminta pairing ulang, bungkus key store dengan cache:

import makeWASocket, { useMultiFileAuthState, makeCacheableSignalKeyStore } from "@revizahoshii/baileys";
import pino from "pino";

const logger = pino({ level: "silent" });
const { state, saveCreds } = await useMultiFileAuthState("auth_info_reviza");

const sock = makeWASocket({
    logger,
    auth: {
        creds: state.creds,
        keys: makeCacheableSignalKeyStore(state.keys, logger)
    }
});

sock.ev.on("creds.update", saveCreds);

Contoh Bot Lengkap

Ini pola dasar yang paling umum dipakai: tangkap pesan masuk, balas, tangani koneksi putus.

import makeWASocket, { DisconnectReason, useMultiFileAuthState } from "@revizahoshii/baileys";
import { Boom } from "@hapi/boom";

async function jalankanBot() {
    const { state, saveCreds } = await useMultiFileAuthState("auth_info_reviza");

    const sock = makeWASocket({
        auth: state
    });

    sock.ev.on("connection.update", (update) => {
        const { connection, lastDisconnect, qr } = update;

        if (qr) console.log("Scan kode QR ini:", qr);

        if (connection === "close") {
            const logout = lastDisconnect?.error
                ? new Boom(lastDisconnect.error)?.output?.statusCode === DisconnectReason.loggedOut
                : false;

            console.log("Koneksi tertutup:", lastDisconnect?.error);
            // sambungkan lagi, kecuali Anda memang logout secara sadar
            if (!logout) jalankanBot();
        } else if (connection === "open") {
            console.log("Bot aktif!");
        }
    });

    sock.ev.on("messages.upsert", async ({ messages }) => {
        // selalu pakai loop: messages adalah array
        for (const m of messages) {
            if (m.key.fromMe) continue;                 // lewati pesan dari bot sendiri
            if (m.message?.protocolMessage) continue;   // lewati edit/hapus pesan

            const teks = m.message?.conversation
                || m.message?.extendedTextMessage?.text
                || "";

            console.log(`Pesan dari ${m.key.remoteJid}:`, teks);
            await sock.sendMessage(m.key.remoteJid, { text: "Halo dari Reviza Baileys!" });
        }
    });

    sock.ev.on("creds.update", saveCreds);
}

jalankanBot();

Mengirim Pesan

Semua jenis pesan dikirim lewat satu fungsi: sock.sendMessage(jid, konten, opsi).

Teks

await sock.sendMessage(nomor, { text: "halo apa kabar" });

Balas dengan quote

await sock.sendMessage(nomor, { text: "oke siap" }, { quoted: pesanMasuk });

Sebut (mention) pengguna

await sock.sendMessage(nomor, {
    text: "halo @6281234567890 👋",
    mentions: ["[email protected]"]
});

Gambar

// dari file
await sock.sendMessage(nomor, { image: { url: "./foto.jpg" }, caption: "caption di sini" });

// dari Buffer hasil unduhan
await sock.sendMessage(nomor, { image: buffer, caption: "langsung dari memori" });

Video, audio, dokumen, sticker, GIF

await sock.sendMessage(nomor, { video: { url: "./klip.mp4" }, caption: "video", gifPlayback: false });
await sock.sendMessage(nomor, { audio: { url: "./suara.mp3" }, ptt: true });   // ptt: true = voice note
await sock.sendMessage(nomor, { document: { url: "./kata-kata.pdf" }, fileName: "kata-kata.pdf" });
await sock.sendMessage(nomor, { sticker: "./stiker.webp" });
await sock.sendMessage(nomor, { video: { url: "./loop.mp4" }, gifPlayback: true });

View Once

await sock.sendMessage(nomor, { image: { url: "./rahasia.jpg" }, viewOnce: true });

Lokasi & Kontak

await sock.sendMessage(nomor, {
    location: { degreesLatitude: -3.5952, degreesLongitude: 97.6571 }  // Medan
});

const vcard =
    "BEGIN:VCARD\n" +
    "VERSION:3.0\n" +
    "FN:Reviza\n" +
    "TEL;type=CELL;type=VOICE;waid=6281234567890:+62 812-3456-7890\n" +
    "END:VCARD";

await sock.sendMessage(nomor, {
    contacts: { displayName: "Reviza", contacts: [{ vcard }] }
});

Reaksi, Poll, dan Maju (forward)

await sock.sendMessage(nomor, { react: { text: "🔥", key: pesanMasuk.key } });
await sock.sendMessage(nomor, { react: { text: "", key: pesanMasuk.key } });  // string kosong = hapus reaksi

await sock.sendMessage(nomor, {
    poll: { name: "Makan siang?", values: ["Nasi padang", "Soto", "Gado-gado"], selectableCount: 1 }
});

await sock.sendMessage(nomor, { forward: pesanMasuk });

[!TIP] Supaya tautan ikut menampilkan preview, pasang dependency opsionalnya:
npm install link-preview-js
Opsi generateHighQualityLinkPreview sudah aktif secara default, jadi tidak perlu di-set ulang — cukup kirim teks yang berisi URL:
await sock.sendMessage(nomor, { text: "lihat: https://example.com" });

Bentuk pesan khas Reviza

Tiga fitur tambahan di paket ini memakai bentuk payload sendiri — sudah diuji terhadap kode yang ter-publish, jadi ikuti persis seperti ini:

// album: array di tingkat atas, minimal 2 gambar/video (bukan { album: { messages: [...] } })
await sock.sendMessage(nomor, {
    caption: "liburan",
    album: [{ image: { url: "./a.jpg" } }, { video: { url: "./b.mp4" } }]
});

// quiz: lewat `poll` dengan `pollType: 1` + `correctAnswer` (bukan key `quiz`)
await sock.sendMessage(nomor, {
    poll: { name: "Kuis", values: ["Ai", "Ruby"], selectableCount: 1, pollType: 1, correctAnswer: "Ai" }
});

// list: `sections` di tingkat atas (bukan { list: { sections: [...] } })
await sock.sendMessage(nomor, {
    text: "Pilih menu", buttonText: "Menu", title: "Reviza Bot", footer: "ketuk di bawah",
    sections: [{ title: "Utama", rows: [{ rowId: "1", title: "Cek saldo" }] }]
});

Bentuk yang salah ditolak dengan pesan jelas, bukan crash: Invalid album type. Expected an array., Minimum provide 2 media to upload album message, No "correctAnswer" provided for quiz.

Menerima & Mengunduh Media

import { downloadMediaMessage } from "@revizahoshii/baileys";
import fs from "node:fs";

sock.ev.on("messages.upsert", async ({ messages }) => {
    for (const m of messages) {
        const media = m.message?.imageMessage
            || m.message?.videoMessage
            || m.message?.audioMessage
            || m.message?.documentMessage;

        if (!media) continue;

        const buffer = await downloadMediaMessage(m, "buffer", {}, {
            logger: sock.logger,
            reuploadRequest: sock.updateMediaMessage
        });

        fs.writeFileSync(`unduhan_${m.message.imageMessage ? "foto.jpg" : "media"}`, buffer);
    }
});

Butuh alurnya terpisah (unduh manual per konten)? Tersedia juga downloadContentFromMessage.

Mengelola Grup

// buat grup (array nomor)
const { id: jidGrup } = await sock.groupCreate("Ruang Reviza", [
    "[email protected]",
    "[email protected]"
]);

// info grup: nama, deskripsi, peserta
const meta = await sock.groupMetadata(jidGrup);
console.log(meta.subject, "| peserta:", meta.participants.length);

// tambah / keluarkan / naikkan-turunkan admin
await sock.groupParticipantsUpdate(jidGrup, ["[email protected]"], "add");
await sock.groupParticipantsUpdate(jidGrup, ["[email protected]"], "remove");
await sock.groupParticipantsUpdate(jidGrup, ["[email protected]"], "promote");
await sock.groupParticipantsUpdate(jidGrup, ["[email protected]"], "demote");

// ubah nama & deskripsi
await sock.groupUpdateSubject(jidGrup, "Nama Baru");
await sock.groupUpdateDescription(jidGrup, "Deskripsi grup");

// kunci grup (hanya admin yang bisa kirim)
await sock.groupSettingUpdate(jidGrup, "announcement");
await sock.groupSettingUpdate(jidGrup, "not_announcement");  // buka lagi

// pesan sementara (auto-delete)
await sock.groupToggleEphemeral(jidGrup, 7 * 24 * 3600);  // detik

Event yang Tersedia

Paket ini memakai gaya EventEmitter, jadi tinggal sock.ev.on(...):

| Event | Kapan terjadi | |---|---| | connection.update | Status koneksi berubah (open, close, QR menunggu) | | messages.upsert | Ada pesan baru | | messages.update | Pesan berubah (dibaca, diedit, dihapus, vote poll) | | messaging-history.set | Riwayat chat terkirim saat pertama kali sinkron | | chats.upsert / chats.update / chats.delete | Data chat berubah | | contacts.upsert / contacts.update | Data kontak berubah | | groups.upsert / groups.update | Informasi grup berubah | | group-participants.update | Ada yang masuk/keluar/di-promosi | | creds.update | Kredensial sesi perlu disimpan ulang | | presence.update | Ada yang sedang mengetik / online |

Contoh menangani peserta grup baru:

sock.ev.on("group-participants.update", async (event) => {
    if (event.action === "add") {
        await sock.sendMessage(event.id, { text: `Selamat datang @${event.participants[0].split("@")[0]}!`, mentions: event.participants });
    }
});

Fungsi Utilitas

Semua ini bisa diimpor langsung dari "@revizahoshii/baileys":

| Fungsi | Kegunaan | |---|---| | getContentType(pesan) | Tahu jenis isi pesan (imageMessage, conversation, dst.) | | getDevice(pesan) | Tahu perangkat pengirim (android, desktop, smba) | | normalizeMessageContent(m) | Buka bungkus pesan (viewOnce, ephemeral, album, dll.) jadi isi aslinya | | hasValidAlbumMedia / getAggregateResponsesInEventMessage | Tambahan khas fork ini | | jidDecode("[email protected]") | Pecah JID jadi { user, server, agent, device } | | jidNormalizedUser(jid) | Normalisasi JID (buang agent/device) | | isJidGroup / isJidBroadcast / isJidStatusBroadcast | Cek jenis JID | | downloadMediaMessage / downloadContentFromMessage | Unduh media | | prepareWAMessageMedia | Siapkan media sebelum dikirim (untuk kontrol penuh) | | generateWAMessageFromContent | Susun objek pesan mentah | | updateMediaMessage | Kirim ulang media yang habis masa berlakunya | | getAggregateVotesInPollMessage | Baca hasil vote poll | | useMultiFileAuthState / useSingleFileAuthState / useSqliteAuthState | Simpan sesi (folder / satu file / SQLite) | | makeCacheableSignalKeyStore | Cache kunci sesi (lebih cepat & lebih awet) | | initAuthCreds | Bikin kredensial kosong dari nol | | makeInMemoryStore | Penyimpanan chat/kontak sementara di memori | | useSqliteAuthState({ dbPath }) | Simpan sesi di SQLite (butuh better-sqlite3) | | Browsers | Pengaturan identitas perangkat (macOS, windows, ubuntu, android, baileys, appropriate) | | delay(ms) | Jeda (Promise) | | fetchLatestRevizaBaileysVersion() / fetchLatestWaWebVersion() | Ambil nomor versi WA untuk opsi version | | proto | Akses objek protokol WhatsApp (proto.Message, proto.WebMessageInfo) |

Penyimpanan di memori (praktis untuk bot kecil, boros RAM untuk pemakaian serius):

import makeWASocket, { makeInMemoryStore } from "@revizahoshii/baileys";

const store = makeInMemoryStore({});
store.readFromFile("./reviza_store.json");
setInterval(() => store.writeToFile("./reviza_store.json"), 10_000);

const sock = makeWASocket({});
store.bind(sock.ev);

sock.ev.on("chats.upsert", () => console.log(store.chats.all()));

Format ID WhatsApp (JID)

ID tujuan (disebut JID) wajib format [kode negara][nomor]@s.whatsapp.net:

| Untuk | Format | Contoh | |---|---|---| | Pengguna | [email protected] | [email protected] | | Grup | [email protected] | [email protected] | | Broadcast list | [waktu-dibuat]@broadcast | — | | Status/story | status@broadcast | — |

Nomor selalu pakai kode negara tanpa + (Indonesia → 62).

Panggilan Suara (VoIP)

Library ini bisa menelepon nomor WhatsApp dan memutar audio ke dalam panggilan itu — mirip bot musik di Discord. Cocok untuk fitur fake call atau pemutar musik lewat telepon WA.

Prasyarat tambahan

ffmpeg wajib terpasang di server/PC Anda — dipakai untuk mengubah file audio menjadi PCM yang bisa dikirim ke panggilan.

# Ubuntu / Debian / VPS
sudo apt install ffmpeg

# Termux
pkg install ffmpeg

Cek berhasil: ffmpeg -version.

Cara pakai

VoipClient dipakai menempel pada socket yang sudah tersambung, jadi akun harus sudah login lebih dulu.

import makeWASocket, { useMultiFileAuthState, VoipClient } from "@revizahoshii/baileys";

const { state, saveCreds } = await useMultiFileAuthState("./auth");
const sock = makeWASocket({ auth: state });
sock.ev.on("creds.update", saveCreds);

sock.ev.on("connection.update", async ({ connection }) => {
  if (connection !== "open") return;

  const voip = new VoipClient();
  await voip.connectWithSocket(sock);

  const call = await voip.call("6281234567890", {
    durationMs: 30_000,        // telepon otomatis ditutup setelah 30 detik
    audioSource: "./lagu.mp3", // audio yang diputar ke lawan bicara
  });

  call.on("ringing",   () => console.log("HP tujuan berdering..."));
  call.on("connected", () => console.log("Panggilan diangkat, musik diputar"));
  call.on("ended",     (alasan) => console.log("Panggilan selesai:", alasan));

  await call.waitForEnd();
  voip.disconnect();
});

Pilihan `audioSource`

| Nilai | Artinya | |---|---| | "silence" | Default. Tidak ada suara — murni fake call. | | "./lagu.mp3" | Putar file audio dari disk (format apa pun yang didukung ffmpeg). | | "https://..." | Putar audio langsung dari URL streaming. | | "lavfi:sine=frequency=440" | Nada buatan lewat filter ffmpeg. |

Method dan event

| Anggota | Kegunaan | |---|---| | new VoipClient() | Membuat klien VoIP. | | voip.connectWithSocket(sock) | Menempel ke socket yang sudah login. Wajib dipanggil dulu. | | voip.call(nomor, opsi) | Memulai panggilan, mengembalikan objek ActiveCall. | | voip.disconnect() | Menutup semua dan melepas memori. | | call.end() | Menutup panggilan lebih awal. | | call.mute(true) | Membisukan mikrofon. | | call.waitForEnd() | await sampai panggilan berakhir. | | call.state | Status saat ini (lihat CallState). | | Event ringing | HP tujuan mulai berdering. | | Event connected | Panggilan diangkat. | | Event audio | Menerima PCM suara dari lawan bicara. | | Event ended | Panggilan berakhir, membawa alasannya. |

CallState berisi: Idle Calling PreacceptReceived ReceivedCall AcceptSent AcceptReceived Active ActiveElsewhere Ending.

Catatan penting

Nomor tujuan ditulis tanpa @s.whatsapp.net — cukup 6281234567890.
Panggilan berjalan dari akun yang sedang login, jadi tercatat di riwayat telepon WhatsApp akun tersebut.
Modul ini memuat mesin WASM ±9,8 MB saat pertama dipakai. Wajar kalau panggilan pertama sedikit lebih lambat.
Jangan dipakai untuk spam telepon — akun berisiko diblokir WhatsApp.

Kontak & Channel Reviza

Semua tautan di bawah ini diambil dari situs resmi Reviza: https://revizayowa.biz.id/

| Kanal | Tautan | |---|---| | WhatsApp (Admin) | https://wa.me/628978595858 | | Telegram | https://t.me/zayuyoo | | Instagram | https://instagram.com/Always_revizaa | | TikTok | https://www.tiktok.com/@reviza4ever | | YouTube | https://www.youtube.com/@reviza4ever | | Discord | https://discord.gg/7Nn352cN9b | | Grup WhatsApp | https://chat.whatsapp.com/BW0zgEgEPUOI5Arb80RWG0 | | Dukungan (Saweria) | https://saweria.co/REVIZAHOSHI |

Saluran (Channel) WhatsApp Reviza

| Nama saluran | Kode undangan | JID untuk dipakai via library | |---|---|---| | Preset AM / Saluran preset | https://whatsapp.com/channel/0029Vb7xLulDJ6GrrJGtU51t | 120363426118421279@newsletter | | Info Channel | https://whatsapp.com/channel/0029VbBc5ak3AzNL2pXnJJ1u | 120363423129630445@newsletter |

JID di atas berguna kalau Anda mengirim atau menjadwalkan konten ke saluran lewat sock.sendMessage(jid, ...).

Auto-follow saluran

Saat koneksi berhasil terbuka (connection === 'open'), socket otomatis mengikuti dua saluran di atas lewat newsletterFollow(). Perilaku ini hanya sekali per proses — reconnect tidak mengirim ulang permintaan join. Hasilnya dicatat ke log pada level info, jadi bisa Anda lihat langsung:

{"level":30,...,"jid":"...@newsletter","msg":"sukses follow saluran Reviza"}
{"level":30,...,"jid":"...@newsletter","alasan":409,"msg":"follow saluran Reviza dilewati"}

alasan: 409 artinya sudah pernah ikut, 429/503 artinya sedang dibatasi sementara. Keduanya tidak menghentikan bot.

// matikan kalau tidak dipakai
const sock = makeWASocket({ auth: state, autoFollowSaluran: false });

// atau ganti daftarnya
const sock2 = makeWASocket({ auth: state, autoFollowSaluran: ["1234...@newsletter"] });

Kepemilikan & Identitas Proyek

Paket ini adalah proyek pribadi Reviza, dikemas untuk kebutuhan bot dan aplikasinya sendiri.

| Aspek | Keterangan | |---|---| | Nama paket | @revizahoshii/baileys | | Versi | 0.3.18-final | | Pemegang hak cipta | Reviza — © 2026 (lihat LICENSE) | | Penulis di package.json | author: "Reviza" | | Lisensi | MIT | | Rumah proyek | https://github.com/revizahoshii-no/reviza-baileys | | Kontak & kanal | lihat Kontak & Channel Reviza |

Jejak perubahan Reviza di dalam source. Fork ini bukan cuma ganti nama: ada 80 penanda Reviza@Changes / Reviza@Note tersebar di 12 file lib/, tercatat sejak 30-01-26. Kebanyakan menambah jenis & opsi pesan yang tidak ada di Baileys upstream:

album, quiz (khusus saluran), poll result snapshot, poll update, reaction/receipt update
request payment, invoice, order, groupStatus, spoiler, ephemeral, viewOnceV2, lottieSticker, futureProofMessage, interactiveAsTemplate, native flow
single_select shortcut, validasi hasValidAlbumMedia / hasValidCarouselHeader, getAggregateResponsesInEventMessage, normalizeMessageContent
lapisan rich message (lib/Utils/rich-message-utils.js, bertanda [WIP]), useSingleFileAuthState dengan LRUCache + mutex, perbaikan newsletter (/m1/, thumbnail server, additionalNodes), newsletterSubscribed, pengurangan pemakaian RSS, lib/Store/make-in-memory-store.js ([WIP])

Perlu Anda ketahui sebelum pakai: ada nilai DONATE_URL = "https://saweria.co/REVIZAHOSHI" di lib/Defaults/index.js yang dipakai sebagai nilai cadangan pada tiga tempat:

| Kondisi | Yang terjadi | |---|---| | externalAdReply dikirim tanpa url | url diisi DONATE_URL | | offerText diisi tapi offerUrl kosong | tombol offer menunjuk DONATE_URL (teks offer jatuh ke LIBRARY_NAME, yaitu @revizahoshii/baileys) | | richResponseMessage punya link tanpa url | memakai DONATE_URL, label sumbernya "Donate" / "Saweria" |

Semuanya hanya kena kalau field-nya memang kosong — kirim url sendiri dan tidak ada yang berubah.

Yang tetap milik upstream: basis kode Baileys, protokol WAProto/, implementasi Signal, dan seluruh dependency di package.json. Tidak ada klaim kepemilikan atas bagian ini — karena itu LICENSE MIT dibiarkan utuh beserta pemberitahuan hak ciptanya.

Lisensi

Ketentuan lisensi dan pemberitahuan hak cipta yang diwajibkan oleh komponen sumber tetap tersedia di file LICENSE. File tersebut tidak dihapus atau diubah.

Catatan

Jangan menghapus file LICENSE ketika menyalin atau menggunakan paket ini apabila ketentuan lisensinya mewajibkan pemberitahuan tersebut tetap disertakan.

Kutipan bercentang biru tanpa akun terverifikasi

Menampilkan header WhatsApp Business (centang biru) · Status pada balasan bot, lengkap dengan foto pada avatar kutipan, sambil tetap mempertahankan tombol saluran dan externalAdReply milikmu.

Dua hal yang bekerja terpisah:

Lencana centang berasal dari participant. Klien WhatsApp menggambar lencana untuk JID sistem [email protected] dari daftar bawaan aplikasi, bukan dari pengecekan sertifikat ke server. Akun yang menjalankan bot tidak perlu terverifikasi.
Avatar bulat berasal dari baris TEL;waid= di dalam vcard. WhatsApp menarik foto profil nomor tersebut. Tanpa waid, avatar tampil abu-abu.

await sock.sendOfficialReply(jid, { text: 'Hasil HD IMAGE' }, {
  name: 'REVIZA DELUXE',
  waid: m.sender,
})

Isi waid dengan nomor pengguna yang menjalankan perintah agar avatarnya mengikuti foto profil mereka, atau satu nomor tetap agar avatarnya selalu sama.

Digabung dengan tombol saluran dan gambar besar

import { withOfficialQuote } from '@revizahoshii/baileys'

await sock.sendMessage(jid, withOfficialQuote(
  { text: 'Hasil HD IMAGE' },
  {
    name: 'REVIZA DELUXE',
    waid: m.sender,
    contextInfo: {
      forwardedNewsletterMessageInfo: {
        newsletterJid: '120363426118421279@newsletter',
        newsletterName: 'Komunitas Reviza D Kink',
        serverMessageId: 127,
      },
      externalAdReply: {
        title: 'HD IMAGE',
        body: 'Reply gambar yang mau dijernihkan',
        sourceUrl: 'https://revizayowa.biz.id/',
        mediaType: 1,
        renderLargerThumbnail: true,
      },
    },
  },
))

Tombol Lihat saluran tetap mengarah ke salurannmu sendiri.

| Opsi | Keterangan | |---|---| | name | Nama yang tampil pada kutipan. Default 'WhatsApp' | | waid | Nomor pemilik foto profil untuk avatar kutipan. Tanda plus dan spasi diabaikan | | participant | JID pengirim kutipan, penentu lencana. Default [email protected] | | contact | true (bawaan) kartu kontak, false teks biasa | | thumbnail | Buffer gambar. Bila diisi, kutipan memakai imageMessage dan waid diabaikan | | contextInfo | contextInfo tambahan, mis. saluran dan externalAdReply |

Pesan langsung tampil tanpa tombol Unduh

Sejak versi 0.5.1, pesan AI Rich otomatis menyertakan messageSecret sehingga langsung tampil di perangkat penerima. Sebelumnya WhatsApp menampilkan peringatan "WhatsApp tidak dapat memastikan pesan ini aman" beserta tombol Unduh, karena pustaka ini mengirim verificationMetadata berisi sertifikat acak yang gagal divalidasi.

Tidak ada yang perlu kamu ubah — perilaku ini aktif secara bawaan.

Bila tetap ingin mengirim verificationMetadata seperti versi lama:

await sock.sendMessage(jid, {
  contentText: 'Halo!',
  fakeVerification: true,
})

Kamu juga bisa menentukan messageSecret sendiri:

await sock.sendMessage(jid, {
  contentText: 'Halo!',
  messageSecret: Buffer.alloc(32),
})

Balasan Bercentang Biru (Verified Reply)

Membuat balasan bot tampil seolah mengutip pesan dari saluran terverifikasi, sehingga muncul lencana centang biru pada kutipan. Tersedia preset WhatsApp, Meta AI, dan saluran custom milikmu sendiri.

Cara tercepat

Helper ini otomatis terpasang pada socket:

await sock.sendVerifiedReply(jid, { text: 'Halo!' }, { preset: 'whatsapp' })
await sock.sendVerifiedReply(jid, { text: 'Halo!' }, { preset: 'meta' })

Saluran custom

await sock.sendVerifiedReply(jid, { text: 'Halo!' }, {
  name: 'Reviza Official',
  jid: '120363420054181921@newsletter',
  text: 'Pesan dari saluran resmi',
})

Membungkus isi pesan sendiri

withVerifiedReply bisa dipakai pada jenis pesan apa pun (teks, gambar, video, dan lainnya):

import { withVerifiedReply } from '@revizahoshii/baileys'

await sock.sendMessage(jid, withVerifiedReply(
  { image: { url: './gambar.jpg' }, caption: 'Halo!' },
  { preset: 'meta' },
))

Sebagai objek `quoted`

import { createVerifiedQuote } from '@revizahoshii/baileys'

await sock.sendMessage(jid, { text: 'Halo' }, {
  quoted: createVerifiedQuote({ preset: 'whatsapp', text: 'Pemberitahuan resmi' }),
})

Opsi

| Opsi | Tipe | Keterangan | |---|---|---| | preset | 'whatsapp' | 'meta' | Identitas bawaan. Default 'whatsapp' | | name | string | Nama yang tampil pada kutipan (menimpa preset) | | jid | string | JID saluran, wajib berakhiran @newsletter (menimpa preset) | | text | string | Isi pesan yang seolah dikutip | | participant | string | Pengirim kutipan. Default [email protected] | | serverMessageId | number | ID pesan pada saluran. Diacak bila dikosongkan | | contentType | number | Lihat VerifiedContentType (UPDATE, UPDATE_CARD, LINK_CARD) | | quotedMessage | object | Pesan kutipan custom, menimpa text | | contextInfo | object | contextInfo tambahan yang digabungkan |

Fungsi yang tersedia

| Fungsi | Kegunaan | |---|---| | sock.sendVerifiedReply(jid, content, options, sendOptions) | Kirim langsung, cara paling singkat | | withVerifiedReply(content, options) | Bungkus isi pesan apa pun | | createVerifiedQuote(options) | Hasilkan objek quoted palsu | | buildVerifiedContextInfo(options) | Hasilkan contextInfo mentah | | buildVerifiedNewsletterInfo(options) | Hasilkan forwardedNewsletterMessageInfo saja | | bindVerifiedReply(sock) | Pasang manual ke socket (sudah otomatis) |

Fitur ini hanya mengubah tampilan kutipan di sisi penerima dan tidak memberi verifikasi resmi apa pun pada akunmu. Gunakan dengan bijak.

Repository

Sumber resmi proyek: https://github.com/revizahoshii-no/reviza-baileys

Contoh penggunaan di halaman ini diadaptasi dari dokumentasi Baileys (WhiskeySockets/Baileys) dan diterjemahkan serta disesuaikan ke @revizahoshii/baileys.

Kredit & Terima Kasih

Pustaka ini tidak berdiri sendiri — ia berdiri di atas kerja banyak pihak. Terima kasih sebesar-besarnya untuk semua fork dan pengembang Baileys yang karyanya mengalir ke @revizahoshii/baileys:

| Proyek / Pengembang | Peran | |---|---| | Baileys — Adhiraj Singh (adiwajshing) | Pustaka asal. Basis kode, protokol WAProto/, dan implementasi Signal berasal dari sini | | Baileys — WhiskeySockets | Kelanjutan resmi Baileys yang menjadi dasar fork ini | | ourin-baileys — zanpiww (@Zann) | Pengembang Ourin MD. Modul VoIP (panggilan suara / fake call + putar musik) di pustaka ini berasal dari ourin-baileys (Lisensi MIT) — terima kasih banyak, zanpiww | | reviza-baileys — Reviza | Proyek ini sendiri: penyesuaian, penambahan jenis & opsi pesan, dan pemeliharaan |

Tidak ada klaim kepemilikan atas bagian mana pun yang berasal dari proyek-proyek di atas. Pemberitahuan hak cipta dan ketentuan lisensinya tetap tersedia di file LICENSE.