Metode Bot

CLASSnew Bot(token)

API instansi Bot

Since1.0.0

ReturnsBot

Metode level Bot tersedia di luar satu update dan dipakai untuk kontrol launch, registrasi webhook, panggilan Bot API langsung, menu command, plugin, dan wrapper bisnis.

Grup metode Bot

Mulai dari lifecycle, lalu lanjut ke routing dan wrapper Telegram API langsung.

Lifecycle

Mulai polling atau webhook dan hentikan proses secara graceful.

Buka lifecycle

Routing

Daftarkan middleware, command, listener, action, dan error handler global.

Buka routing

API bisnis

Panggil akun bisnis, hadiah, stories, dan wrapper API langsung.

Buka bisnis

Metode yang tersedia langsung di instansi Bot (tidak memerlukan Context).

Metode Instance

Metode	Deskripsi
bot.launch(opts?)	Mulai long-polling
bot.stop(reason?)	Hentikan polling dengan graceful
bot.handleUpdate(update)	Proses objek update mentah secara manual
bot.webhookCallback(secretToken?)	Buat handler webhook kompatibel Express
bot.callApi(method, params?)	Panggil metode API Telegram apa pun secara langsung
bot.validateWebAppData(initData, opts?)	Validasi initData Mini App
bot.getMe()	Ambil info bot
bot.setMyCommands(commands, extra?)	Set menu command
bot.getMyCommands(extra?)	Ambil daftar command
bot.deleteMyCommands(extra?)	Hapus menu command
bot.setWebhook(url, opts?)	Daftarkan webhook ke Telegram
bot.deleteWebhook(opts?)	Hapus webhook aktif
bot.getWebhookInfo()	Ambil info webhook aktif
bot.plugin(plugin)	Install plugin

Metode Routing

Diturunkan dari Composer:

Metode	Deskripsi
bot.use(middleware)	Daftarkan middleware
bot.command(name, handler)	Tangani pesan /command
bot.hears(trigger, handler)	Cocokkan pola teks
bot.on(event, handler)	Dengarkan tipe update
bot.action(trigger, handler)	Tangani klik tombol callback
bot.catch(handler)	Global error handler

Metode Akun Bisnis

Wrapper ini memakai nama payload resmi Telegram Bot API.

Metode	API
bot.getBusinessConnection(id)	getBusinessConnection
bot.readBusinessMessage(id, chatId, messageId)	readBusinessMessage
bot.deleteBusinessMessages(id, messageIds)	deleteBusinessMessages
bot.setBusinessAccountName(id, firstName, extra?)	setBusinessAccountName
bot.setBusinessAccountUsername(id, username?)	setBusinessAccountUsername
bot.setBusinessAccountBio(id, bio?)	setBusinessAccountBio
bot.setBusinessAccountProfilePhoto(id, photo, extra?)	setBusinessAccountProfilePhoto
bot.removeBusinessAccountProfilePhoto(id, extra?)	removeBusinessAccountProfilePhoto
bot.setBusinessAccountGiftSettings(id, showButton, acceptedTypes)	setBusinessAccountGiftSettings

Hadiah dan Stories

Metode	API
bot.getAvailableGifts()	getAvailableGifts
bot.sendGift(userId, giftId, extra?)	sendGift
bot.sendGiftToChat(chatId, giftId, extra?)	sendGift
bot.giftPremiumSubscription(userId, months, stars, extra?)	giftPremiumSubscription
bot.getUserGifts(userId, extra?)	getUserGifts
bot.getChatGifts(chatId, extra?)	getChatGifts
bot.getBusinessAccountGifts(id, extra?)	getBusinessAccountGifts
bot.upgradeGift(id, ownedGiftId, extra?)	upgradeGift
bot.transferGift(id, ownedGiftId, newOwnerChatId, extra?)	transferGift
bot.postStory(id, content, activePeriod, extra?)	postStory
bot.repostStory(id, fromChatId, fromStoryId, activePeriod, extra?)	repostStory
bot.editStory(id, storyId, content, extra?)	editStory
bot.deleteStory(id, storyId)	deleteStory

Panggilan API Langsung

Untuk metode yang belum tersedia sebagai shortcut di Context:

// Panggil metode API Telegram apa pun
const hasil = await bot.callApi('sendMessage', {
    chat_id: 123456,
    text: 'Halo dari callApi!',
});

// Set webhook
await bot.callApi('setWebhook', {
    url: 'https://domain.anda.com/webhook',
    secret_token: 'token-rahasia-saya',
});

// Forward pesan
await bot.callApi('forwardMessage', {
    chat_id: targetChatId,
    from_chat_id: sourceChatId,
    message_id: messageId,
});

Opsi Launch

await bot.launch({
    // Callback saat bot online
    onStart: me => {
        console.log(`@${me.username} online!`);
    },
    // Opsi polling tambahan
    dropPendingUpdates: true, // Abaikan update yang menumpuk saat restart
    allowedUpdates: ['message', 'callback_query'], // Filter jenis update
});

Plugin API

// Install plugin kelas
bot.plugin(new AnalyticsPlugin('https://analytics.example.com'));

// Install plugin fungsional
bot.plugin(greetingPlugin({ pesan: 'Halo!' }));

// Install preset (beberapa plugin sekaligus)
bot.plugin(produksiPreset);