package tgbotapi import ( "net/url" ) // NewMessage creates a new Message. // // chatID is where to send it, text is the message text. func NewMessage(chatID int64, text string) MessageConfig { return MessageConfig{ BaseChat: BaseChat{ ChatID: chatID, ReplyToMessageID: 0, }, Text: text, DisableWebPagePreview: false, } } // NewDeleteMessage creates a request to delete a message. func NewDeleteMessage(chatID int64, messageID int) DeleteMessageConfig { return DeleteMessageConfig{ ChatID: chatID, MessageID: messageID, } } // NewMessageToChannel creates a new Message that is sent to a channel // by username. // // username is the username of the channel, text is the message text. func NewMessageToChannel(username string, text string) MessageConfig { return MessageConfig{ BaseChat: BaseChat{ ChannelUsername: username, }, Text: text, } } // NewForward creates a new forward. // // chatID is where to send it, fromChatID is the source chat, // and messageID is the ID of the original message. func NewForward(chatID int64, fromChatID int64, messageID int) ForwardConfig { return ForwardConfig{ BaseChat: BaseChat{ChatID: chatID}, FromChatID: fromChatID, MessageID: messageID, } } // NewPhotoUpload creates a new photo uploader. // // chatID is where to send it, file is a string path to the file, // FileReader, or FileBytes. // // Note that you must send animated GIFs as a document. func NewPhotoUpload(chatID int64, file interface{}) PhotoConfig { return PhotoConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, File: file, UseExisting: false, }, } } // NewPhotoShare shares an existing photo. // You may use this to reshare an existing photo without reuploading it. // // chatID is where to send it, fileID is the ID of the file // already uploaded. func NewPhotoShare(chatID int64, fileID string) PhotoConfig { return PhotoConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, FileID: fileID, UseExisting: true, }, } } // NewAudioUpload creates a new audio uploader. // // chatID is where to send it, file is a string path to the file, // FileReader, or FileBytes. func NewAudioUpload(chatID int64, file interface{}) AudioConfig { return AudioConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, File: file, UseExisting: false, }, } } // NewAudioShare shares an existing audio file. // You may use this to reshare an existing audio file without // reuploading it. // // chatID is where to send it, fileID is the ID of the audio // already uploaded. func NewAudioShare(chatID int64, fileID string) AudioConfig { return AudioConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, FileID: fileID, UseExisting: true, }, } } // NewDocumentUpload creates a new document uploader. // // chatID is where to send it, file is a string path to the file, // FileReader, or FileBytes. func NewDocumentUpload(chatID int64, file interface{}) DocumentConfig { return DocumentConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, File: file, UseExisting: false, }, } } // NewDocumentShare shares an existing document. // You may use this to reshare an existing document without // reuploading it. // // chatID is where to send it, fileID is the ID of the document // already uploaded. func NewDocumentShare(chatID int64, fileID string) DocumentConfig { return DocumentConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, FileID: fileID, UseExisting: true, }, } } // NewStickerUpload creates a new sticker uploader. // // chatID is where to send it, file is a string path to the file, // FileReader, or FileBytes. func NewStickerUpload(chatID int64, file interface{}) StickerConfig { return StickerConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, File: file, UseExisting: false, }, } } // NewStickerShare shares an existing sticker. // You may use this to reshare an existing sticker without // reuploading it. // // chatID is where to send it, fileID is the ID of the sticker // already uploaded. func NewStickerShare(chatID int64, fileID string) StickerConfig { return StickerConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, FileID: fileID, UseExisting: true, }, } } // NewVideoUpload creates a new video uploader. // // chatID is where to send it, file is a string path to the file, // FileReader, or FileBytes. func NewVideoUpload(chatID int64, file interface{}) VideoConfig { return VideoConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, File: file, UseExisting: false, }, } } // NewVideoShare shares an existing video. // You may use this to reshare an existing video without reuploading it. // // chatID is where to send it, fileID is the ID of the video // already uploaded. func NewVideoShare(chatID int64, fileID string) VideoConfig { return VideoConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, FileID: fileID, UseExisting: true, }, } } // NewAnimationUpload creates a new animation uploader. // // chatID is where to send it, file is a string path to the file, // FileReader, or FileBytes. func NewAnimationUpload(chatID int64, file interface{}) AnimationConfig { return AnimationConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, File: file, UseExisting: false, }, } } // NewAnimationShare shares an existing animation. // You may use this to reshare an existing animation without reuploading it. // // chatID is where to send it, fileID is the ID of the animation // already uploaded. func NewAnimationShare(chatID int64, fileID string) AnimationConfig { return AnimationConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, FileID: fileID, UseExisting: true, }, } } // NewVideoNoteUpload creates a new video note uploader. // // chatID is where to send it, file is a string path to the file, // FileReader, or FileBytes. func NewVideoNoteUpload(chatID int64, length int, file interface{}) VideoNoteConfig { return VideoNoteConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, File: file, UseExisting: false, }, Length: length, } } // NewVideoNoteShare shares an existing video. // You may use this to reshare an existing video without reuploading it. // // chatID is where to send it, fileID is the ID of the video // already uploaded. func NewVideoNoteShare(chatID int64, length int, fileID string) VideoNoteConfig { return VideoNoteConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, FileID: fileID, UseExisting: true, }, Length: length, } } // NewVoiceUpload creates a new voice uploader. // // chatID is where to send it, file is a string path to the file, // FileReader, or FileBytes. func NewVoiceUpload(chatID int64, file interface{}) VoiceConfig { return VoiceConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, File: file, UseExisting: false, }, } } // NewVoiceShare shares an existing voice. // You may use this to reshare an existing voice without reuploading it. // // chatID is where to send it, fileID is the ID of the video // already uploaded. func NewVoiceShare(chatID int64, fileID string) VoiceConfig { return VoiceConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, FileID: fileID, UseExisting: true, }, } } // NewMediaGroup creates a new media group. Files should be an array of // two to ten InputMediaPhoto or InputMediaVideo. func NewMediaGroup(chatID int64, files []interface{}) MediaGroupConfig { return MediaGroupConfig{ ChatID: chatID, Media: files, } } // NewInputMediaPhoto creates a new InputMediaPhoto. func NewInputMediaPhoto(media string) InputMediaPhoto { return InputMediaPhoto{ BaseInputMedia{ Type: "photo", Media: media, }, } } // NewInputMediaVideo creates a new InputMediaVideo. func NewInputMediaVideo(media string) InputMediaVideo { return InputMediaVideo{ BaseInputMedia: BaseInputMedia{ Type: "video", Media: media, }, } } // NewInputMediaAnimation creates a new InputMediaAnimation. func NewInputMediaAnimation(media string) InputMediaAnimation { return InputMediaAnimation{ BaseInputMedia: BaseInputMedia{ Type: "animation", Media: media, }, } } // NewInputMediaAudio creates a new InputMediaAudio. func NewInputMediaAudio(media string) InputMediaAudio { return InputMediaAudio{ BaseInputMedia: BaseInputMedia{ Type: "audio", Media: media, }, } } // NewInputMediaDocument creates a new InputMediaDocument. func NewInputMediaDocument(media string) InputMediaDocument { return InputMediaDocument{ BaseInputMedia: BaseInputMedia{ Type: "document", Media: media, }, } } // NewContact allows you to send a shared contact. func NewContact(chatID int64, phoneNumber, firstName string) ContactConfig { return ContactConfig{ BaseChat: BaseChat{ ChatID: chatID, }, PhoneNumber: phoneNumber, FirstName: firstName, } } // NewLocation shares your location. // // chatID is where to send it, latitude and longitude are coordinates. func NewLocation(chatID int64, latitude float64, longitude float64) LocationConfig { return LocationConfig{ BaseChat: BaseChat{ ChatID: chatID, }, Latitude: latitude, Longitude: longitude, } } // NewVenue allows you to send a venue and its location. func NewVenue(chatID int64, title, address string, latitude, longitude float64) VenueConfig { return VenueConfig{ BaseChat: BaseChat{ ChatID: chatID, }, Title: title, Address: address, Latitude: latitude, Longitude: longitude, } } // NewChatAction sets a chat action. // Actions last for 5 seconds, or until your next action. // // chatID is where to send it, action should be set via Chat constants. func NewChatAction(chatID int64, action string) ChatActionConfig { return ChatActionConfig{ BaseChat: BaseChat{ChatID: chatID}, Action: action, } } // NewUserProfilePhotos gets user profile photos. // // userID is the ID of the user you wish to get profile photos from. func NewUserProfilePhotos(userID int) UserProfilePhotosConfig { return UserProfilePhotosConfig{ UserID: userID, Offset: 0, Limit: 0, } } // NewUpdate gets updates since the last Offset. // // offset is the last Update ID to include. // You likely want to set this to the last Update ID plus 1. func NewUpdate(offset int) UpdateConfig { return UpdateConfig{ Offset: offset, Limit: 0, Timeout: 0, } } // NewWebhook creates a new webhook. // // link is the url parsable link you wish to get the updates. func NewWebhook(link string) WebhookConfig { u, _ := url.Parse(link) return WebhookConfig{ URL: u, } } // NewWebhookWithCert creates a new webhook with a certificate. // // link is the url you wish to get webhooks, // file contains a string to a file, FileReader, or FileBytes. func NewWebhookWithCert(link string, file interface{}) WebhookConfig { u, _ := url.Parse(link) return WebhookConfig{ URL: u, Certificate: file, } } // NewInlineQueryResultArticle creates a new inline query article. func NewInlineQueryResultArticle(id, title, messageText string) InlineQueryResultArticle { return InlineQueryResultArticle{ Type: "article", ID: id, Title: title, InputMessageContent: InputTextMessageContent{ Text: messageText, }, } } // NewInlineQueryResultArticleMarkdown creates a new inline query article with Markdown parsing. func NewInlineQueryResultArticleMarkdown(id, title, messageText string) InlineQueryResultArticle { return InlineQueryResultArticle{ Type: "article", ID: id, Title: title, InputMessageContent: InputTextMessageContent{ Text: messageText, ParseMode: "Markdown", }, } } // NewInlineQueryResultArticleHTML creates a new inline query article with HTML parsing. func NewInlineQueryResultArticleHTML(id, title, messageText string) InlineQueryResultArticle { return InlineQueryResultArticle{ Type: "article", ID: id, Title: title, InputMessageContent: InputTextMessageContent{ Text: messageText, ParseMode: "HTML", }, } } // NewInlineQueryResultGIF creates a new inline query GIF. func NewInlineQueryResultGIF(id, url string) InlineQueryResultGIF { return InlineQueryResultGIF{ Type: "gif", ID: id, URL: url, } } // NewInlineQueryResultMPEG4GIF creates a new inline query MPEG4 GIF. func NewInlineQueryResultMPEG4GIF(id, url string) InlineQueryResultMPEG4GIF { return InlineQueryResultMPEG4GIF{ Type: "mpeg4_gif", ID: id, URL: url, } } // NewInlineQueryResultPhoto creates a new inline query photo. func NewInlineQueryResultPhoto(id, url string) InlineQueryResultPhoto { return InlineQueryResultPhoto{ Type: "photo", ID: id, URL: url, } } // NewInlineQueryResultPhotoWithThumb creates a new inline query photo. func NewInlineQueryResultPhotoWithThumb(id, url, thumb string) InlineQueryResultPhoto { return InlineQueryResultPhoto{ Type: "photo", ID: id, URL: url, ThumbURL: thumb, } } // NewInlineQueryResultVideo creates a new inline query video. func NewInlineQueryResultVideo(id, url string) InlineQueryResultVideo { return InlineQueryResultVideo{ Type: "video", ID: id, URL: url, } } // NewInlineQueryResultAudio creates a new inline query audio. func NewInlineQueryResultAudio(id, url, title string) InlineQueryResultAudio { return InlineQueryResultAudio{ Type: "audio", ID: id, URL: url, Title: title, } } // NewInlineQueryResultVoice creates a new inline query voice. func NewInlineQueryResultVoice(id, url, title string) InlineQueryResultVoice { return InlineQueryResultVoice{ Type: "voice", ID: id, URL: url, Title: title, } } // NewInlineQueryResultDocument creates a new inline query document. func NewInlineQueryResultDocument(id, url, title, mimeType string) InlineQueryResultDocument { return InlineQueryResultDocument{ Type: "document", ID: id, URL: url, Title: title, MimeType: mimeType, } } // NewInlineQueryResultLocation creates a new inline query location. func NewInlineQueryResultLocation(id, title string, latitude, longitude float64) InlineQueryResultLocation { return InlineQueryResultLocation{ Type: "location", ID: id, Title: title, Latitude: latitude, Longitude: longitude, } } // NewEditMessageText allows you to edit the text of a message. func NewEditMessageText(chatID int64, messageID int, text string) EditMessageTextConfig { return EditMessageTextConfig{ BaseEdit: BaseEdit{ ChatID: chatID, MessageID: messageID, }, Text: text, } } // NewEditMessageCaption allows you to edit the caption of a message. func NewEditMessageCaption(chatID int64, messageID int, caption string) EditMessageCaptionConfig { return EditMessageCaptionConfig{ BaseEdit: BaseEdit{ ChatID: chatID, MessageID: messageID, }, Caption: caption, } } // NewEditMessageReplyMarkup allows you to edit the inline // keyboard markup. func NewEditMessageReplyMarkup(chatID int64, messageID int, replyMarkup InlineKeyboardMarkup) EditMessageReplyMarkupConfig { return EditMessageReplyMarkupConfig{ BaseEdit: BaseEdit{ ChatID: chatID, MessageID: messageID, ReplyMarkup: &replyMarkup, }, } } // NewHideKeyboard hides the keyboard, with the option for being selective // or hiding for everyone. func NewHideKeyboard(selective bool) ReplyKeyboardHide { log.Println("NewHideKeyboard is deprecated, please use NewRemoveKeyboard") return ReplyKeyboardHide{ HideKeyboard: true, Selective: selective, } } // NewRemoveKeyboard hides the keyboard, with the option for being selective // or hiding for everyone. func NewRemoveKeyboard(selective bool) ReplyKeyboardRemove { return ReplyKeyboardRemove{ RemoveKeyboard: true, Selective: selective, } } // NewKeyboardButton creates a regular keyboard button. func NewKeyboardButton(text string) KeyboardButton { return KeyboardButton{ Text: text, } } // NewKeyboardButtonContact creates a keyboard button that requests // user contact information upon click. func NewKeyboardButtonContact(text string) KeyboardButton { return KeyboardButton{ Text: text, RequestContact: true, } } // NewKeyboardButtonLocation creates a keyboard button that requests // user location information upon click. func NewKeyboardButtonLocation(text string) KeyboardButton { return KeyboardButton{ Text: text, RequestLocation: true, } } // NewKeyboardButtonRow creates a row of keyboard buttons. func NewKeyboardButtonRow(buttons ...KeyboardButton) []KeyboardButton { var row []KeyboardButton row = append(row, buttons...) return row } // NewReplyKeyboard creates a new regular keyboard with sane defaults. func NewReplyKeyboard(rows ...[]KeyboardButton) ReplyKeyboardMarkup { var keyboard [][]KeyboardButton keyboard = append(keyboard, rows...) return ReplyKeyboardMarkup{ ResizeKeyboard: true, Keyboard: keyboard, } } // NewInlineKeyboardButtonData creates an inline keyboard button with text // and data for a callback. func NewInlineKeyboardButtonData(text, data string) InlineKeyboardButton { return InlineKeyboardButton{ Text: text, CallbackData: &data, } } // NewInlineKeyboardButtonLoginURL creates an inline keyboard button with text // which goes to a LoginURL. func NewInlineKeyboardButtonLoginURL(text string, loginUrl LoginURL) InlineKeyboardButton { return InlineKeyboardButton{ Text: text, LoginURL: &loginUrl, } } // NewInlineKeyboardButtonLoginURL creates an inline keyboard button with text // which goes to a URL. func NewInlineKeyboardButtonURL(text, url string) InlineKeyboardButton { return InlineKeyboardButton{ Text: text, URL: &url, } } // NewInlineKeyboardButtonSwitch creates an inline keyboard button with // text which allows the user to switch to a chat or return to a chat. func NewInlineKeyboardButtonSwitch(text, sw string) InlineKeyboardButton { return InlineKeyboardButton{ Text: text, SwitchInlineQuery: &sw, } } // NewInlineKeyboardRow creates an inline keyboard row with buttons. func NewInlineKeyboardRow(buttons ...InlineKeyboardButton) []InlineKeyboardButton { var row []InlineKeyboardButton row = append(row, buttons...) return row } // NewInlineKeyboardMarkup creates a new inline keyboard. func NewInlineKeyboardMarkup(rows ...[]InlineKeyboardButton) InlineKeyboardMarkup { var keyboard [][]InlineKeyboardButton keyboard = append(keyboard, rows...) return InlineKeyboardMarkup{ InlineKeyboard: keyboard, } } // NewCallback creates a new callback message. func NewCallback(id, text string) CallbackConfig { return CallbackConfig{ CallbackQueryID: id, Text: text, ShowAlert: false, } } // NewCallbackWithAlert creates a new callback message that alerts // the user. func NewCallbackWithAlert(id, text string) CallbackConfig { return CallbackConfig{ CallbackQueryID: id, Text: text, ShowAlert: true, } } // NewInvoice creates a new Invoice request to the user. func NewInvoice(chatID int64, title, description, payload, providerToken, startParameter, currency string, prices []LabeledPrice) InvoiceConfig { return InvoiceConfig{ BaseChat: BaseChat{ChatID: chatID}, Title: title, Description: description, Payload: payload, ProviderToken: providerToken, StartParameter: startParameter, Currency: currency, Prices: prices} } // NewSetChatPhotoUpload creates a new chat photo uploader. // // chatID is where to send it, file is a string path to the file, // FileReader, or FileBytes. // // Note that you must send animated GIFs as a document. func NewSetChatPhotoUpload(chatID int64, file interface{}) SetChatPhotoConfig { return SetChatPhotoConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, File: file, UseExisting: false, }, } } // NewSetChatPhotoShare shares an existing photo. // You may use this to reshare an existing photo without reuploading it. // // chatID is where to send it, fileID is the ID of the file // already uploaded. func NewSetChatPhotoShare(chatID int64, fileID string) SetChatPhotoConfig { return SetChatPhotoConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ChatID: chatID}, FileID: fileID, UseExisting: true, }, } } // NewChatTitle allows you to update the title of a chat. func NewChatTitle(chatID int64, title string) SetChatTitleConfig { return SetChatTitleConfig{ ChatID: chatID, Title: title, } } // NewChatDescription allows you to update the description of a chat. func NewChatDescription(chatID int64, description string) SetChatDescriptionConfig { return SetChatDescriptionConfig{ ChatID: chatID, Description: description, } } // NewChatPhoto allows you to update the photo for a chat. func NewChatPhoto(chatID int64, photo interface{}) SetChatPhotoConfig { return SetChatPhotoConfig{ BaseFile: BaseFile{ BaseChat: BaseChat{ ChatID: chatID, }, File: photo, }, } } // NewDeleteChatPhoto allows you to delete the photo for a chat. func NewDeleteChatPhoto(chatID int64, photo interface{}) DeleteChatPhotoConfig { return DeleteChatPhotoConfig{ ChatID: chatID, } } // NewPoll allows you to create a new poll. func NewPoll(chatID int64, question string, options ...string) SendPollConfig { return SendPollConfig{ BaseChat: BaseChat{ ChatID: chatID, }, Question: question, Options: options, } } // NewStopPoll allows you to stop a poll. func NewStopPoll(chatID int64, messageID int) StopPollConfig { return StopPollConfig{ BaseEdit{ ChatID: chatID, MessageID: messageID, }, } }