Terminology
Platform
The operator of the platform, on which the property resides on. Like Discord, Twitch, Telegram, or Minecraft.
Synthetic Event
An event that wasn't generated by the platform, and instead generated by Chatsight to represent some action that occurred in reaction to activity on your property. Like a security issue, or verification completion.
User
An end-user on your property. This does not refer to a user in your organization. This for example, is a member in your discord community, or a member in your Telegram chat.
"On supported property types ..."
Some platforms support more events than others. The supported events for each platform will be listed.
Event Types
Analytics Logs are assigned three tiers of event types:
Platform-Specific Types, often the name of the event from an underlying framework used.Universal Types, are standardized events that share the same form and purpose between two or more different platforms.Function Type, the publically available name of the function that recorded this log entry.
For all intents and purposes, you will be using Universal Types, called event_type in Audit Logging, and by their respective names in the object events returned by most API endpoints handling logs of this nature.
| Universal Type | Description | Supported |
|---|---|---|
| USER_JOIN | When a user on the platform, has joined your property. Like when a user joins a new Discord Server or enters a Telegram Chat. | All |
| USER_REMOVE | When a user is removed by members with permission to remove a user, or the user elects to remove themselves. | All |
| USER_BAN | When a user is banned (through platform-specific means) from a property. This ban is enforced by the platform itself. | All |
| USER_BAN_REMOVE | On supported property types, when a user ban is removed. | Discord |
| USER_UPDATE | When a user, who is a member of the property - has updated attributes (or has been updated) of their account so as to be visible while inside the property. This for example could be a username update, profile picture change, or a change in their permissions or roles. | All |
| CHAT_MESSAGE | When a chat message of any kind, is created. | All |
| CHAT_MESSAGE_DELETE | On supported property types, when a chat message of any kind, is deleted. | Discord |
| CHANNEL_CREATE | On supported platforms, a channel refers to a unique place in which a single stream of messages is contained - which has been created. On discord, for example, this event means a channel was created. We assign discord threads to this event type equally. | Discord |
| CHANNEL_DELETE | On supported platforms, a channel refers to a unique place in which a single stream of messages is contained - which has been deleted. On discord, for example, this event means a channel was deleted. We assign discord threads to this event type equally. | Discord |
| VERIFICATION_SUCCESS | On supported property types, this event is a synthetic event created by Chatsight when a user completes the verification flow successfully. | All |
| VERIFICATION_FAILURE | On supported property types, this event is a synthetic event created by Chatsight when a user fails the verification flow. | All |
| PROPERTY_UPDATE | On supported property types, this event means that the internal settings of a property in the context of the platform - have been changed. For example, the name of the property was changed. | All |
| PROPERTY_INVITE_CREATE | When a user on the platform creates a link or invite that grants another user the ability to join the property. | Discord |
| PROPERTY_INVITE_DELETE | When a link or invite which grants another user the ability to join a property, is deleted. | Discord |
| MODERATION_LINK | On supported property types, this event is a synthetic event created by Chatsight when a CHAT_MESSAGE is deleted by link filtering. An accompanying CHAT_MESSAGE_DELETE will also be recorded. | All |
| SECURITY_EVENT | On supported property types, this event is a synthetic event created by Chatsight when we detect a security violation occurring on the property. This could be related to username impersonations, illegal integrations installed, or other platform-specific behavioral exploits we detect - provided they are enabled. | All |