wxc_sdk.me.executive package

class wxc_sdk.me.executive.ExecAlertingMode(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

sequential = 'SEQUENTIAL'

Alerts assistants one at a time in the defined order.

simultaneous = 'SIMULTANEOUS'

Alerts all assistants at the same time.

class wxc_sdk.me.executive.ExecAlertRolloverAction(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

voice_messaging = 'VOICE_MESSAGING'

no_answer_processing = 'NO_ANSWER_PROCESSING'

forward = 'FORWARD'

class wxc_sdk.me.executive.ExecAlertClidNameMode(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

executive_originator = 'EXECUTIVE_ORIGINATOR'

Display executive name followed by caller name.

originator_executive = 'ORIGINATOR_EXECUTIVE'

Display caller name followed by executive name.

executive = 'EXECUTIVE'

Display only executive name.

originator = 'ORIGINATOR'

Display only caller name.

custom = 'CUSTOM'

Display a custom name.

class wxc_sdk.me.executive.ExecAlertClidPhoneNumberMode(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

executive = 'EXECUTIVE'

Display executive’s phone number.

originator = 'ORIGINATOR'

Display caller’s phone number.

custom = 'CUSTOM'

Display a custom phone number.

class wxc_sdk.me.executive.ExecAlert(*, alertingMode: ExecAlertingMode | None = None, nextAssistantNumberOfRings: int | None = None, rolloverEnabled: bool | None = None, rolloverAction: ExecAlertRolloverAction | None = None, rolloverForwardToPhoneNumber: str | None = None, rolloverWaitTimeInSecs: int | None = None, clidNameMode: ExecAlertClidNameMode | None = None, customCLIDName: str | None = None, customCLIDNameInUnicode: str | None = None, clidPhoneNumberMode: ExecAlertClidPhoneNumberMode | None = None, customCLIDPhoneNumber: str | None = None, **extra_data: Any)

Bases: ApiModel

alerting_mode: ExecAlertingMode | None

• SEQUENTIAL - Alerts assistants one at a time in the defined order.

next_assistant_number_of_rings: int | None

Number of rings before alerting the next assistant when in sequential mode.

rollover_enabled: bool | None

Controls whether the rollover timer (rolloverWaitTimeInSecs) is enabled. When set to true, rollover will trigger after the timer expires, even if assistants are still available. When false, rollover only occurs when no assistants remain.

rollover_action: ExecAlertRolloverAction | None

Specifies what happens when rollover is triggered: - VOICE_MESSAGING: Send to Voicemail—A voicemail is sent to the executive. - FORWARD: Forward—Calls are forwarded to a specified number. - NO_ANSWER_PROCESSING: Do nothing—No action is taken. Rollover is always triggered when no assistants remain for a filtered call. If the rollover timer is enabled, rollover can also be triggered when the timer expires, even if assistants are still available.

rollover_forward_to_phone_number: str | None

Phone number to forward calls to when rollover action is set to FORWARD.

rollover_wait_time_in_secs: int | None

Time in seconds to wait before applying the rollover action.

clid_name_mode: ExecAlertClidNameMode | None

• EXECUTIVE_ORIGINATOR - Display executive name followed by caller name.

custom_clidname: str | None

Custom caller ID name to display (deprecated).

custom_clidname_in_unicode: str | None

Custom caller ID name in Unicode format.

clid_phone_number_mode: ExecAlertClidPhoneNumberMode | None

• EXECUTIVE - Display executive’s phone number.

custom_clidphone_number: str | None

Custom caller ID phone number to display.

class wxc_sdk.me.executive.ExecOrAssistant(*, id: str | None = None, firstName: str | None = None, lastName: str | None = None, directNumber: str | None = None, extension: str | None = None, optInEnabled: bool | None = None, location: IdAndName | None = None, **extra_data: Any)

Bases: ApiModel

id: str | None

Unique identifier of the assistant.

first_name: str | None

First name of the assistant.

last_name: str | None

Last name of the assistant.

direct_number: str | None

Direct number of the assistant.

extension: str | None

Extension number of the assistant.

opt_in_enabled: bool | None

If true, the assistant can opt in to the executive assistant pool.

location: IdAndName | None

class wxc_sdk.me.executive.AssignedAssistants(*, allowOptInOutEnabled: bool | None = None, assistants: list[ExecOrAssistant] | None = None, **extra_data: Any)

Bases: ApiModel

allow_opt_in_out_enabled: bool | None

If true, the user can opt in or out of the executive assistant pool.

assistants: list[ExecOrAssistant] | None

List of assigned executive assistants.

class wxc_sdk.me.executive.AssistantSettings(*, forwardFilteredCallsEnabled: bool | None = None, forwardToPhoneNumber: str | None = None, executives: list[ExecOrAssistant] | None = None, **extra_data: Any)

Bases: ApiModel

forward_filtered_calls_enabled: bool | None

If true, the executive assistant forwards filtered calls to the forward to phone number.

forward_to_phone_number: str | None

Phone number to forward calls to.

executives: list[ExecOrAssistant] | None

List of assigned executives.

class wxc_sdk.me.executive.ExecCallFilterType(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

custom_call_filters = 'CUSTOM_CALL_FILTERS'

Choose this option to ensure only specific calls are sent to the executive assistant.

all_calls = 'ALL_CALLS'

Choose this option to send both internal and external calls to the executive assistant.

all_internal_calls = 'ALL_INTERNAL_CALLS'

Choose this option to send all the internal calls to the executive assistant.

all_external_calls = 'ALL_EXTERNAL_CALLS'

Choose this option to send all the external calls to the executive assistant.

class wxc_sdk.me.executive.ExecCallFilteringCriteriaItem(*, id: str | None = None, filterName: str | None = None, source: SelectiveFrom | None = None, activationEnabled: bool | None = None, filterEnabled: bool | None = None, **extra_data: Any)

Bases: ApiModel

id: str | None

Unique identifier for the filter criteria.

filter_name: str | None

Name of the criteria.

source: SelectiveFrom | None

activation_enabled: bool | None

Controls whether this filter criteria is active. When true, the criteria is evaluated for incoming calls. When false, the criteria is completely ignored and has no effect on call filtering.

filter_enabled: bool | None

Controls the action when this criteria matches a call. When true, matching calls are filtered (blocked). When false, matching calls are allowed through and take precedence over other filtering criteria, creating exceptions to let specific calls through.

class wxc_sdk.me.executive.ExecCallFiltering(*, enabled: bool | None = None, filterType: ExecCallFilterType | None = None, criteria: list[ExecCallFilteringCriteriaItem] | None = None, **extra_data: Any)

Bases: ApiModel

enabled: bool | None

Indicates if executive call filtering is enabled.

filter_type: ExecCallFilterType | None

criteria: list[ExecCallFilteringCriteriaItem] | None

List of call filtering criteria configured for executive call filtering.

class wxc_sdk.me.executive.ExecCallFilteringScheduleLevel(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

people = 'PEOPLE'

The schedule applies to the individual user.

location = 'LOCATION'

The schedule applies at the account level, potentially affecting multiple users.

class wxc_sdk.me.executive.ExecCallFilteringToNumber(*, type: PrimaryOrSecondary | None = None, phoneNumber: str | None = None, **extra_data: Any)

Bases: ApiModel

type: PrimaryOrSecondary | None

phone_number: str | None

The phone number to call.

class wxc_sdk.me.executive.ExecCallFilteringCriteria(*, id: str | None = None, filterName: str | None = None, scheduleName: str | None = None, scheduleType: ScheduleType | None = None, scheduleLevel: ExecCallFilteringScheduleLevel | None = None, callsFrom: SelectiveFrom | None = None, anonymousCallersEnabled: bool | None = None, unavailableCallersEnabled: bool | None = None, phoneNumbers: list[str] | None = None, filterEnabled: bool | None = None, callsToNumbers: list[ExecCallFilteringToNumber] | None = None, **extra_data: Any)

Bases: ApiModel

id: str | None

Unique identifier for the filter criteria.

filter_name: str | None

Name of the criteria.

schedule_name: str | None

Name of the schedule associated with this criteria.

schedule_type: ScheduleType | None

• holidays - The schedule is based on specific times.

schedule_level: ExecCallFilteringScheduleLevel | None

• PEOPLE - The schedule applies to the individual user.

calls_from: SelectiveFrom | None

• ANY_PHONE_NUMBER - The criteria applies to any phone number.

anonymous_callers_enabled: bool | None

Indicates if the criteria applies to anonymous callers.

unavailable_callers_enabled: bool | None

Indicates if the criteria applies to unavailable callers.

phone_numbers: list[str] | None

List of phone numbers that this filtering criteria applies to.

filter_enabled: bool | None

Controls the action when this criteria matches a call. When true, matching calls are filtered (blocked). When false, matching calls are allowed through and take precedence over other filtering criteria, creating exceptions to let specific calls through.

calls_to_numbers: list[ExecCallFilteringToNumber] | None

List of phone numbers to route calls to when this criteria matches.

class wxc_sdk.me.executive.ExecScreeningAlertType(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

silent = 'SILENT'

No audible alert is provided for executive screening.

ring_splash = 'RING_SPLASH'

A short ring (splash) is used as an alert for executive screening.

class wxc_sdk.me.executive.ExecScreening(*, enabled: bool | None = None, alertType: ExecScreeningAlertType | None = None, alertAnywhereLocationEnabled: bool | None = None, alertMobilityLocationEnabled: bool | None = None, alertSharedCallAppearanceLocationEnabled: bool | None = None, **extra_data: Any)

Bases: ApiModel

enabled: bool | None

Indicates if executive screening is enabled.

alert_type: ExecScreeningAlertType | None

alert_anywhere_location_enabled: bool | None

Indicates if alerts are enabled for Single Number Reach locations.

alert_mobility_location_enabled: bool | None

Indicates if alerts are enabled for Webex Go locations.

alert_shared_call_appearance_location_enabled: bool | None

Indicates if alerts are enabled for Shared Call Appearance locations.

class wxc_sdk.me.executive.MeExecutiveApi(*, session: RestSession, base: str | None = None)

Bases: ApiChild

alert_settings() → ExecAlert

Get User Executive Alert Settings

Get executive alert settings for the authenticated user.

Executive Alert settings in Webex allow you to control how calls are routed to executive assistants, including alerting mode, rollover options, and caller ID presentation. You can configure settings such as sequential or simultaneous alerting, and specify what happens when calls aren’t answered.

This API requires a user auth token with a scope of spark:telephony_config_read.

Return type:

ExecAlert

update_alert_settings(settings: ExecAlert)

Modify User Executive Alert Settings

Update executive alert settings for the authenticated user.

Executive Alert settings in Webex allow you to control how calls are routed to executive assistants, including alerting mode, rollover options, and caller ID presentation. You can configure settings such as sequential or simultaneous alerting, and specify what happens when calls aren’t answered.

This API requires a user auth token with a scope of spark:telephony_config_write.

Parameters:

settings (ExecAlert) – Alert settings

assigned_assistants() → AssignedAssistants

Get My Executive Assigned Assistants

Get list of assigned executive assistants for an authenticated user.

As an executive, you can add assistants to your executive pool to manage calls for you. You can set when and which types of calls they can handle. Assistants can opt in when needed or opt out when not required.

This API requires a user auth token with a scope of spark:telephony_config_read.

Return type:

AssignedAssistants

update_assigned_assistants(assigned_assistants: AssignedAssistants)

Update My Executive Assigned Assistants

Update assigned executive assistants for the authenticated user.

As an executive, you can add assistants to your executive pool to manage calls for you. You can set when and which types of calls they can handle. Assistants can opt in when needed or opt out when not required.

This API requires a user auth token with a scope of spark:telephony_config_write.

Parameters:

assigned_assistants (AssignedAssistants) – Assigned Assistants

Return type:

None

executive_assistant_settings() → AssistantSettings

Get My Executive Assistant Settings

Get settings for an executive assistant.

Executive assistants can make, answer, intercept, and route calls appropriately on behalf of their executive. Assistants can also set the call forwarding destination, and join or leave an executive’s pool.

This API requires a user auth token with a scope of spark:telephony_config_read.

Return type:

AssistantSettings

update_executive_assistant_settings(assistant_settings: AssistantSettings)

Update My Executive Assistant Settings

Update Settings for an executive assistant.

Executive assistants can make, answer, intercept, and route calls appropriately on behalf of their executive. Assistants can also set the call forwarding destination, and join or leave an executive’s pool.

This API requires a user auth token with a scope of spark:telephony_config_write.

Parameters:

assistant_settings (AssistantSettings) – My Executive Assistant Settings

executive_available_assistants() → list[ExecOrAssistant]

Get My Executive Available Assistants

Get a list of available executive assistants for the authenticated user.

As an executive, you can add assistants to your executive pool to manage calls for you. You can set when and which types of calls they can handle. Assistants can opt in when needed or opt out when not required.

This API requires a user auth token with a scope of spark:telephony_config_read.

Return type:

list[ExecOrAssistant]

executive_call_filtering_settings() → ExecCallFiltering

Get User Executive Call Filtering Settings

Get executive call filtering settings for the authenticated user.

Executive Call Filtering in Webex allows you to control which calls are allowed to reach the executive assistant based on custom criteria, such as specific phone numbers or call types. You can enable or disable call filtering and configure filter rules to manage incoming calls.

This API requires a user auth token with a scope of spark:telephony_config_read.

Return type:

ExecCallFiltering

update_executive_call_filtering_settings(settings: ExecCallFiltering)

Update User Executive Call Filtering Settings

Update executive call filtering settings for the authenticated user.

Executive Call Filtering in Webex allows you to control which calls are allowed to reach the executive assistant based on custom criteria, such as specific phone numbers or call types. You can enable or disable call filtering and configure filter rules to manage incoming calls.

This API requires a user auth token with a scope of spark:telephony_config_write.

Parameters:

settings (ExecCallFiltering) – Call Filtering Settings

create_call_filtering_criteria(settings: ExecCallFilteringCriteria) → str

Create User Executive Call Filtering Criteria

Create a new executive call filtering criteria for the authenticated user.

Executive Call Filtering Criteria in Webex allows you to define detailed filter rules for incoming calls. This API creates a new filter rule with the specified configuration, including schedule, phone numbers, and call routing preferences.

This API requires a user auth token with a scope of spark:telephony_config_write.

Parameters:

settings (ExecCallFilteringCriteria) – Call Filtering Settings

delete_call_filtering_criteria(id: str)

Delete User Executive Call Filtering Criteria

Delete a specific executive call filtering criteria for the authenticated user.

Executive Call Filtering Criteria in Webex allows you to manage detailed filter rules for incoming calls. This API removes a specific filter rule by its unique identifier.

This API requires a user auth token with a scope of spark:telephony_config_write.

Parameters:

id (str) – The id parameter specifies the unique identifier for the executive call filtering criteria. Example: Y2lzY29zcGFyazovL3VzL0NSSVRFUklBL2RHVnpkRjltYVd4MFpYST0.

Return type:

None

call_filtering_criteria(id: str) → ExecCallFilteringCriteria

Get User Executive Call Filtering Criteria Settings

Get executive call filtering criteria settings for the authenticated user.

Executive Call Filtering Criteria in Webex allows you to retrieve detailed configuration for a specific filter rule. This includes schedule settings, phone number filters, and call routing preferences for executive call filtering.

This API requires a user auth token with a scope of spark:telephony_config_read.

Parameters:

id (str) – The id parameter specifies the unique identifier for the executive call filtering criteria. Example: Y2lzY29zcGFyazovL3VzL0NSSVRFUklBL2RHVnpkRjltYVd4MFpYST0.

Return type:

ExecCallFilteringCriteria

update_call_filtering_criteria(id: str, settings: ExecCallFilteringCriteria) → str

Update User Executive Call Filtering Criteria Settings

Update executive call filtering criteria settings for the authenticated user.

Executive Call Filtering Criteria in Webex allows you to modify detailed configuration for a specific filter rule. This includes updating schedule settings, phone number filters, and call routing preferences for executive call filtering.

This API requires a user auth token with a scope of spark:telephony_config_write.

Parameters:

• id (str) – The id parameter specifies the unique identifier for the executive call filtering criteria. Example: Y2lzY29zcGFyazovL3VzL0NSSVRFUklBL2RHVnpkRjltYVd4MFpYST0.

• settings (ExecCallFilteringCriteria) – Call Filtering Settings

Return type:

str

screening_settings() → ExecScreening

Get User Executive Screening Settings

Get executive screening settings for the authenticated user.

Executive Screening in Webex allows you to manage how incoming calls are screened and alerted based on your preferences. You can enable or disable executive screening and configure alert types and locations for notifications.

This API requires a user auth token with a scope of spark:telephony_config_read.

Return type:

ExecScreening

update_screening_settings(settings: ExecScreening)

Modify User Executive Screening Settings

Update executive screening settings for the authenticated user.

Executive Screening in Webex allows you to manage how incoming calls are screened and alerted based on your preferences. You can enable or disable executive screening and configure alert types and locations for notifications.

This API requires a user auth token with a scope of spark:telephony_config_write.

Parameters:

settings (ExecScreening) – Screening Settings

base = 'telephony/config/people/me'