teamwire_api.notifications¶
NotificationInfoBase¶
class NotificationInfoBase(object)
A base class for notification events
ChatMemberChangeInfo¶
class ChatMemberChangeInfo(NotificationInfoBase)
It contains information about changes to the members of a chat
It is used with the following events:
Events.CHAT_JOINED
: Event triggered when another user joins the chat. Theusers
attribute will contain the list of users that joined the chatEvents.CHAT_LEFT
: Event triggered when some user leaves the chat. Theusers
attribute will contain the list of users that left the chatEvents.CHAT_DELETED
: Event triggered when the bot is removed from a chat. Theusers
attribute will contain the list of users (including the bot's user) that were removed from the chat
Attributes
chat
:Chat
object. The chat this event refers tousers
: list ofUser
objects. The users that joined or left the chateditor
:User
object. The user who invited or removed the other user(s) to/from the chat
ChatChangeInfo¶
class ChatChangeInfo(NotificationInfoBase)
It contains information about chat creation, or changes to the title or administrators of a chat
It is used with the following events:
Events.CHAT_CREATED
: Event triggered when a new chat is created. Thechat
attribute will contain the newly created chatEvents.CHAT_TITLE_CHANGED
: Event triggered when the title of the chat has been changed. The 'title' attribute will contain the new title of the chatEvents.CHAT_ADMINS_CHANGED
: Event triggered when the administrators list of the chat has been changed. Theadded_admins
and theremoved_admins
attributes will respectively contain the lists of users that bacame admins or that were removed from adminsEvents.CHAT_ALLOW_SENDING_CHANGED
: Event triggered when theallow_sending
property of the chat has been changed. Theallow_sending
attribute will contain the new valueEvents.CHAT_ALLOW_MUTE_NOTIFICATIONS_CHANGED
: Event triggered when theallow_mute_notifications
property of the chat has been changed. Theallow_mute_notifications
attribute will contain the new valueEvents.CHAT_IS_CLOSED_CHANGED
: Event triggered when theis_closed
property of the chat has been changed. Theis_closed
attribute will contain the new value
Attributes
chat
:Chat
object. The chat this event refers totitle
: unicode (None if not present). The new title of the chatadded_admins
: list ofUser
objects. The users that were made chat administratorsremoved_admins
: list ofUser
objects. The users that were removed from the chat administratorsallow_sending
: boolean. Whether other members of the chat can send messagesallow_mute_notifications
: boolean. Whether members of the chat can mute notificationsis_closed
: boolean. Whether the chat has been closed or reopenededitor
:User
object. The user who initiated the operation
MessageDeletedInfo¶
class MessageDeletedInfo(NotificationInfoBase)
It contains information about the deletion of a message
It is used with the following events:
Events.MESSAGE_DELETED
: Event triggered when a message is deleted from a chat
Attributes
chat
:Chat
object. The chat this event refers tomessage_id
: unicode. The id of the deleted message
MessageReadInfo¶
class MessageReadInfo(NotificationInfoBase)
It contains information about the deletion of a message
It is used with the following events:
Events.MESSAGE_READ
: Event triggered when someone has read the latest messages in a chat
Attributes
chat
:Chat
object. The chat this event refers touser
:User
object. The user who read the messagemessage_id
: unicode. The id of the last read messageread_date
: datetime. When the message has been read