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 TypeDescriptionSupported
USER_JOINWhen 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_REMOVEWhen a user is removed by members with permission to remove a user, or the user elects to remove themselves.All
USER_BANWhen a user is banned (through platform-specific means) from a property. This ban is enforced by the platform itself.All
USER_BAN_REMOVEOn supported property types, when a user ban is removed.Discord
USER_UPDATEWhen 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_MESSAGEWhen a chat message of any kind, is created.All
CHAT_MESSAGE_DELETEOn supported property types, when a chat message of any kind, is deleted.Discord
CHANNEL_CREATEOn 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_DELETEOn 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_SUCCESSOn supported property types, this event is a synthetic event created by Chatsight when a user completes the verification flow successfully.All
VERIFICATION_FAILUREOn supported property types, this event is a synthetic event created by Chatsight when a user fails the verification flow.All
PROPERTY_UPDATEOn 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_CREATEWhen a user on the platform creates a link or invite that grants another user the ability to join the property.Discord
PROPERTY_INVITE_DELETEWhen a link or invite which grants another user the ability to join a property, is deleted.Discord
MODERATION_LINKOn 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_EVENTOn 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