stickers: implement custom emoji support

message.go

@@ -274,6 +274,9 @@ type MessageEntity struct {
 
 	// (Optional) For EntityCodeBlock entity type only.
 	Language string `json:"language,omitempty"`
+
+	// (Optional) For EntityCustomEmoji entity type only.
+	CustomEmoji string `json:"custom_emoji_id"`
 }
 
 // Entities is used to set message's text entities as a send option.

stickers.go

@@ -5,20 +5,30 @@ import (
 	"strconv"
 )
 
+type StickerSetType = string
+
+// StickerSet types.
+const (
+	StickerRegular     = "regular"
+	StickerMask        = "mask"
+	StickerCustomEmoji = "custom_emoji"
+)
+
 // StickerSet represents a sticker set.
 type StickerSet struct {
-	Name          string        `json:"name"`
-	Title         string        `json:"title"`
-	Animated      bool          `json:"is_animated"`
-	Video         bool          `json:"is_video"`
-	Stickers      []Sticker     `json:"stickers"`
-	Thumbnail     *Photo        `json:"thumb"`
-	PNG           *File         `json:"png_sticker"`
-	TGS           *File         `json:"tgs_sticker"`
-	WebM          *File         `json:"webm_sticker"`
-	Emojis        string        `json:"emojis"`
-	ContainsMasks bool          `json:"contains_masks"`
-	MaskPosition  *MaskPosition `json:"mask_position"`
+	Type          StickerSetType `json:"sticker_type"`
+	Name          string         `json:"name"`
+	Title         string         `json:"title"`
+	Animated      bool           `json:"is_animated"`
+	Video         bool           `json:"is_video"`
+	Stickers      []Sticker      `json:"stickers"`
+	Thumbnail     *Photo         `json:"thumb"`
+	PNG           *File          `json:"png_sticker"`
+	TGS           *File          `json:"tgs_sticker"`
+	WebM          *File          `json:"webm_sticker"`
+	Emojis        string         `json:"emojis"`
+	ContainsMasks bool           `json:"contains_masks"` // FIXME: can be removed
+	MaskPosition  *MaskPosition  `json:"mask_position"`
 }
 
 // MaskPosition describes the position on faces where
@@ -84,6 +94,7 @@ func (b *Bot) CreateStickerSet(to Recipient, s StickerSet) error {
 
 	params := map[string]string{
 		"user_id":        to.Recipient(),
+		"sticker_type":   s.Type,
 		"name":           s.Name,
 		"title":          s.Title,
 		"emojis":         s.Emojis,
@@ -168,3 +179,25 @@ func (b *Bot) SetStickerSetThumb(to Recipient, s StickerSet) error {
 	_, err := b.sendFiles("setStickerSetThumb", files, params)
 	return err
 }
+
+// CustomEmojiStickers returns the information about custom emoji stickers by their ids.
+func (b *Bot) CustomEmojiStickers(ids []string) ([]Sticker, error) {
+	data, _ := json.Marshal(ids)
+
+	params := map[string]string{
+		"custom_emoji_ids": string(data),
+	}
+
+	data, err := b.Raw("getCustomEmojiStickers", params)
+	if err != nil {
+		return nil, err
+	}
+
+	var resp struct {
+		Result []Sticker
+	}
+	if err := json.Unmarshal(data, &resp); err != nil {
+		return nil, wrapError(err)
+	}
+	return resp.Result, nil
+}

telebot.go

@@ -186,6 +186,7 @@ const (
 	EntityCodeBlock     EntityType = "pre"
 	EntityTextLink      EntityType = "text_link"
 	EntitySpoiler       EntityType = "spoiler"
+	EntityCustomEmoji   EntityType = "custom_emoji"
 )
 
 // ChatType represents one of the possible chat types.