package telebot // CallbackEndpoint is an interface any element capable // of responding to a callback `\f`. 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 }