TextMessage Builder

TextMessage adalah builder untuk membangun pesan teks WhatsApp terformat (extendedTextMessage) dengan kontrol link preview, ad-reply banner, mention pengguna, dan kutipan pesan (quoted message).

---

Contoh Penggunaan Dasar

import { TextMessage } from 'leaves-guardian';

const pesanTeks = new TextMessage()
  .setBody('Halo {{nama}}, selamat datang di bot resmi Leaves Guardian!')
  .setVars({ nama: 'Rafa' });

await client.sendMessage(msg.chat.id, pesanTeks);

---

Daftar Method

Method	Keterangan
.setBody(text)	Mengatur isi teks utama (mendukung template variabel ).
.disableLinkPreview()	Menonaktifkan kartu preview URL otomatis jika teks berisi hyperlink.
.setLinkPreview(opts)	Mengatur kartu pratinjau tautan web tingkat lanjut (title, description, url, thumbnail, favicon, largerThumbnail).
.mention(jids)	Menambahkan satu atau kumpulan string WhatsApp JID ke dalam daftar mention.
.quote(msg)	Menempelkan konteks pesan yang dikutip (quoted reply).
.setAdReply(opts)	Menempelkan kartu preview tautan luar (external ad reply).
.setChannelForward(opts)	Menempelkan konteks penerusan saluran resmi (channel newsletter).
.build()	Mengompilasi dan mengembalikan objek payload mentah Baileys.
.send(jid, options)	Mengirimkan pesan langsung ke tujuan jika client di-pass ke constructor.

---

Contoh Pratinjau Tautan Web Tingkat Lanjut (Link Preview v0.4.0)

Fitur ini memungkinkan Anda mengirim tautan dengan thumbnail jernih beresolusi tinggi, judul kustom, deskripsi, hingga icon favicon resmi yang diunggah via MMS metadata:

import { TextMessage } from 'leaves-guardian';

const pesanTautan = new TextMessage(client)
  .setBody('Halo! Kunjungi dokumentasi lengkap kami di bawah ini:')
  .setLinkPreview({
    url: 'https://leavesguardian.enginelabs.my.id',
    title: 'Leaves Guardian Docs',
    description: 'Enterprise Baileys Wrapper & Infrastructure Library for Node.js',
    thumbnail: './assets/banner-docs.jpg',
    favicon: './assets/favicon.png',
    largerThumbnail: true
  });

await pesanTautan.send(msg.chat.id);

Menggunakan Helper withLinkPreview Langsung:

import { withLinkPreview } from 'leaves-guardian';

const payloadPreview = await withLinkPreview({
  url: 'https://github.com/ziakholder/Leaves-Guardian',
  title: 'GitHub Repository',
  description: 'Source code resmi Leaves Guardian',
  thumbnail: fs.readFileSync('./thumb.jpg')
}, client.getRawSocket());

---

Contoh Lengkap: Ad-Reply & Mention

import { TextMessage } from 'leaves-guardian';

const pesanTeks = new TextMessage(client)
  .setBody('Hai Kak @{{nomor}}! Silakan kunjungi dokumentasi resmi kami di https://leavesguardian.enginelabs.my.id')
  .setVars({ nomor: '628123456789' })
  .mention(['628123456789@s.whatsapp.net'])
  .quote(msg)
  .setAdReply({
    title: 'Leaves Guardian Docs',
    body: 'Enterprise Baileys Reliability Layer',
    thumbnailUrl: 'https://example.com/banner.jpg',
    sourceUrl: 'https://leavesguardian.enginelabs.my.id',
    previewType: 'PHOTO'
  });

await pesanTeks.send(msg.chat.id);

---

Navigasi Terkait

• Ringkasan Message Builders: Pengenalan arsitektur BaseBuilder.
• ButtonMessage Builder: Tombol aksi native flow.
• Skema Pesan Ternormalisasi: Format objek pesan ctx dan msg.