Business, Gifts, and Stories

BOTbot.*Business*

Business wrappers

Since1.2.0

ReturnsTelegram API result

These methods are Bot-level wrappers for connected business accounts, gifts, and story operations that do not belong to one incoming update.

Business account scope

Only call business methods when Telegram has provided a valid business connection or owned gift/story identifier for the account you are managing.

VibeGram exposes Telegram business account, gift, and story methods as typed Bot wrappers. Use them when your bot manages a connected business account or needs direct access outside a Context handler.

Business Account

import { Bot } from 'vibegram';

const bot = new Bot(process.env.BOT_TOKEN!);

await bot.setBusinessAccountName('business-connection-id', 'Acme Support');

await bot.setBusinessAccountGiftSettings('business-connection-id', true, {
    unlimited_gifts: true,
    limited_gifts: true,
    unique_gifts: true,
    premium_subscription: true,
});

Gifts

const gifts = await bot.getAvailableGifts();
const giftId = gifts.gifts[0]?.id;

if (giftId) {
    await bot.sendGift(123456789, giftId, {
        text: 'Thanks for your support!',
    });
}

const ownedGifts = await bot.getBusinessAccountGifts('business-connection-id', {
    limit: 10,
    sort_by_price: true,
});

Stories

await bot.postStory(
    'business-connection-id',
    { type: 'photo', photo: 'attach://launch-photo' },
    21600,
    {
        caption: 'Launch update',
        post_to_chat_page: true,
    }
);

For methods that are not wrapped yet, use bot.callApi() or ctx.telegram.callApi() with the official Telegram payload shape.