Pin/Unpin methods added.

admin.go

@@ -1,8 +1,11 @@
 package telebot
 
 import (
+	"encoding/json"
 	"strconv"
 	"time"
+
+	"github.com/pkg/errors"
 )
 
 // Rights is a list of privileges available to chat members.
@@ -137,3 +140,66 @@ func (b *Bot) Promote(chat *Chat, member *ChatMember) error {
 
 	return extractOkResponse(respJSON)
 }
+
+// AdminsOf return a member list of chat admins.
+//
+// On success, returns an Array of ChatMember objects that
+// contains information about all chat administrators except other bots.
+// If the chat is a group or a supergroup and
+// no administrators were appointed, only the creator will be returned.
+func (b *Bot) AdminsOf(chat *Chat) ([]ChatMember, error) {
+	params := map[string]string{
+		"chat_id": chat.Recipient(),
+	}
+
+	respJSON, err := b.sendCommand("getChatAdministrators", params)
+	if err != nil {
+		return nil, err
+	}
+
+	var resp struct {
+		Ok          bool
+		Result      []ChatMember
+		Description string `json:"description"`
+	}
+
+	err = json.Unmarshal(respJSON, &resp)
+	if err != nil {
+		return nil, errors.Wrap(err, "bad response json")
+	}
+
+	if !resp.Ok {
+		return nil, errors.Errorf("api error: %s", resp.Description)
+	}
+
+	return resp.Result, nil
+}
+
+// Len return the number of members in a chat.
+func (b *Bot) Len(chat *Chat) (int, error) {
+	params := map[string]string{
+		"chat_id": chat.Recipient(),
+	}
+
+	respJSON, err := b.sendCommand("getChatMembersCount", params)
+	if err != nil {
+		return 0, err
+	}
+
+	var resp struct {
+		Ok          bool
+		Result      int
+		Description string `json:"description"`
+	}
+
+	err = json.Unmarshal(respJSON, &resp)
+	if err != nil {
+		return 0, errors.Wrap(err, "bad response json")
+	}
+
+	if !resp.Ok {
+		return 0, errors.Errorf("api error: %s", resp.Description)
+	}
+
+	return resp.Result, nil
+}

bot.go

@@ -616,98 +616,73 @@ func (b *Bot) Leave(chat *Chat) error {
 	return extractOkResponse(respJSON)
 }
 
-// ChatByID fetches chat info of its ID.
+// Use this method to pin a message in a supergroup or a channel.
 //
-// Including current name of the user for one-on-one conversations,
-// current username of a user, group or channel, etc.
-//
-// Returns a Chat object on success.
-func (b *Bot) ChatByID(id string) (*Chat, error) {
-	params := map[string]string{
-		"chat_id": id,
-	}
+// It supports telebot.Silent option.
+func (b *Bot) Pin(message Editable, options ...interface{}) error {
+	messageID, chatID := message.MessageSig()
 
-	respJSON, err := b.sendCommand("getChat", params)
-	if err != nil {
-		return nil, err
+	params := map[string]string{
+		"chat_id":    strconv.FormatInt(chatID, 10),
+		"message_id": strconv.Itoa(messageID),
 	}
 
-	var resp struct {
-		Ok          bool
-		Description string
-		Result      *Chat
-	}
+	sendOpts := extractOptions(options)
+	embedSendOptions(params, sendOpts)
 
-	err = json.Unmarshal(respJSON, &resp)
+	respJSON, err := b.sendCommand("pinChatMessage", params)
 	if err != nil {
-		return nil, errors.Wrap(err, "bad response json")
-	}
-
-	if !resp.Ok {
-		return nil, errors.Errorf("api error: %s", resp.Description)
+		return err
 	}
 
-	return resp.Result, nil
+	return extractOkResponse(respJSON)
 }
 
-// AdminsOf return a member list of chat admins.
+// Use this method to unpin a message in a supergroup or a channel.
 //
-// On success, returns an Array of ChatMember objects that
-// contains information about all chat administrators except other bots.
-// If the chat is a group or a supergroup and
-// no administrators were appointed, only the creator will be returned.
-func (b *Bot) AdminsOf(chat *Chat) ([]ChatMember, error) {
+// It supports telebot.Silent option.
+func (b *Bot) Unpin(chat *Chat) error {
 	params := map[string]string{
 		"chat_id": chat.Recipient(),
 	}
 
-	respJSON, err := b.sendCommand("getChatAdministrators", params)
-	if err != nil {
-		return nil, err
-	}
-
-	var resp struct {
-		Ok          bool
-		Result      []ChatMember
-		Description string `json:"description"`
-	}
-
-	err = json.Unmarshal(respJSON, &resp)
+	respJSON, err := b.sendCommand("upinChatMessage", params)
 	if err != nil {
-		return nil, errors.Wrap(err, "bad response json")
-	}
-
-	if !resp.Ok {
-		return nil, errors.Errorf("api error: %s", resp.Description)
+		return err
 	}
 
-	return resp.Result, nil
+	return extractOkResponse(respJSON)
 }
 
-// Len return the number of members in a chat.
-func (b *Bot) Len(chat *Chat) (int, error) {
+// ChatByID fetches chat info of its ID.
+//
+// Including current name of the user for one-on-one conversations,
+// current username of a user, group or channel, etc.
+//
+// Returns a Chat object on success.
+func (b *Bot) ChatByID(id string) (*Chat, error) {
 	params := map[string]string{
-		"chat_id": chat.Recipient(),
+		"chat_id": id,
 	}
 
-	respJSON, err := b.sendCommand("getChatMembersCount", params)
+	respJSON, err := b.sendCommand("getChat", params)
 	if err != nil {
-		return 0, err
+		return nil, err
 	}
 
 	var resp struct {
 		Ok          bool
-		Result      int
-		Description string `json:"description"`
+		Description string
+		Result      *Chat
 	}
 
 	err = json.Unmarshal(respJSON, &resp)
 	if err != nil {
-		return 0, errors.Wrap(err, "bad response json")
+		return nil, errors.Wrap(err, "bad response json")
 	}
 
 	if !resp.Ok {
-		return 0, errors.Errorf("api error: %s", resp.Description)
+		return nil, errors.Errorf("api error: %s", resp.Description)
 	}
 
 	return resp.Result, nil