all repos — telegram-bot-api @ 5781187bc20cbb9910ba867eafe318479be119b6

Golang bindings for the Telegram Bot API

helpers.go (view raw)

  1package tgbotapi
  2
  3import (
  4	"net/url"
  5)
  6
  7// NewMessage creates a new Message.
  8//
  9// chatID is where to send it, text is the message text.
 10func NewMessage(chatID int64, text string) MessageConfig {
 11	return MessageConfig{
 12		BaseChat: BaseChat{
 13			ChatID:           chatID,
 14			ReplyToMessageID: 0,
 15		},
 16		Text:                  text,
 17		DisableWebPagePreview: false,
 18	}
 19}
 20
 21// NewDeleteMessage creates a request to delete a message.
 22func NewDeleteMessage(chatID int64, messageID int) DeleteMessageConfig {
 23	return DeleteMessageConfig{
 24		ChatID:    chatID,
 25		MessageID: messageID,
 26	}
 27}
 28
 29// NewMessageToChannel creates a new Message that is sent to a channel
 30// by username.
 31//
 32// username is the username of the channel, text is the message text.
 33func NewMessageToChannel(username string, text string) MessageConfig {
 34	return MessageConfig{
 35		BaseChat: BaseChat{
 36			ChannelUsername: username,
 37		},
 38		Text: text,
 39	}
 40}
 41
 42// NewForward creates a new forward.
 43//
 44// chatID is where to send it, fromChatID is the source chat,
 45// and messageID is the ID of the original message.
 46func NewForward(chatID int64, fromChatID int64, messageID int) ForwardConfig {
 47	return ForwardConfig{
 48		BaseChat:   BaseChat{ChatID: chatID},
 49		FromChatID: fromChatID,
 50		MessageID:  messageID,
 51	}
 52}
 53
 54// NewPhotoUpload creates a new photo uploader.
 55//
 56// chatID is where to send it, file is a string path to the file,
 57// FileReader, or FileBytes.
 58//
 59// Note that you must send animated GIFs as a document.
 60func NewPhotoUpload(chatID int64, file interface{}) PhotoConfig {
 61	return PhotoConfig{
 62		BaseFile: BaseFile{
 63			BaseChat:    BaseChat{ChatID: chatID},
 64			File:        file,
 65			UseExisting: false,
 66		},
 67	}
 68}
 69
 70// NewPhotoShare shares an existing photo.
 71// You may use this to reshare an existing photo without reuploading it.
 72//
 73// chatID is where to send it, fileID is the ID of the file
 74// already uploaded.
 75func NewPhotoShare(chatID int64, fileID string) PhotoConfig {
 76	return PhotoConfig{
 77		BaseFile: BaseFile{
 78			BaseChat:    BaseChat{ChatID: chatID},
 79			FileID:      fileID,
 80			UseExisting: true,
 81		},
 82	}
 83}
 84
 85// NewAudioUpload creates a new audio uploader.
 86//
 87// chatID is where to send it, file is a string path to the file,
 88// FileReader, or FileBytes.
 89func NewAudioUpload(chatID int64, file interface{}) AudioConfig {
 90	return AudioConfig{
 91		BaseFile: BaseFile{
 92			BaseChat:    BaseChat{ChatID: chatID},
 93			File:        file,
 94			UseExisting: false,
 95		},
 96	}
 97}
 98
 99// NewAudioShare shares an existing audio file.
