telegram

package

v0.5.0 Latest Latest Go to latest Published: Jul 15, 2026 License: MIT Imports: 8 Imported by: 0

Details

Package telegram provides a Telegram bot interface for Chronos agents.

This section is empty.

This section is empty.

This section is empty.

type Bot struct {
	// contains filtered or unexported fields
}

Bot is a Telegram bot that receives messages via long polling and routes them to an agent.

func New(token string, handler MessageHandler) *Bot

New creates a new Telegram bot. token is the Telegram Bot API token from @BotFather. handler is called for each incoming message.

func (b *Bot) SendInlineKeyboard(ctx context.Context, chatID int64, text string, buttons [][]Button) error

SendInlineKeyboard sends a message with an inline keyboard for HITL confirmations.

func (b *Bot) SendMessage(ctx context.Context, chatID int64, text string) error

SendMessage sends a text message to a Telegram chat.

func (b *Bot) Start(ctx context.Context) error

Start begins long polling for updates.

func (b *Bot) Stop()

Stop signals the bot to stop polling.

func (b *Bot) WebhookHandler() http.Handler

WebhookHandler returns an http.Handler for receiving Telegram webhook updates.

type Button struct {
	Text         string `json:"text"`
	CallbackData string `json:"callback_data"`
}

Button represents an inline keyboard button.

type MessageHandler func(ctx context.Context, chatID int64, userID int64, text string) (string, error)

MessageHandler processes incoming messages and returns a response.