telebot/message.go

203 lines
5.1 KiB
Go
Raw Normal View History

package telebot
import (
"time"
)
// Message object represents a message.
type Message struct {
ID int `json:"message_id"`
// For message sent to channels, Sender may be empty
Sender User `json:"from"`
Unixtime int `json:"date"`
// For forwarded messages, sender of the original message.
OriginalSender User `json:"forward_from"`
// For forwarded messages, unixtime of the original message.
OriginalUnixtime int `json:"forward_date"`
// For replies, ReplyTo represents the original message.
// Note that the Message object in this field will not
// contain further ReplyTo fields even if it
// itself is a reply.
ReplyTo *Message `json:"reply_to_message"`
// For a text message, the actual UTF-8 text of the message
Text string `json:"text"`
// For an audio recording, information about it.
Audio Audio `json:"audio"`
// For a general file, information about it.
Document Document `json:"document"`
// For a photo, available thumbnails.
Photo []Thumbnail `json:"photo"`
// For a sticker, information about it.
Sticker Sticker `json:"sticker"`
// For a video, information about it.
Video Video `json:"video"`
// For a contact, contact information itself.
Contact Contact `json:"contact"`
// For a location, its longitude and latitude.
Location Location `json:"location"`
// A group chat message belongs to, empty if personal.
Chat Chat `json:"chat"`
// For a service message, represents a user,
// that just got added to chat, this message came from.
//
// Sender leads to User, capable of invite.
//
// UserJoined might be the Bot itself.
UserJoined User `json:"new_chat_member"`
// For a service message, represents a user,
// that just left chat, this message came from.
//
// If user was kicked, Sender leads to a User,
// capable of this kick.
//
// UserLeft might be the Bot itself.
UserLeft User `json:"left_chat_member"`
// For a service message, represents a new title
// for chat this message came from.
//
// Sender would lead to a User, capable of change.
NewChatTitle string `json:"new_chat_title"`
// For a service message, represents all available
// thumbnails of new chat photo.
//
// Sender would lead to a User, capable of change.
NewChatPhoto []Thumbnail `json:"new_chat_photo"`
// For a service message, true if chat photo just
// got removed.
//
// Sender would lead to a User, capable of change.
ChatPhotoDeleted bool `json:"delete_chat_photo"`
// For a service message, true if group has been created.
//
// You would recieve such a message if you are one of
// initial group chat members.
//
// Sender would lead to creator of the chat.
ChatCreated bool `json:"group_chat_created"`
// For a service message, true if super group has been created.
//
// You would recieve such a message if you are one of
// initial group chat members.
//
// Sender would lead to creator of the chat.
SuperGroupCreated bool `json:"supergroup_chat_created"`
// For a service message, true if channel has been created.
//
// You would recieve such a message if you are one of
// initial channel administrators.
//
// Sender would lead to creator of the chat.
ChannelCreated bool `json:"channel_chat_created"`
// For a service message, the destination (super group) you
// migrated to.
//
// You would recieve such a message when your chat has migrated
// to a super group.
//
// Sender would lead to creator of the migration.
MigrateTo int64 `json:"migrate_to_chat_id"`
// For a service message, the Origin (normal group) you migrated
// from.
//
// You would recieve such a message when your chat has migrated
// to a super group.
//
// Sender would lead to creator of the migration.
MigrateFrom int64 `json:"migrate_from_chat_id"`
2016-07-10 18:58:42 +00:00
Entities []MessageEntity `json:"entities",omitempty`
2016-10-09 19:48:19 +00:00
Caption string `json:"caption",omitempty`
}
2015-07-02 09:05:50 +00:00
// Origin returns an origin of message: group chat / personal.
func (m *Message) Origin() User {
// if m.IsPersonal() {
// return m.Chat
// }
2015-07-03 18:54:40 +00:00
return m.Sender
2015-07-02 09:05:50 +00:00
}
// Time returns the moment of message creation in local time.
func (m *Message) Time() time.Time {
return time.Unix(int64(m.Unixtime), 0)
}
// IsForwarded says whether message is forwarded copy of another
// message or not.
func (m *Message) IsForwarded() bool {
2015-10-13 14:31:51 +00:00
return m.OriginalSender != User{}
}
// IsReply says whether message is reply to another message or not.
func (m *Message) IsReply() bool {
2015-10-13 14:31:51 +00:00
return m.ReplyTo != nil
}
// IsPersonal returns true, if message is a personal message,
// returns false if sent to group chat.
func (m *Message) IsPersonal() bool {
return !m.Chat.IsGroupChat()
}
// IsService returns true, if message is a service message,
// returns false otherwise.
//
// Service messages are automatically sent messages, which
// typically occur on some global action. For instance, when
// anyone leaves the chat or chat title changes.
func (m *Message) IsService() bool {
2015-07-06 13:52:50 +00:00
service := false
if (m.UserJoined != User{}) {
2015-07-06 13:52:50 +00:00
service = true
}
if (m.UserLeft != User{}) {
2015-07-06 13:52:50 +00:00
service = true
}
if m.NewChatTitle != "" {
2015-07-06 13:52:50 +00:00
service = true
}
if len(m.NewChatPhoto) > 0 {
2015-07-06 13:52:50 +00:00
service = true
}
if m.ChatPhotoDeleted {
2015-07-06 13:52:50 +00:00
service = true
}
if m.ChatCreated {
2015-07-06 13:52:50 +00:00
service = true
}
2015-07-06 13:52:50 +00:00
return service
}