100// You may use this to reshare an existing audio file without
101// reuploading it.
102//
103// chatID is where to send it, fileID is the ID of the audio
104// already uploaded.
105func NewAudioShare(chatID int64, fileID string) AudioConfig {
106	return AudioConfig{
107		BaseFile: BaseFile{
108			BaseChat:    BaseChat{ChatID: chatID},
109			FileID:      fileID,
110			UseExisting: true,
111		},
112	}
113}
114
115// NewDocumentUpload creates a new document uploader.
116//
117// chatID is where to send it, file is a string path to the file,
118// FileReader, or FileBytes.
119func NewDocumentUpload(chatID int64, file interface{}) DocumentConfig {
120	return DocumentConfig{
121		BaseFile: BaseFile{
122			BaseChat:    BaseChat{ChatID: chatID},
123			File:        file,
124			UseExisting: false,
125		},
126	}
127}
128
129// NewDocumentShare shares an existing document.
130// You may use this to reshare an existing document without
131// reuploading it.
132//
133// chatID is where to send it, fileID is the ID of the document
134// already uploaded.
135func NewDocumentShare(chatID int64, fileID string) DocumentConfig {
136	return DocumentConfig{
137		BaseFile: BaseFile{
138			BaseChat:    BaseChat{ChatID: chatID},
139			FileID:      fileID,
140			UseExisting: true,
141		},
142	}
143}
144
145// NewStickerUpload creates a new sticker uploader.
146//
147// chatID is where to send it, file is a string path to the file,
148// FileReader, or FileBytes.
149func NewStickerUpload(chatID int64, file interface{}) StickerConfig {
150	return StickerConfig{
151		BaseFile: BaseFile{
152			BaseChat:    BaseChat{ChatID: chatID},
153			File:        file,
154			UseExisting: false,
155		},
156	}
157}
158
159// NewStickerShare shares an existing sticker.
160// You may use this to reshare an existing sticker without
161// reuploading it.
162//
163// chatID is where to send it, fileID is the ID of the sticker
164// already uploaded.
165func NewStickerShare(chatID int64, fileID string) StickerConfig {
166	return StickerConfig{
167		BaseFile: BaseFile{
168			BaseChat:    BaseChat{ChatID: chatID},
169			FileID:      fileID,
170			UseExisting: true,
171		},
172	}
173}
174
175// NewVideoUpload creates a new video uploader.
176//
177// chatID is where to send it, file is a string path to the file,
178// FileReader, or FileBytes.
179func NewVideoUpload(chatID int64, file interface{}) VideoConfig {
180	return VideoConfig{
181		BaseFile: BaseFile{
182			BaseChat:    BaseChat{ChatID: chatID},
183			File:        file,
184			UseExisting: false,
185		},
186	}
187}
188
189// NewVideoShare shares an existing video.
190// You may use this to reshare an existing video without reuploading it.
191//
192// chatID is where to send it, fileID is the ID of the video
193// already uploaded.
194func NewVideoShare(chatID int64, fileID string) VideoConfig {
195	return VideoConfig{
196		BaseFile: BaseFile{
197			BaseChat:    BaseChat{ChatID: chatID},
198			FileID:      fileID,
199			UseExisting: true,
200		},
201	}
202}
203
204// NewAnimationUpload creates a new animation uploader.
205//
206// chatID is where to send it, file is a string path to the file,
207// FileReader, or FileBytes.
208func NewAnimationUpload(chatID int64, file interface{}) AnimationConfig {
209	return AnimationConfig{
210		BaseFile: BaseFile{
211			BaseChat:    BaseChat{ChatID: chatID},
212			File:        file,
213			UseExisting: false,
214		},
215	}
216}
217
218// NewAnimationShare shares an existing animation.
219// You may use this to reshare an existing animation without reuploading it.
220//
221// chatID is where to send it, fileID is the ID of the animation
222// already uploaded.
223func NewAnimationShare(chatID int64, fileID string) AnimationConfig {
224	return AnimationConfig{
225		BaseFile: BaseFile{
226			BaseChat:    BaseChat{ChatID: chatID},
227			FileID:      fileID,
228			UseExisting: true,
229		},
230	}
231}
232
233// NewVideoNoteUpload creates a new video note uploader.
234//
235// chatID is where to send it, file is a string path to the file,
236// FileReader, or FileBytes.
237func NewVideoNoteUpload(chatID int64, length int, file interface{}) VideoNoteConfig {
238	return VideoNoteConfig{
239		BaseFile: BaseFile{
240			BaseChat:    BaseChat{ChatID: chatID},
241			File:        file,
242			UseExisting: false,
243		},
244		Length: length,
245	}
246}
247
248// NewVideoNoteShare shares an existing video.
249// You may use this to reshare an existing video without reuploading it.
250//
251// chatID is where to send it, fileID is the ID of the video
252// already uploaded.
253func NewVideoNoteShare(chatID int64, length int, fileID string) VideoNoteConfig {
254	return VideoNoteConfig{
255		BaseFile: BaseFile{
256			BaseChat:    BaseChat{ChatID: chatID},
257			FileID:      fileID,
258			UseExisting: true,
259		},
260		Length: length,
261	}
262}
263
264// NewVoiceUpload creates a new voice uploader.
265//
266// chatID is where to send it, file is a string path to the file,
267// FileReader, or FileBytes.
268func NewVoiceUpload(chatID int64, file interface{}) VoiceConfig {
269	return VoiceConfig{
270		BaseFile: BaseFile{
271			BaseChat:    BaseChat{ChatID: chatID},
272			File:        file,
273			UseExisting: false,
274		},
275	}
276}
277
278// NewVoiceShare shares an existing voice.
279// You may use this to reshare an existing voice without reuploading it.
280//
281// chatID is where to send it, fileID is the ID of the video
282// already uploaded.
283func NewVoiceShare(chatID int64, fileID string) VoiceConfig {
284	return VoiceConfig{
285		BaseFile: BaseFile{
286			BaseChat:    BaseChat{ChatID: chatID},
287			FileID:      fileID,
288			UseExisting: true,
289		},
290	}
291}
292
293// NewMediaGroup creates a new media group. Files should be an array of
294// two to ten InputMediaPhoto or InputMediaVideo.
295func NewMediaGroup(chatID int64, files []interface{}) MediaGroupConfig {
296	return MediaGroupConfig{
297		ChatID: chatID,
298		Media:  files,
299	}
300}
301
302// NewInputMediaPhoto creates a new InputMediaPhoto.
303func NewInputMediaPhoto(media string) InputMediaPhoto {
304	return InputMediaPhoto{
305		BaseInputMedia{
306			Type:  "photo",
307			Media: media,
308		},
309	}
310}
311
312// NewInputMediaVideo creates a new InputMediaVideo.
313func NewInputMediaVideo(media string) InputMediaVideo {
314	return InputMediaVideo{
315		BaseInputMedia: BaseInputMedia{
316			Type:  "video",
317			Media: media,
318		},
319	}
320}
321
322// NewInputMediaAnimation creates a new InputMediaAnimation.
323func NewInputMediaAnimation(media string) InputMediaAnimation {
324	return InputMediaAnimation{
325		BaseInputMedia: BaseInputMedia{
326			Type:  "animation",
327			Media: media,
328		},
329	}
330}
331
332// NewInputMediaAudio creates a new InputMediaAudio.
333func NewInputMediaAudio(media string) InputMediaAudio {
334	return InputMediaAudio{
335		BaseInputMedia: BaseInputMedia{
336			Type:  "audio",
337			Media: media,
338		},
339	}
340}
341
342// NewInputMediaDocument creates a new InputMediaDocument.
343func NewInputMediaDocument(media string) InputMediaDocument {
344	return InputMediaDocument{
345		BaseInputMedia: BaseInputMedia{
346			Type:  "document",
347			Media: media,
348		},
349	}
350}
351
352// NewContact allows you to send a shared contact.
353func NewContact(chatID int64, phoneNumber, firstName string) ContactConfig {
354	return ContactConfig{
355		BaseChat: BaseChat{
356			ChatID: chatID,
357		},
358		PhoneNumber: phoneNumber,
359		FirstName:   firstName,
360	}
361}
362
363// NewLocation shares your location.
364//
365// chatID is where to send it, latitude and longitude are coordinates.
366func NewLocation(chatID int64, latitude float64, longitude float64) LocationConfig {
367	return LocationConfig{
368		BaseChat: BaseChat{
369			ChatID: chatID,
370		},
371		Latitude:  latitude,
372		Longitude: longitude,
373	}
374}
375
376// NewVenue allows you to send a venue and its location.
377func NewVenue(chatID int64, title, address string, latitude, longitude float64) VenueConfig {
378	return VenueConfig{
379		BaseChat: BaseChat{
380			ChatID: chatID,
381		},
382		Title:     title,
383		Address:   address,
384		Latitude:  latitude,
385		Longitude: longitude,
386	}
387}
388
389// NewChatAction sets a chat action.
390// Actions last for 5 seconds, or until your next action.
391//
392// chatID is where to send it, action should be set via Chat constants.
393func NewChatAction(chatID int64, action string) ChatActionConfig {
394	return ChatActionConfig{
395		BaseChat: BaseChat{ChatID: chatID},
396		Action:   action,
397	}
398}
399
400// NewUserProfilePhotos gets user profile photos.
401//
402// userID is the ID of the user you wish to get profile photos from.
403func NewUserProfilePhotos(userID int) UserProfilePhotosConfig {
404	return UserProfilePhotosConfig{
405		UserID: userID,
406		Offset: 0,
407		Limit:  0,
408	}
409}
410
411// NewUpdate gets updates since the last Offset.
412//
413// offset is the last Update ID to include.
414// You likely want to set this to the last Update ID plus 1.
415func NewUpdate(offset int) UpdateConfig {
416	return UpdateConfig{
417		Offset:  offset,
418		Limit:   0,
419		Timeout: 0,
420	}
421}
422
423// NewWebhook creates a new webhook.
424//
425// link is the url parsable link you wish to get the updates.
426func NewWebhook(link string) WebhookConfig {
427	u, _ := url.Parse(link)
428
429	return WebhookConfig{
430		URL: u,
431	}
432}
433
434// NewWebhookWithCert creates a new webhook with a certificate.
435//
436// link is the url you wish to get webhooks,
437// file contains a string to a file, FileReader, or FileBytes.
438func NewWebhookWithCert(link string, file interface{}) WebhookConfig {
439	u, _ := url.Parse(link)
440
441	return WebhookConfig{
442		URL:         u,
443		Certificate: file,
444	}
445}
446
447// NewInlineQueryResultArticle creates a new inline query article.
448func NewInlineQueryResultArticle(id, title, messageText string) InlineQueryResultArticle {
449	return InlineQueryResultArticle{
450		Type:  "article",
451		ID:    id,
452		Title: title,
453		InputMessageContent: InputTextMessageContent{
454			Text: messageText,
455		},
456	}
457}
458
459// NewInlineQueryResultArticleMarkdown creates a new inline query article with Markdown parsing.
460func NewInlineQueryResultArticleMarkdown(id, title, messageText string) InlineQueryResultArticle {
461	return InlineQueryResultArticle{
462		Type:  "article",
463		ID:    id,
464		Title: title,
465		InputMessageContent: InputTextMessageContent{
466			Text:      messageText,
467			ParseMode: "Markdown",
468		},
469	}
470}
471
472// NewInlineQueryResultArticleHTML creates a new inline query article with HTML parsing.
473func NewInlineQueryResultArticleHTML(id, title, messageText string) InlineQueryResultArticle {
474	return InlineQueryResultArticle{
475		Type:  "article",
476		ID:    id,
477		Title: title,
478		InputMessageContent: InputTextMessageContent{
479			Text:      messageText,
480			ParseMode: "HTML",
481		},
482	}
483}
484
485// NewInlineQueryResultGIF creates a new inline query GIF.
486func NewInlineQueryResultGIF(id, url string) InlineQueryResultGIF {
487	return InlineQueryResultGIF{
488		Type: "gif",
489		ID:   id,
490		URL:  url,
491	}
492}
493
494// NewInlineQueryResultMPEG4GIF creates a new inline query MPEG4 GIF.
495func NewInlineQueryResultMPEG4GIF(id, url string) InlineQueryResultMPEG4GIF {
496	return InlineQueryResultMPEG4GIF{
497		Type: "mpeg4_gif",
498		ID:   id,
499		URL:  url,
500	}
501}
502
503// NewInlineQueryResultPhoto creates a new inline query photo.
504func NewInlineQueryResultPhoto(id, url string) InlineQueryResultPhoto {
505	return InlineQueryResultPhoto{
506		Type: "photo",
507		ID:   id,
508		URL:  url,
509	}
510}
511
512// NewInlineQueryResultPhotoWithThumb creates a new inline query photo.
513func NewInlineQueryResultPhotoWithThumb(id, url, thumb string) InlineQueryResultPhoto {
514	return InlineQueryResultPhoto{
515		Type:     "photo",
516		ID:       id,
517		URL:      url,
518		ThumbURL: thumb,
519	}
520}
521
522// NewInlineQueryResultVideo creates a new inline query video.
523func NewInlineQueryResultVideo(id, url string) InlineQueryResultVideo {
524	return InlineQueryResultVideo{
525		Type: "video",
526		ID:   id,
527		URL:  url,
528	}
529}
530
531// NewInlineQueryResultAudio creates a new inline query audio.
532func NewInlineQueryResultAudio(id, url, title string) InlineQueryResultAudio {
533	return InlineQueryResultAudio{
534		Type:  "audio",
535		ID:    id,
536		URL:   url,
537		Title: title,
538	}
539}
540
541// NewInlineQueryResultVoice creates a new inline query voice.
542func NewInlineQueryResultVoice(id, url, title string) InlineQueryResultVoice {
543	return InlineQueryResultVoice{
544		Type:  "voice",
545		ID:    id,
546		URL:   url,
547		Title: title,
548	}
549}
550
551// NewInlineQueryResultDocument creates a new inline query document.
552func NewInlineQueryResultDocument(id, url, title, mimeType string) InlineQueryResultDocument {
553	return InlineQueryResultDocument{
554		Type:     "document",
555		ID:       id,
556		URL:      url,
557		Title:    title,
558		MimeType: mimeType,
559	}
560}
561
562// NewInlineQueryResultLocation creates a new inline query location.
563func NewInlineQueryResultLocation(id, title string, latitude, longitude float64) InlineQueryResultLocation {
564	return InlineQueryResultLocation{
565		Type:      "location",
566		ID:        id,
567		Title:     title,
568		Latitude:  latitude,
569		Longitude: longitude,
570	}
571}
572
573// NewEditMessageText allows you to edit the text of a message.
574func NewEditMessageText(chatID int64, messageID int, text string) EditMessageTextConfig {
575	return EditMessageTextConfig{
576		BaseEdit: BaseEdit{
577			ChatID:    chatID,
578			MessageID: messageID,
579		},
580		Text: text,
581	}
582}
583
584// NewEditMessageCaption allows you to edit the caption of a message.
585func NewEditMessageCaption(chatID int64, messageID int, caption string) EditMessageCaptionConfig {
586	return EditMessageCaptionConfig{
587		BaseEdit: BaseEdit{
588			ChatID:    chatID,
589			MessageID: messageID,
590		},
591		Caption: caption,
592	}
593}
594
595// NewEditMessageReplyMarkup allows you to edit the inline
596// keyboard markup.
597func NewEditMessageReplyMarkup(chatID int64, messageID int, replyMarkup InlineKeyboardMarkup) EditMessageReplyMarkupConfig {
598	return EditMessageReplyMarkupConfig{
599		BaseEdit: BaseEdit{
600			ChatID:      chatID,
601			MessageID:   messageID,
602			ReplyMarkup: &replyMarkup,
603		},
604	}
605}
606
607// NewHideKeyboard hides the keyboard, with the option for being selective
608// or hiding for everyone.
609func NewHideKeyboard(selective bool) ReplyKeyboardHide {
610	log.Println("NewHideKeyboard is deprecated, please use NewRemoveKeyboard")
611
612	return ReplyKeyboardHide{
613		HideKeyboard: true,
614		Selective:    selective,
615	}
616}
617
618// NewRemoveKeyboard hides the keyboard, with the option for being selective
619// or hiding for everyone.
620func NewRemoveKeyboard(selective bool) ReplyKeyboardRemove {
621	return ReplyKeyboardRemove{
622		RemoveKeyboard: true,
623		Selective:      selective,
624	}
625}
626
627// NewKeyboardButton creates a regular keyboard button.
628func NewKeyboardButton(text string) KeyboardButton {
629	return KeyboardButton{
630		Text: text,
631	}
632}
633
634// NewKeyboardButtonContact creates a keyboard button that requests
635// user contact information upon click.
636func NewKeyboardButtonContact(text string) KeyboardButton {
637	return KeyboardButton{
638		Text:           text,
639		RequestContact: true,
640	}
641}
642
643// NewKeyboardButtonLocation creates a keyboard button that requests
644// user location information upon click.
645func NewKeyboardButtonLocation(text string) KeyboardButton {
646	return KeyboardButton{
647		Text:            text,
648		RequestLocation: true,
649	}
650}
651
652// NewKeyboardButtonRow creates a row of keyboard buttons.
653func NewKeyboardButtonRow(buttons ...KeyboardButton) []KeyboardButton {
654	var row []KeyboardButton
655
656	row = append(row, buttons...)
657
658	return row
659}
660
661// NewReplyKeyboard creates a new regular keyboard with sane defaults.
662func NewReplyKeyboard(rows ...[]KeyboardButton) ReplyKeyboardMarkup {
663	var keyboard [][]KeyboardButton
664
665	keyboard = append(keyboard, rows...)
666
667	return ReplyKeyboardMarkup{
668		ResizeKeyboard: true,
669		Keyboard:       keyboard,
670	}
671}
672
673// NewInlineKeyboardButtonData creates an inline keyboard button with text
674// and data for a callback.
675func NewInlineKeyboardButtonData(text, data string) InlineKeyboardButton {
676	return InlineKeyboardButton{
677		Text:         text,
678		CallbackData: &data,
679	}
680}
681
682// NewInlineKeyboardButtonURL creates an inline keyboard button with text
683// which goes to a URL.
684func NewInlineKeyboardButtonURL(text, url string) InlineKeyboardButton {
685	return InlineKeyboardButton{
686		Text: text,
687		URL:  &url,
688	}
689}
690
691// NewInlineKeyboardButtonSwitch creates an inline keyboard button with
692// text which allows the user to switch to a chat or return to a chat.
693func NewInlineKeyboardButtonSwitch(text, sw string) InlineKeyboardButton {
694	return InlineKeyboardButton{
695		Text:              text,
696		SwitchInlineQuery: &sw,
697	}
698}
699
700// NewInlineKeyboardRow creates an inline keyboard row with buttons.
701func NewInlineKeyboardRow(buttons ...InlineKeyboardButton) []InlineKeyboardButton {
702	var row []InlineKeyboardButton
703
704	row = append(row, buttons...)
705
706	return row
707}
708
709// NewInlineKeyboardMarkup creates a new inline keyboard.
710func NewInlineKeyboardMarkup(rows ...[]InlineKeyboardButton) InlineKeyboardMarkup {
711	var keyboard [][]InlineKeyboardButton
712
713	keyboard = append(keyboard, rows...)
714
715	return InlineKeyboardMarkup{
716		InlineKeyboard: keyboard,
717	}
718}
719
720// NewCallback creates a new callback message.
721func NewCallback(id, text string) CallbackConfig {
722	return CallbackConfig{
723		CallbackQueryID: id,
724		Text:            text,
725		ShowAlert:       false,
726	}
727}
728
729// NewCallbackWithAlert creates a new callback message that alerts
730// the user.
731func NewCallbackWithAlert(id, text string) CallbackConfig {
732	return CallbackConfig{
733		CallbackQueryID: id,
734		Text:            text,
735		ShowAlert:       true,
736	}
737}
738
739// NewInvoice creates a new Invoice request to the user.
740func NewInvoice(chatID int64, title, description, payload, providerToken, startParameter, currency string, prices []LabeledPrice) InvoiceConfig {
741	return InvoiceConfig{
742		BaseChat:       BaseChat{ChatID: chatID},
743		Title:          title,
744		Description:    description,
745		Payload:        payload,
746		ProviderToken:  providerToken,
747		StartParameter: startParameter,
748		Currency:       currency,
749		Prices:         prices}
750}
751
752// NewSetChatPhotoUpload creates a new chat photo uploader.
753//
754// chatID is where to send it, file is a string path to the file,
755// FileReader, or FileBytes.
756//
757// Note that you must send animated GIFs as a document.
758func NewSetChatPhotoUpload(chatID int64, file interface{}) SetChatPhotoConfig {
759	return SetChatPhotoConfig{
760		BaseFile: BaseFile{
761			BaseChat:    BaseChat{ChatID: chatID},
762			File:        file,
763			UseExisting: false,
764		},
765	}
766}
767
768// NewSetChatPhotoShare shares an existing photo.
769// You may use this to reshare an existing photo without reuploading it.
770//
771// chatID is where to send it, fileID is the ID of the file
772// already uploaded.
773func NewSetChatPhotoShare(chatID int64, fileID string) SetChatPhotoConfig {
774	return SetChatPhotoConfig{
775		BaseFile: BaseFile{
776			BaseChat:    BaseChat{ChatID: chatID},
777			FileID:      fileID,
778			UseExisting: true,
779		},
780	}
781}
782
783// NewChatTitle allows you to update the title of a chat.
784func NewChatTitle(chatID int64, title string) SetChatTitleConfig {
785	return SetChatTitleConfig{
786		ChatID: chatID,
787		Title:  title,
788	}
789}
790
791// NewChatDescription allows you to update the description of a chat.
792func NewChatDescription(chatID int64, description string) SetChatDescriptionConfig {
793	return SetChatDescriptionConfig{
794		ChatID:      chatID,
795		Description: description,
796	}
797}
798
799// NewChatPhoto allows you to update the photo for a chat.
800func NewChatPhoto(chatID int64, photo interface{}) SetChatPhotoConfig {
801	return SetChatPhotoConfig{
802		BaseFile: BaseFile{
803			BaseChat: BaseChat{
804				ChatID: chatID,
805			},
806			File: photo,
807		},
808	}
809}
810
811// NewDeleteChatPhoto allows you to delete the photo for a chat.
812func NewDeleteChatPhoto(chatID int64, photo interface{}) DeleteChatPhotoConfig {
813	return DeleteChatPhotoConfig{
814		ChatID: chatID,
815	}
816}