wxc_sdk.events package

class wxc_sdk.events.EventData(*, id: str | None = None, title: str | None = None, roomId: str | None = None, type: str | None = None, roomType: str | None = None, isRoomHidden: bool | None = None, orgId: str | None = None, text: str | None = None, files: list[str] | None = None, personId: str | None = None, personEmail: str | None = None, personOrgId: str | None = None, personDisplayName: str | None = None, isModerator: bool | None = None, isMonitor: bool | None = None, meetingId: str | None = None, creatorId: str | None = None, host: object | None = None, attendees: list[Any] | None = None, transcriptionEnabled: str | None = None, recordingEnabled: str | None = None, hasPostMeetingsChat: str | None = None, created: datetime | None = None, updated: datetime | None = None, markdown: str | None = None, html: str | None = None, mentionedPeople: list[str] | None = None, fileContentUrl: str | None = None, fileId: str | None = None, pageNumber: int | None = None, isLocked: bool | None = None, isPublic: bool | None = None, madePublic: datetime | None = None, isAnnouncementOnly: bool | None = None)

Bases: ApiModel

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

id: str | None

title: str | None

room_id: str | None

type: str | None

room_type: str | None

is_room_hidden: bool | None

org_id: str | None

text: str | None

files: list[str] | None

person_id: str | None

person_email: str | None

person_org_id: str | None

person_display_name: str | None

is_moderator: bool | None

is_monitor: bool | None

meeting_id: str | None

creator_id: str | None

host: object | None

The meeting’s host data

attendees: list[Any] | None

Common Identity (CI) authenticated meeting attendees

transcription_enabled: str | None

indicates whether or not the Voice Assistant was enabled during the meeting. If true a transcript should be available a couple minutes after the meeting ended at the meetingTranscripts resource

recording_enabled: str | None

indicates if recording was enabled for all or parts of the meeting. If true a recording should be available shortly after the meeting ended at the recordings resource

has_post_meetings_chat: str | None

indicates i chat messages were exchanged during the meeting in the meetings client (not the unified client). If true these messages can be accessed by a compliance officer at the postMeetingsChat resource. Meetings chat collection must be custom enabled.

created: datetime | None

updated: datetime | None

markdown: str | None

html: str | None

mentioned_people: list[str] | None

file_content_url: str | None

file_id: str | None

page_number: int | None

is_locked: bool | None

is_public: bool | None

made_public: datetime | None

is_announcement_only: bool | None

class wxc_sdk.events.ComplianceEvent(*, id: str | None = None, resource: EventResource | None = None, type: EventType | None = None, appId: str | None = None, actorId: str | None = None, orgId: str | None = None, created: datetime | None = None, data: EventData | None = None)

Bases: ApiModel

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

id: str | None

The unique identifier for the event.

resource: EventResource | None

The type of resource in the event.

type: EventType | None

The action which took place in the event.

app_id: str | None

The ID of the application for the event.

actor_id: str | None

The ID of the person who performed the action.

org_id: str | None

The ID of the organization for the event.

created: datetime | None

The date and time of the event.

data: EventData | None

The event’s data representation. This object will contain the event’s resource, such as memberships, messages, meetings, tabs, rooms or attachmentActions at the time the event took place.

class wxc_sdk.events.EventResource(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

messages = 'messages'

State changed on a messages resource

memberships = 'memberships'

State changed on a memberships resource

meetings = 'meetings'

State change on a meeting ( here combined with type = ‘ended’ )

meeting_transcripts = 'meetingTranscripts'

State change on a automatic transcript resource for Webex Assistant

meeting_messages = 'meetingMessages'

State changed on a meeting message, i.e. message exchanged as part of a meeting

tabs = 'tabs'

State changed on a room tabs in a space

rooms = 'rooms'

State changed on a space classification

attachment_actions = 'attachmentActions'

State changed on a card attachment

files = 'files'

State changed on a file download

file_transcodings = 'file_transcodings'

State change on a file preview

class wxc_sdk.events.EventType(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

created = 'created'

The resource has been created

updated = 'updated'

A property on the resource has been updated

deleted = 'deleted'

The resource has been deleted

ended = 'ended'

The meeting has ended

read = 'read'

class wxc_sdk.events.EventsApi(*, session: RestSession, base: str | None = None)

Bases: ApiChild

Events are generated when actions take place within Webex, such as when someone creates or deletes a message. The Events API can only be used by a Compliance Officer with an API access token that contains the spark-compliance:events_read scope. See the Compliance Guide for more information.

list(resource: EventResource | None = None, type_: EventType | None = None, actor_id: str | None = None, from_: datetime | None = None, to_: datetime | None = None, **params) → Generator[ComplianceEvent, None, None]

List events in your organization. Several query parameters are available to filter the events returned in the response. Long result sets will be split into pages.

Parameters:

• resource (EventResource) – List events with a specific resource type.

• type (EventType) – List events with a specific event type.

• actor_id (str) – List events performed by this person, by person ID.

• from (str) – List events which occurred after a specific date and time.

• to (str) – List events which occurred before a specific date and time. If unspecified, or set to a time in the future, lists events up to the present.

details(event_id: str) → ComplianceEvent

Shows details for an event, by event ID. Specify the event ID in the eventId parameter in the URI.

Parameters:

event_id (str) – The unique identifier for the event.

base = 'events'

session: RestSession

REST session