Liste des événements
Toutes les classes d'événements se trouvent dans bostie.events. Écoutez-en une avec @bot.listen, comme l'explique le guide des événements. La colonne des intents nomme les intents dont Discord a besoin pour envoyer l'événement, un seul d'entre eux suffisant ; une cellule vide signifie que Discord l'envoie sans intent, ou seulement en réponse à une requête. Chaque événement de gateway a aussi shard_id, raw_json et raw. La référence de l'API donne chaque champ avec son type.
Session
| Événement |
Dispatch |
Intents |
Champs |
Ready |
READY |
|
user, guilds (indisponibles jusqu'à leur GuildCreate), application, session_id, shard |
Resumed |
RESUMED |
|
|
UserUpdate |
USER_UPDATE |
|
user, celui du bot ; old |
GatewayRateLimited |
RATE_LIMITED |
|
opcode, retry_after, meta |
Serveurs
| Événement |
Dispatch |
Intents |
Champs |
GuildCreate |
GUILD_CREATE |
GUILDS |
guild, joined, channels, threads, voice_states, stage_instances, guild_scheduled_events, soundboard_sounds, members, presences |
GuildUpdate |
GUILD_UPDATE |
GUILDS |
guild, old |
GuildDelete |
GUILD_DELETE |
GUILDS |
guild_id, unavailable, guild (en cache) |
RoleCreate |
GUILD_ROLE_CREATE |
GUILDS |
guild_id, role |
RoleUpdate |
GUILD_ROLE_UPDATE |
GUILDS |
guild_id, role, old |
RoleDelete |
GUILD_ROLE_DELETE |
GUILDS |
guild_id, role_id, role (en cache) |
EmojisUpdate |
GUILD_EMOJIS_UPDATE |
GUILD_EXPRESSIONS |
guild_id, emojis, old |
StickersUpdate |
GUILD_STICKERS_UPDATE |
GUILD_EXPRESSIONS |
guild_id, stickers, old |
SoundboardSoundCreate |
GUILD_SOUNDBOARD_SOUND_CREATE |
GUILD_EXPRESSIONS |
sound |
SoundboardSoundUpdate |
GUILD_SOUNDBOARD_SOUND_UPDATE |
GUILD_EXPRESSIONS |
sound, old |
SoundboardSoundDelete |
GUILD_SOUNDBOARD_SOUND_DELETE |
GUILD_EXPRESSIONS |
sound_id, guild_id, sound |
SoundboardSoundsUpdate |
GUILD_SOUNDBOARD_SOUNDS_UPDATE |
GUILD_EXPRESSIONS |
soundboard_sounds, guild_id, old |
SoundboardSounds |
SOUNDBOARD_SOUNDS |
|
soundboard_sounds, guild_id ; la réponse à bot.request_soundboard_sounds |
AuditLogEntryCreate |
GUILD_AUDIT_LOG_ENTRY_CREATE |
GUILD_MODERATION |
guild_id, entry |
BanAdd |
GUILD_BAN_ADD |
GUILD_MODERATION |
guild_id, user |
BanRemove |
GUILD_BAN_REMOVE |
GUILD_MODERATION |
guild_id, user |
GuildIntegrationsUpdate |
GUILD_INTEGRATIONS_UPDATE |
GUILD_INTEGRATIONS |
guild_id |
IntegrationCreate |
INTEGRATION_CREATE |
GUILD_INTEGRATIONS |
guild_id, integration |
IntegrationUpdate |
INTEGRATION_UPDATE |
GUILD_INTEGRATIONS |
guild_id, integration |
IntegrationDelete |
INTEGRATION_DELETE |
GUILD_INTEGRATIONS |
id, guild_id, application_id |
WebhooksUpdate |
WEBHOOKS_UPDATE |
GUILD_WEBHOOKS |
guild_id, channel_id |
CommandPermissionsUpdate |
APPLICATION_COMMAND_PERMISSIONS_UPDATE |
|
permissions |
Membres et présences
| Événement |
Dispatch |
Intents |
Champs |
MemberJoin |
GUILD_MEMBER_ADD |
GUILD_MEMBERS |
guild_id, member |
MemberUpdate |
GUILD_MEMBER_UPDATE |
GUILD_MEMBERS |
guild_id, user, roles, nick, joined_at, communication_disabled_until et les autres champs du membre ; old |
MemberRemove |
GUILD_MEMBER_REMOVE |
GUILD_MEMBERS |
guild_id, user, member (en cache) |
MembersChunk |
GUILD_MEMBERS_CHUNK |
|
guild_id, members, presences, not_found, chunk_index, chunk_count, nonce ; la réponse à bot.request_members |
PresenceUpdate |
PRESENCE_UPDATE |
GUILD_PRESENCES |
guild_id, presence, old |
Salons et fils
| Événement |
Dispatch |
Intents |
Champs |
ChannelCreate |
CHANNEL_CREATE |
GUILDS |
channel |
ChannelUpdate |
CHANNEL_UPDATE |
GUILDS |
channel, old |
ChannelDelete |
CHANNEL_DELETE |
GUILDS |
channel |
ChannelPinsUpdate |
CHANNEL_PINS_UPDATE |
GUILDS, DIRECT_MESSAGES |
guild_id, channel_id, last_pin_timestamp |
ThreadCreate |
THREAD_CREATE |
GUILDS |
channel, newly_created, member |
ThreadUpdate |
THREAD_UPDATE |
GUILDS |
channel, old |
ThreadDelete |
THREAD_DELETE |
GUILDS |
id, guild_id, parent_id, type, thread (en cache) |
ThreadListSync |
THREAD_LIST_SYNC |
GUILDS |
guild_id, channel_ids, threads, members |
ThreadMemberUpdate |
THREAD_MEMBER_UPDATE |
GUILDS |
guild_id, thread_member, celui du bot |
ThreadMembersUpdate |
THREAD_MEMBERS_UPDATE |
GUILDS, GUILD_MEMBERS |
id, guild_id, member_count, added_members, removed_member_ids |
StageInstanceCreate |
STAGE_INSTANCE_CREATE |
GUILDS |
stage_instance |
StageInstanceUpdate |
STAGE_INSTANCE_UPDATE |
GUILDS |
stage_instance, old |
StageInstanceDelete |
STAGE_INSTANCE_DELETE |
GUILDS |
stage_instance |
InviteCreate |
INVITE_CREATE |
GUILD_INVITES |
code, channel_id, guild_id, inviter, max_age, max_uses, expires_at et d'autres |
InviteDelete |
INVITE_DELETE |
GUILD_INVITES |
channel_id, guild_id, code |
Messages, réactions et sondages
| Événement |
Dispatch |
Intents |
Champs |
MessageCreate |
MESSAGE_CREATE |
GUILD_MESSAGES, DIRECT_MESSAGES |
message |
MessageUpdate |
MESSAGE_UPDATE |
GUILD_MESSAGES, DIRECT_MESSAGES |
message, old |
MessageDelete |
MESSAGE_DELETE |
GUILD_MESSAGES, DIRECT_MESSAGES |
id, channel_id, guild_id, message (en cache) |
MessageDeleteBulk |
MESSAGE_DELETE_BULK |
GUILD_MESSAGES |
ids, channel_id, guild_id, messages (en cache) |
TypingStart |
TYPING_START |
GUILD_MESSAGE_TYPING, DIRECT_MESSAGE_TYPING |
channel_id, guild_id, user_id, timestamp, member |
ReactionAdd |
MESSAGE_REACTION_ADD |
GUILD_MESSAGE_REACTIONS, DIRECT_MESSAGE_REACTIONS |
user_id, channel_id, message_id, guild_id, emoji, burst, type, member, message_author_id, burst_colors |
ReactionRemove |
MESSAGE_REACTION_REMOVE |
GUILD_MESSAGE_REACTIONS, DIRECT_MESSAGE_REACTIONS |
user_id, channel_id, message_id, guild_id, emoji, burst, type |
ReactionRemoveAll |
MESSAGE_REACTION_REMOVE_ALL |
GUILD_MESSAGE_REACTIONS, DIRECT_MESSAGE_REACTIONS |
channel_id, message_id, guild_id |
ReactionRemoveEmoji |
MESSAGE_REACTION_REMOVE_EMOJI |
GUILD_MESSAGE_REACTIONS, DIRECT_MESSAGE_REACTIONS |
channel_id, message_id, guild_id, emoji |
PollVoteAdd |
MESSAGE_POLL_VOTE_ADD |
GUILD_MESSAGE_POLLS, DIRECT_MESSAGE_POLLS |
user_id, channel_id, message_id, guild_id, answer_id |
PollVoteRemove |
MESSAGE_POLL_VOTE_REMOVE |
GUILD_MESSAGE_POLLS, DIRECT_MESSAGE_POLLS |
user_id, channel_id, message_id, guild_id, answer_id |
Le contenu des messages, ainsi que le content de AutoModerationActionExecution, nécessite l'intent MESSAGE_CONTENT, sauf dans les messages privés et les messages qui mentionnent le bot.
Voix
| Événement |
Dispatch |
Intents |
Champs |
VoiceStateUpdate |
VOICE_STATE_UPDATE |
GUILD_VOICE_STATES |
voice_state, old |
VoiceServerUpdate |
VOICE_SERVER_UPDATE |
|
token, guild_id, endpoint |
VoiceChannelEffectSend |
VOICE_CHANNEL_EFFECT_SEND |
GUILD_VOICE_STATES |
channel_id, guild_id, user_id, emoji, animation_type, animation_id, sound_id, sound_volume |
VoiceChannelStatusUpdate |
VOICE_CHANNEL_STATUS_UPDATE |
GUILDS |
id, guild_id, status |
VoiceChannelStartTimeUpdate |
VOICE_CHANNEL_START_TIME_UPDATE |
GUILDS |
id, guild_id, voice_start_time |
ChannelInfo |
CHANNEL_INFO |
|
guild_id, channels ; la réponse à bot.request_channel_info |
Les événements des propres connexions vocales du bot sont listés dans le guide de la voix.
Interactions, modération et événements programmés
| Événement |
Dispatch |
Intents |
Champs |
InteractionCreate |
INTERACTION_CREATE |
|
interaction |
AutoModerationRuleCreate |
AUTO_MODERATION_RULE_CREATE |
AUTO_MODERATION_CONFIGURATION |
rule |
AutoModerationRuleUpdate |
AUTO_MODERATION_RULE_UPDATE |
AUTO_MODERATION_CONFIGURATION |
rule |
AutoModerationRuleDelete |
AUTO_MODERATION_RULE_DELETE |
AUTO_MODERATION_CONFIGURATION |
rule |
AutoModerationActionExecution |
AUTO_MODERATION_ACTION_EXECUTION |
AUTO_MODERATION_EXECUTION |
guild_id, action, rule_id, rule_trigger_type, user_id, channel_id, message_id, content, matched_keyword, matched_content |
ScheduledEventCreate |
GUILD_SCHEDULED_EVENT_CREATE |
GUILD_SCHEDULED_EVENTS |
scheduled_event |
ScheduledEventUpdate |
GUILD_SCHEDULED_EVENT_UPDATE |
GUILD_SCHEDULED_EVENTS |
scheduled_event, old |
ScheduledEventDelete |
GUILD_SCHEDULED_EVENT_DELETE |
GUILD_SCHEDULED_EVENTS |
scheduled_event |
ScheduledEventUserAdd |
GUILD_SCHEDULED_EVENT_USER_ADD |
GUILD_SCHEDULED_EVENTS |
guild_scheduled_event_id, user_id, guild_id |
ScheduledEventUserRemove |
GUILD_SCHEDULED_EVENT_USER_REMOVE |
GUILD_SCHEDULED_EVENTS |
guild_scheduled_event_id, user_id, guild_id |
Monétisation
| Événement |
Dispatch |
Intents |
Champs |
EntitlementCreate |
ENTITLEMENT_CREATE |
|
entitlement, un PartialEntitlement pour un entitlement de test |
EntitlementUpdate |
ENTITLEMENT_UPDATE |
|
entitlement ; pour un abonnement, seulement quand il prend fin |
EntitlementDelete |
ENTITLEMENT_DELETE |
|
entitlement |
SubscriptionCreate |
SUBSCRIPTION_CREATE |
|
subscription |
SubscriptionUpdate |
SUBSCRIPTION_UPDATE |
|
subscription |
SubscriptionDelete |
SUBSCRIPTION_DELETE |
|
subscription |
Événements webhook
Discord ne les envoie qu'à l'URL Webhook Events de l'application, que sert ASGIApp. Les événements d'entitlement ci-dessus y arrivent aussi.
| Événement |
Type |
Champs |
ApplicationAuthorized |
APPLICATION_AUTHORIZED |
integration_type, user, scopes, guild |
ApplicationDeauthorized |
APPLICATION_DEAUTHORIZED |
user |
QuestUserEnrollment |
QUEST_USER_ENROLLMENT |
|
LobbyMessageCreate |
LOBBY_MESSAGE_CREATE |
message |
LobbyMessageUpdate |
LOBBY_MESSAGE_UPDATE |
message |
LobbyMessageDelete |
LOBBY_MESSAGE_DELETE |
id, lobby_id |
GameDirectMessageCreate |
GAME_DIRECT_MESSAGE_CREATE |
message |
GameDirectMessageUpdate |
GAME_DIRECT_MESSAGE_UPDATE |
message |
GameDirectMessageDelete |
GAME_DIRECT_MESSAGE_DELETE |
message |
N'importe quel dispatch
| Événement |
Dispatch |
Intents |
Champs |
RawEvent |
n'importe lequel |
|
name, seq, raw, raw_json ; pour n'importe quel dispatch, modélisé ou non |
Événements du bot
Ceux-ci viennent de bostie, pas de Discord ; leurs noms sont propres à bostie.
| Événement |
Nom |
Champs |
Envoyé quand |
Starting |
bot.starting |
|
start() est sur le point de synchroniser et de se connecter ; REST fonctionne |
Started |
bot.started |
|
tous les shards sont prêts, une fois par start() |
Stopping |
bot.stopping |
|
close() a commencé après Started ; la gateway est encore ouverte |
Stopped |
bot.stopped |
|
close() est terminé ; la gateway et REST ne sont plus là |
ShardReady |
shard.ready |
shard_id |
la nouvelle session d'un shard est prête et ses serveurs sont arrivés |
ShardDisconnect |
shard.disconnect |
shard_id, code, reason, resuming |
un shard a perdu sa connexion |
ShardStop |
shard.stop |
shard_id, code, reason |
un shard s'est arrêté définitivement |
ShardBackpressure |
shard.backpressure |
shard_id, queued_bytes |
un shard a suspendu la lecture parce que la boucle d'événements prend du retard |
ListenerError |
bot.listener_error |
listener, event, error |
un écouteur a levé une exception |
TaskError |
bot.task_error |
task, error |
une tâche de fond a levé une exception |