메뉴
High-level Telegram bot framework on top of gotd/td - router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Use as the starting point for any Telegram bot.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | goyacodedevutils-yatgbot |
| description | High-level Telegram bot framework on top of gotd/td - router/dispatcher with filters and middleware, FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Use as the starting point for any Telegram bot. |
Import path: github.com/YaCodeDev/GoYaCodeDevUtils/yatgbot.
High-level Telegram bot framework on top of gotd/td — router/dispatcher with filters and middleware,
FSM-aware routing, per-user localization, sequential-update scheduling, and a message-send queue. Wires
together yatgclient, yatgstorage, yafsm, yalocales, and yacache.
Options struct — all InitYaTgBot inputs: AppID/AppHash/BotToken/PoolDB/Cache/MainRouter/ParseMode/Log/Sync/Features/EmbeddedLocales/MessageQueueRatePerSecond/ForgetUpdatesOnStart.InitYaTgBot(ctx, *Options) (Dispatcher, yaerrors.Error) — one-call bootstrap: parses the bot token, sets up FSM storage, localizer, GORM+Redis session/state storage, the gotd client, connects, authorizes, and starts updates.Manager.Dispatcher struct — { FSMStore, Log, BotUser, MessageDispatcher, Localizer, Client, UpdatesErrors <-chan yatgclient.EntityError, MainRouter, Features } + Bind(tgDispatcher, sync bool).RouterGroup struct + NewRouterGroup(); router.OnMessage/OnCallback/OnEditMessage/OnDeleteMessage/OnNewChannelMessage/OnEditChannelMessage/OnDeleteChannelMessages/OnMessageReactions/OnChannelParticipant/OnPrecheckoutQuery/OnInlineQuery(handler, filters...); RouterGroup.IncludeRouter(subs...), AddMiddleware(mw...).Filter type + StateIs/TextEq/TextRegex/CallbackEq/CallbackPrefix/MessageServiceFilter/MessageServiceActionFilter[T]/OneOfFilter/AllOfFilter.HandlerData struct — per-handler deps: Entities, Client, Update, UserID, Peer, StateStorage, Log, Dispatcher, Localizer, JobResults.FeatureFlags (uint8) + const FeatureSequentialUpdates.ExtractMessageFromUpdate/ExtractMessageServiceFromUpdate(upd) (*tg.Message/*tg.MessageService, bool).FeatureSequentialUpdates ensures async updates sharing a user/chat key are processed in arrival order via an internal scheduler; Options.Sync = true forces fully synchronous (blocking) dispatch instead.ErrRouteMismatch to fall through (used internally by wrapHandler's type assertion).yacache (FSM + state storage), yafsm (per-user state), yalocales (per-user language via user.LangCode), yalogger, yatgclient (connection/auth), yatgmessageencoding (ParseMode), yatgstorage (session + updates.Manager state). Has an internal messagequeue subpackage not covered by its own skill.Module (fx.go) provides *Dispatcher, deferring InitYaTgBot to an fx.Lifecycle OnStart hook (needs a live context); OnStop tears the connection down.Index of every GoYaCodeDevUtils utility package (config, errors, logging, caching, rate limiting, backoff, hashing, gzip, RSA, feature flags, FSM, thread-safe collections, locales, Telegram bot stack) with a pointer to each package's own skill. Use before hand-rolling infrastructure code GoYaCodeDevUtils may already provide.
Thin wrapper around gotd/td's telegram.Client adding background-connect-with-retry, bot-token authorization, updates.Manager wiring, and SOCKS5/MTProto proxy helpers. Use for direct low-level Telegram client control instead of raw gotd/td.
Redis-backed persistence for gotd/td's updates.Manager state (pts/qts/seq/date via RedisJSON) plus channel/user access-hash bookkeeping, and a GORM/AES-encrypted session-storage layer. Use for any yatgclient/yatgbot state or session persistence.
Generic pluggable key-value cache abstraction with interchangeable in-memory and Redis backends, hash-oriented API. Use for any caching/session-store need instead of hand-rolling a map or a bare redis.Client call.
Loads JSON locale files into a nested key-tree with lookup, {placeholder} formatting, JSON serving, language-tag normalization, and Go-struct codegen. Use for any i18n/localization instead of hand-rolled JSON locale loading.
Bidirectional converter between a custom Markdown-like syntax and Telegram (gotd) rich-text MessageEntityClass formatting, with correct UTF-16LE offsets. Use as the ParseMode for any yatgbot/gotd-based bot.