Skip to content

Events

OneBot V11 events are used to push various information received by the bot to the application.

Event Format

All events have the following common fields:

FieldData TypeDescription
timenumberEvent timestamp
self_idnumberBot user ID that received the event
post_typestringEvent type

Message Events (message)

Private Message

Event Data

FieldData TypeDescription
timenumberEvent timestamp
self_idnumberBot user ID that received the event
post_typestringmessage
message_typestringprivate
sub_typestringfriend, group, other
message_idnumberMessage ID
user_idnumberSender user ID
messagemessageMessage content
raw_messagestringRaw message content
fontnumberFont
senderobjectSender information

sender Fields

FieldData TypeDescription
user_idnumberSender user ID
nicknamestringNickname
sexstringGender, male or female or unknown
agenumberAge

sub_type Description

  • friend - Friend message
  • group - Group temporary session
  • other - Other

Group Message

Event Data

FieldData TypeDescription
timenumberEvent timestamp
self_idnumberBot user ID that received the event
post_typestringmessage
message_typestringgroup
sub_typestringnormal, anonymous, notice
message_idnumberMessage ID
group_idnumberGroup ID
user_idnumberSender user ID
anonymousobject | nullAnonymous information, null if not anonymous message
messagemessageMessage content
raw_messagestringRaw message content
fontnumberFont
senderobjectSender information

sender Fields

FieldData TypeDescription
user_idnumberSender user ID
nicknamestringNickname
cardstringGroup card/remark
sexstringGender, male or female or unknown
agenumberAge
areastringArea
levelstringMember level