// Package bot wraps the Telegram Bot API client (github.com/go-telegram/bot): it // runs the long-poll update loop — replying to /start (with an optional deep-link // payload) and any other message with a Mini App launch button — and sends the // notification and admin messages the connector requests. The bot token lives only // in this process. package bot import ( "context" "net/url" "strings" tgbot "github.com/go-telegram/bot" "github.com/go-telegram/bot/models" "go.uber.org/zap" ) // Config configures the bot wrapper. type Config struct { // Token is the Bot API token. Token string // APIBaseURL overrides the Bot API host ("" uses https://api.telegram.org). APIBaseURL string // TestEnv routes requests to the Bot API test environment. TestEnv bool // MiniAppURL is the base URL of the Mini App launch button. MiniAppURL string } // Bot wraps a Telegram Bot API client and the Mini App launch URL. type Bot struct { api *tgbot.Bot miniAppURL string log *zap.Logger } // New builds the bot wrapper, registering the /start handler and a default handler // that both reply with a Mini App launch button. It does not start polling; call // Run for that. func New(cfg Config, log *zap.Logger) (*Bot, error) { if log == nil { log = zap.NewNop() } t := &Bot{miniAppURL: cfg.MiniAppURL, log: log} opts := []tgbot.Option{ tgbot.WithDefaultHandler(t.handleStart), tgbot.WithMessageTextHandler("/start", tgbot.MatchTypePrefix, t.handleStart), } if cfg.TestEnv { // Route to the Bot API test environment (.../bot/test/METHOD). opts = append(opts, tgbot.UseTestEnvironment()) } if cfg.APIBaseURL != "" { opts = append(opts, tgbot.WithServerURL(cfg.APIBaseURL)) } api, err := tgbot.New(cfg.Token, opts...) if err != nil { return nil, err } t.api = api return t, nil } // Run sets the bot commands and the Mini App menu button, then blocks on the // long-poll update loop until ctx is cancelled. func (t *Bot) Run(ctx context.Context) { if _, err := t.api.SetMyCommands(ctx, &tgbot.SetMyCommandsParams{ Commands: []models.BotCommand{{Command: "start", Description: "Open Scrabble"}}, }); err != nil { t.log.Warn("set commands failed", zap.Error(err)) } if _, err := t.api.SetChatMenuButton(ctx, &tgbot.SetChatMenuButtonParams{ MenuButton: models.MenuButtonWebApp{ Type: models.MenuButtonTypeWebApp, Text: "Play", WebApp: models.WebAppInfo{URL: t.miniAppURL}, }, }); err != nil { t.log.Warn("set menu button failed", zap.Error(err)) } t.api.Start(ctx) } // Notify sends a notification message with a Mini App launch button that opens the // app at startParam (empty opens the lobby). func (t *Bot) Notify(ctx context.Context, chatID int64, text, buttonText, startParam string) error { _, err := t.api.SendMessage(ctx, &tgbot.SendMessageParams{ ChatID: chatID, Text: text, ReplyMarkup: t.launchMarkup(buttonText, startParam), }) return err } // SendText sends a plain text message with no markup (admin use). func (t *Bot) SendText(ctx context.Context, chatID int64, text string) error { _, err := t.api.SendMessage(ctx, &tgbot.SendMessageParams{ChatID: chatID, Text: text}) return err } // handleStart replies to /start (with an optional deep-link payload) and to any // other message with a Mini App launch button. func (t *Bot) handleStart(ctx context.Context, api *tgbot.Bot, update *models.Update) { if update.Message == nil { return } startParam := startPayload(update.Message.Text) if _, err := api.SendMessage(ctx, &tgbot.SendMessageParams{ ChatID: update.Message.Chat.ID, Text: "Tap to open Scrabble.", ReplyMarkup: t.launchMarkup("Open Scrabble", startParam), }); err != nil { t.log.Warn("reply to start failed", zap.Error(err)) } } // launchMarkup builds the single-button inline keyboard that opens the Mini App at // startParam. func (t *Bot) launchMarkup(buttonText, startParam string) *models.InlineKeyboardMarkup { return &models.InlineKeyboardMarkup{ InlineKeyboard: [][]models.InlineKeyboardButton{{ {Text: buttonText, WebApp: &models.WebAppInfo{URL: t.launchURL(startParam)}}, }}, } } // launchURL appends the deep-link start parameter to the Mini App URL as a startapp // query parameter; an empty parameter returns the base URL unchanged. func (t *Bot) launchURL(startParam string) string { if startParam == "" { return t.miniAppURL } u, err := url.Parse(t.miniAppURL) if err != nil { return t.miniAppURL } q := u.Query() q.Set("startapp", startParam) u.RawQuery = q.Encode() return u.String() } // startPayload extracts the deep-link payload from a "/start " command; // any other text yields an empty payload (open the lobby). func startPayload(text string) string { const cmd = "/start" if !strings.HasPrefix(text, cmd) { return "" } return strings.TrimSpace(strings.TrimPrefix(text, cmd)) }