mytgbot

Documentation

Index

• func AlertCallback(bot *tgbotapi.BotAPI, cbId string, message string, ...) (tgbotapi.Message, error)
• func CreatePermanentInviteLink(token string, chatId int64) (ret string, err error)
• func EditMessage(bot *tgbotapi.BotAPI, chatId int64, editMessageID int, text string, ...) (tgbotapi.Message, error)
• func EditMessageCaption(bot *tgbotapi.BotAPI, chatId int64, editMessageID int, caption string, ...) (tgbotapi.Message, error)
• func GenUserLink(userID int64) string
• func GenUserNameLink(userName string) string
• func GetChatDesc(bot *tgbotapi.BotAPI, chatID int64) (tgbotapi.Chat, error)
• func HtmlLinkText(showText, linkText string) string
• func ImpGroup() group
• func ImpInline() inLine
• func MarkdownCopyText(showText string) string
• func MarkdownLinkText(showText, linkText string) string
• func PingMessage(bot *tgbotapi.BotAPI, chatID int64, messagaId int, notifaicationFlag bool) error
• func SendAnimation(bot *tgbotapi.BotAPI, chatID int64, ...) (messageID int, animationFileId string, err error)
• func SendMessage(bot *tgbotapi.BotAPI, chatId int64, message string, ...) (*tgbotapi.Message, error)
• func SendMessageByAutoDel(bot *tgbotapi.BotAPI, chatId int64, message string, ...) error
• func SendMessageByToken(token string, toChatId int64, message string, configFn func(values url.Values)) error
• func SendPhoto(bot *tgbotapi.BotAPI, chatId int64, ...) (messageID int, imageFileId string, err error)
• func SendPhotoByToken(token string, toChatId int64, photoName string, photoData []byte, ...) error
• func WebhookHandler(w http.ResponseWriter, r *http.Request, cbFun func(update tgbotapi.Update))
• type BotInfo
  • func GetBotInfo(token string) (*BotInfo, error)
• type ChatResp
• type ErrStatus
  • func CheckErrStatus(err error) ErrStatus
• type InviteTempData
  • func CreateTempInviteLink(token string, chatId int64, name string, expireDate time.Time, maxLimit int, ...) (ret *InviteTempData, err error)
• type TelegramChat
  • func GetChatByToken(token string, groupID int64) (*TelegramChat, error)
• type TelegramUser
  • func GetUserByToken(token string, userID int64) (*TelegramUser, error)

Functions

func AlertCallback

func AlertCallback(bot *tgbotapi.BotAPI, cbId string, message string, configFn func(callbackConfig *tgbotapi.CallbackConfig)) (tgbotapi.Message, error)

func CreatePermanentInviteLink

func CreatePermanentInviteLink(token string, chatId int64) (ret string, err error)

生成群永久链接，这个链接中永久的，唯一的，多次生成，则新的替换成旧的 。

func EditMessage

func EditMessage(bot *tgbotapi.BotAPI, chatId int64, editMessageID int, text string, configFn func(editMsgConfig *tgbotapi.EditMessageTextConfig)) (tgbotapi.Message, error)

func EditMessageCaption

func EditMessageCaption(bot *tgbotapi.BotAPI, chatId int64, editMessageID int, caption string, configFn func(editMsgConfig *tgbotapi.EditMessageCaptionConfig)) (tgbotapi.Message, error)

func GenUserLink

func GenUserLink(userID int64) string

func GenUserNameLink

func GenUserNameLink(userName string) string

func GetChatDesc

func GetChatDesc(bot *tgbotapi.BotAPI, chatID int64) (tgbotapi.Chat, error)

func HtmlLinkText

func HtmlLinkText(showText, linkText string) string

func ImpGroup

func ImpGroup() group

func ImpInline

func ImpInline() inLine

func MarkdownCopyText

func MarkdownCopyText(showText string) string

func MarkdownLinkText

func MarkdownLinkText(showText, linkText string) string

关于markdown 格式的特别显示

func PingMessage

