package telebot import "strconv" // Recipient is basically any possible endpoint you can send // messages to. It's usually a distinct user or a chat. type Recipient interface { // ID of user or group chat, @Username for channel Destination() string } // User object represents a Telegram user, bot // // object represents a group chat if Title is empty. type User struct { ID int `json:"id"` FirstName string `json:"first_name"` LastName string `json:"last_name"` Username string `json:"username"` } // Destination is internal user ID. func (u User) Destination() string { return strconv.Itoa(u.ID) } // Chat object represents a Telegram user, bot or group chat. // Title for channels and group chats // Type of chat, can be either “private”, “group”, "supergroup" or “channel” type Chat struct { ID int64 `json:"id"` Type string `json:"type"` Title string `json:"title"` FirstName string `json:"first_name"` LastName string `json:"last_name"` Username string `json:"username"` } // Destination is internal chat ID. func (c Chat) Destination() string { ret := "@" + c.Username if c.Type != "channel" { ret = strconv.FormatInt(c.ID, 10) } return ret } // IsGroupChat returns true if chat object represents a group chat. func (c Chat) IsGroupChat() bool { return c.Type != "private" } // Update object represents an incoming update. type Update struct { ID int `json:"update_id"` Payload *Message `json:"message"` // optional Callback *Callback `json:"callback_query"` Query *Query `json:"inline_query"` } // Thumbnail object represents an image/sticker of a particular size. type Thumbnail struct { File Width int `json:"width"` Height int `json:"height"` } // Photo object represents a photo with caption. type Photo struct { File Thumbnail Caption string } // Audio object represents an audio file (voice note). type Audio struct { File // Duration of the recording in seconds as defined by sender. Duration int `json:"duration"` // MIME type of the file as defined by sender. Mime string `json:"mime_type"` } // Document object represents a general file (as opposed to Photo or Audio). // Telegram users can send files of any type of up to 1.5 GB in size. type Document struct { File // Document thumbnail as defined by sender. Preview Thumbnail `json:"thumb"` // Original filename as defined by sender. FileName string `json:"file_name"` // MIME type of the file as defined by sender. Mime string `json:"mime_type"` } // Sticker object represents a WebP image, so-called sticker. type Sticker struct { File Width int `json:"width"` Height int `json:"height"` // Sticker thumbnail in .webp or .jpg format. Preview Thumbnail `json:"thumb"` } // Video object represents an MP4-encoded video. type Video struct { Audio Width int `json:"width"` Height int `json:"height"` // Text description of the video as defined by sender (usually empty). Caption string `json:"caption"` // Video thumbnail. Preview Thumbnail `json:"thumb"` } // KeyboardButton represents a button displayed on in a message. type KeyboardButton struct { Text string `json:"text"` URL string `json:"url,omitempty"` Data string `json:"callback_data,omitempty"` InlineQuery string `json:"switch_inline_query,omitempty"` } // InlineKeyboardMarkup represents an inline keyboard that appears right next // to the message it belongs to. type InlineKeyboardMarkup struct { // Array of button rows, each represented by an Array of KeyboardButton objects. InlineKeyboard [][]KeyboardButton `json:"inline_keyboard,omitempty"` } // Contact object represents a contact to Telegram user type Contact struct { UserID int `json:"user_id"` PhoneNumber string `json:"phone_number"` FirstName string `json:"first_name"` LastName string `json:"last_name"` } // Location object represents geographic position. type Location struct { Longitude float32 `json:"longitude"` Latitude float32 `json:"latitude"` } // 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 string `json:"data"` }