mirror of https://github.com/tucnak/telebot
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
99 lines
3.0 KiB
Go
99 lines
3.0 KiB
Go
package telebot
|
|
|
|
// CallbackEndpoint is an interface any element capable
|
|
// of responding to a callback `\f<unique>`.
|
|
type CallbackEndpoint interface {
|
|
CallbackUnique() string
|
|
}
|
|
|
|
// Callback object represents a query from a callback button in an
|
|
// inline keyboard.
|
|
type Callback struct {
|
|
ID string `json:"id"`
|
|
|
|
// For message sent to channels, Sender may be empty
|
|
Sender *User `json:"from"`
|
|
|
|
// Message will be set if the button that originated the query
|
|
// was attached to a message sent by a bot.
|
|
Message *Message `json:"message"`
|
|
|
|
// MessageID will be set if the button was attached to a message
|
|
// sent via the bot in inline mode.
|
|
MessageID string `json:"inline_message_id"`
|
|
|
|
// Data associated with the callback button. Be aware that
|
|
// a bad client can send arbitrary data in this field.
|
|
Data string `json:"data"`
|
|
|
|
// ChatInstance is a global identifier, uniquely corresponding to
|
|
// the chat to which the message with the callback button was sent.
|
|
ChatInstance string `json:"chat_instance"`
|
|
|
|
// GameShortName is a unique identifier of the game for which a URL
|
|
// is requested from the bot when a user presses the Play button of
|
|
// that game. GameShortName may be empty
|
|
GameShortName string `json:"game_short_name"`
|
|
|
|
// Unique displays an unique of the button from which the
|
|
// callback was fired. Sets immediately before the handling,
|
|
// while the Data field stores only with payload.
|
|
Unique string `json:"-"`
|
|
}
|
|
|
|
// MessageSig satisfies Editable interface.
|
|
func (c *Callback) MessageSig() (string, int64) {
|
|
if c.IsInline() {
|
|
return c.MessageID, 0
|
|
}
|
|
return c.Message.MessageSig()
|
|
}
|
|
|
|
// IsInline says whether message is an inline message.
|
|
func (c *Callback) IsInline() bool {
|
|
return c.MessageID != ""
|
|
}
|
|
|
|
// CallbackResponse builds a response to a Callback query.
|
|
type CallbackResponse struct {
|
|
// The ID of the callback to which this is a response.
|
|
//
|
|
// Note: Telebot sets this field automatically!
|
|
CallbackID string `json:"callback_query_id"`
|
|
|
|
// Text of the notification. If not specified, nothing will be
|
|
// shown to the user.
|
|
Text string `json:"text,omitempty"`
|
|
|
|
// (Optional) If true, an alert will be shown by the client instead
|
|
// of a notification at the top of the chat screen. Defaults to false.
|
|
ShowAlert bool `json:"show_alert,omitempty"`
|
|
|
|
// (Optional) URL that will be opened by the user's client.
|
|
// If you have created a Game and accepted the conditions via
|
|
// @BotFather, specify the URL that opens your game.
|
|
//
|
|
// Note: this will only work if the query comes from a game
|
|
// callback button. Otherwise, you may use deep-linking:
|
|
// https://telegram.me/your_bot?start=XXXX
|
|
URL string `json:"url,omitempty"`
|
|
}
|
|
|
|
// CallbackUnique returns ReplyButton.Text.
|
|
func (t *ReplyButton) CallbackUnique() string {
|
|
return t.Text
|
|
}
|
|
|
|
// CallbackUnique returns InlineButton.Unique.
|
|
func (t *InlineButton) CallbackUnique() string {
|
|
return "\f" + t.Unique
|
|
}
|
|
|
|
// CallbackUnique implements CallbackEndpoint.
|
|
func (t *Btn) CallbackUnique() string {
|
|
if t.Unique != "" {
|
|
return "\f" + t.Unique
|
|
}
|
|
return t.Text
|
|
}
|