func PingMessage(bot *tgbotapi.BotAPI, chatID int64, messagaId int, notifaicationFlag bool) error

func SendAnimation

func SendAnimation(bot *tgbotapi.BotAPI, chatID int64, animationFileFn func() tgbotapi.RequestFileData, configCb func(photoConfig *tgbotapi.AnimationConfig)) (messageID int, animationFileId string, err error)

func SendMessage

func SendMessage(bot *tgbotapi.BotAPI, chatId int64, message string, configCb func(messageCfg *tgbotapi.MessageConfig)) (*tgbotapi.Message, error)

func SendMessageByAutoDel

func SendMessageByAutoDel(bot *tgbotapi.BotAPI, chatId int64, message string, configCb func(messageCfg *tgbotapi.MessageConfig), autoDele time.Duration) error

func SendMessageByToken

func SendMessageByToken(token string, toChatId int64, message string, configFn func(values url.Values)) error

func SendPhoto

func SendPhoto(bot *tgbotapi.BotAPI, chatId int64, imageFileFn func() tgbotapi.RequestFileData, configCb func(photoConfig *tgbotapi.PhotoConfig)) (messageID int, imageFileId string, err error)

func SendPhotoByToken

func SendPhotoByToken(token string, toChatId int64, photoName string, photoData []byte, caption string, configFn func(values *multipart.Writer)) error

func WebhookHandler

func WebhookHandler(w http.ResponseWriter, r *http.Request, cbFun func(update tgbotapi.Update))

Types

type BotInfo

type BotInfo struct {
	Ok     bool `json:"ok"`
	Result struct {
		ID                      int64  `json:"id"`
		IsBot                   bool   `json:"is_bot"`
		FirstName               string `json:"first_name"`
		Username                string `json:"username"`
		CanJoinGroups           bool   `json:"can_join_groups"`
		CanReadAllGroupMessages bool   `json:"can_read_all_group_messages"`
		SupportsInlineQueries   bool   `json:"supports_inline_queries"`
	} `json:"result"`
}

func GetBotInfo

func GetBotInfo(token string) (*BotInfo, error)

type ChatResp

type ChatResp[T any] struct {
	Ok     bool `json:"ok"`
	Result T    `json:"result"`
}

type ErrStatus

type ErrStatus int

const (
	ErrStatusNil          ErrStatus = 0
	ErrStatusKicked       ErrStatus = 1   //对话已被踢出群聊
	ErrStatusGroupDeleted ErrStatus = 2   //群组被删除
	ErrStatusUnknown      ErrStatus = 100 //未知的错误
)

func CheckErrStatus

func CheckErrStatus(err error) ErrStatus

type InviteTempData

type InviteTempData struct {
	InviteLink         string `json:"invite_link"`
	Name               string `json:"name"`
	ExpireDate         int    `json:"expire_date"`
	MemberLimit        int    `json:"member_limit"`
	CreatesJoinRequest bool   `json:"creates_join_request"`
}

func CreateTempInviteLink

func CreateTempInviteLink(token string, chatId int64, name string, expireDate time.Time, maxLimit int, joinCheck bool) (ret *InviteTempData, err error)

生成临时邀请链接 ，可为不同人生成，场景更丰富

type TelegramChat

type TelegramChat struct {
	ID          int64  `json:"id"`
	Type        string `json:"type"`        // "group", "supergroup", "channel"
	Title       string `json:"title"`       // 群组或频道的名称
	Username    string `json:"username"`    // 可能为空
	Description string `json:"description"` // 仅频道有
	InviteLink  string `json:"invite_link"`
}

群组/频道信息

func GetChatByToken

func GetChatByToken(token string, groupID int64) (*TelegramChat, error)

type TelegramUser

type TelegramUser struct {
	ID        int64  `json:"id"`
	Type      string `json:"type"`     // 必须是 "private"
	Username  string `json:"username"` // 可能为空
	FirstName string `json:"first_name"`
	LastName  string `json:"last_name"`
}

用户信息

func GetUserByToken

func GetUserByToken(token string, userID int64) (*TelegramUser, error)