Sources

callbackContentSource: CallbackContentSource - is used to store callback data that are longer than 64 characters.

chainSource: ChainSource - is used to store the current state of chains (next step, content for next step).

messageSource: MessageSource - is used to store the history of all messages.

telegramUserSource: TelegramUserSource - is used to store all users which send /start and blocks bot.

telegramChatSource: TelegramChatSource - is used to store all chats in which bot was added and bot was kicked.

telegramChatStatusEventSource: TelegramChatStatusEventSource - is used to store the history of all chat adding and kicking.

By default, everything is stored in memory and will become inaccessible after the application is terminated. It may be convenient for quick testing of bot's work.

val config = TelegramBotConfig().apply {
    messageSource = { MessageSource.empty }
    receiving {
        callbackContentSource = { CallbackContentSource.inMemory }
        chainSource = { ChainSource.inMemory }
        telegramUserSource = { TelegramUserSource.empty }
        telegramChatSource = { TelegramChatSource.empty }
        telegramChatStatusEventSource = { TelegramChatStatusEventSource.empty }
    }
}

How to save state in database see here.

You can create beans as ConfigExpression<..Source> also:

    @Bean
    fun telegramMessageSourceExpression(): ConfigExpression<MessageSource> = 
        ConfigExpression { CustomTelegramMessageSource() }

    @Bean
    fun chainSourceExpression(): ConfigExpression<ChainSource> = 
        ConfigExpression { CustomChainSource() }

    @Bean
    fun callbackContentSourceExpression(): ConfigExpression<CallbackContentSource> = 
        ConfigExpression { CustomCallbackContentSource() }

    @Bean
    fun telegramUserSourceExpression(): ConfigExpression<TelegramUserSource> =
        ConfigExpression { CustomTelegramUserSource() }

    @Bean
    fun telegramChatSourceExpression(): ConfigExpression<TelegramChatSource> = 
        ConfigExpression { CustomTelegramChatSource() }

    @Bean
    fun telegramChatStatusEventSourceExpression(): ConfigExpression<TelegramChatStatusEventSource> = 
        ConfigExpression { CustomTelegramChatStatusEventSource() }

Last modified: 23 February 2025