telegram

type Config struct {
	// InstanceID identifies this instance ("" for default, e.g. "alerts" for named).
	// Set automatically from the config key in telegram_instances.
	InstanceID string `yaml:"instance_id,omitempty"`

	// Token is the Telegram Bot API token (from @BotFather).
	Token string `yaml:"token"`

	// AllowedChats restricts which chat IDs the bot responds to.
	// Empty means respond to all chats.
	AllowedChats []int64 `yaml:"allowed_chats"`

	// RespondToGroups enables responding in group chats.
	RespondToGroups bool `yaml:"respond_to_groups"`

	// RespondToDMs enables responding in direct messages.
	RespondToDMs bool `yaml:"respond_to_dms"`

	// SendTyping sends "typing..." indicators while processing.
	SendTyping bool `yaml:"send_typing"`

	// ParseMode sets the default parse mode for outgoing messages ("HTML" or "Markdown").
	ParseMode string `yaml:"parse_mode"`

	// ReactionNotifications controls when user reactions are surfaced as system events.
	// "off" (default): ignore reactions
	// "own": only reactions to bot messages
	// "all": all reactions in allowed chats
	ReactionNotifications string `yaml:"reaction_notifications"`
}

type InlineButton struct {
	Text         string `json:"text"`
	CallbackData string `json:"callback_data,omitempty"`
	URL          string `json:"url,omitempty"`
	Style        string `json:"style,omitempty"` // "primary", "success", "danger", or ""
}

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

type TelegramAPIError struct {
	// Method is the Bot API method that failed (e.g. "sendMessage").
	Method string

	// HTTPStatus is the HTTP response status code.
	HTTPStatus int

	// ErrorCode is the Telegram-specific error code from the JSON response.
	ErrorCode int

	// Description is the human-readable error description from Telegram.
	Description string
}