wxc_sdk.person_settings package

Person settings

class wxc_sdk.person_settings.PersonSettingsApi(session: RestSession)[source]

Bases: ApiChild

API for all user level settings

agent_caller_id: AgentCallerIdApi

agent caller id Api

appservices: AppServicesApi

Person’s Application Services Settings

base = 'people'
barge: BargeApi

Barge In Settings for a Person

dnd: DndApi

Do Not Disturb Settings for a Person

call_intercept: CallInterceptApi

Call Intercept Settings for a Person

call_recording: CallRecordingApi

Call Recording Settings for a Person

call_waiting: CallWaitingApi

Call Waiting Settings for a Person

calling_behavior: CallingBehaviorApi

Person’s Calling Behavior

caller_id: CallerIdApi

Caller ID Settings for a Person

exec_assistant: ExecAssistantApi

Executive Assistant Settings for a Person

forwarding: PersonForwardingApi

Forwarding Settings for a Person

hoteling: HotelingApi

Hoteling Settings for a Person

monitoring: MonitoringApi

Person’s Monitoring Settings

numbers: NumbersApi

Phone Numbers for a Person

permissions_in: IncomingPermissionsApi

Incoming Permission Settings for a Person

permissions_out: OutgoingPermissionsApi

Person’s Outgoing Calling Permissions Settings

privacy: PrivacyApi

Person’s Privacy Settings

push_to_talk: PushToTalkApi

Push-to-Talk Settings for a Person

receptionist: ReceptionistApi

Receptionist Client Settings for a Person

schedules: ScheduleApi

Schedules for a Person

voicemail: VoicemailApi

Voicemail Settings for a Person

reset_vm_pin(person_id: str, org_id: str | None = None)[source]

Reset Voicemail PIN

Reset a voicemail PIN for a person.

The voicemail feature transfers callers to voicemail based on your settings. You can then retrieve voice messages via Voicemail. A voicemail PIN is used to retrieve your voicemail messages.

This API requires a full or user administrator auth token with the spark-admin:people_write scope.

Parameters:

  • person_id – Unique identifier for the person.

  • org_id – Person is in this organization. Only admin users of another organization (such as partners) may use this parameter as the default is the same organization as the token used to access API.

devices(person_id: str, org_id: str | None = None) → PersonDevicesResponse[source]

Get all devices for a person.

This requires a full or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

  • person_id (str) – Person to retrieve devices for

  • org_id (str) – organization that person belongs to

Returns:

device info for user

Return type:

PersonDevicesResponse

class wxc_sdk.person_settings.DeviceOwner(*, id: str, lastName: str, firstName: str, type: UserType)[source]

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.

owner_id: str

unique identifier for user or workspace the device is owned by

last_name: str

last name of device owner.

first_name: str

First name of device owner.

owner_type: UserType

user or workspace?

class wxc_sdk.person_settings.DeviceActivationState(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)[source]

Bases: str, SafeEnum

An enumeration.

activating = 'ACTIVATING'
activated = 'ACTIVATED'
deactivated = 'DEACTIVATED'
class wxc_sdk.person_settings.TelephonyDevice(*, id: str, description: list[str], model: str, mac: str | None = None, ipAddress: str | None = None, primaryOwner: bool, type: PrimaryOrShared, owner: DeviceOwner, activationState: DeviceActivationState)[source]

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.

device_id: str

Unique identifier for a device.

description: list[str]

Comma separated array of tags used to describe device.

model: str

Identifier for device model.

mac: str | None

MAC address of device.

ip_address: str | None

IP address of device.

primary_owner: bool

This field indicates whether the person or the workspace is the owner of the device, and points to a primary Line/Port of the device.

device_type: PrimaryOrShared

Indicates if the line is acting as a primary line or a shared line for this device.

owner: DeviceOwner

Owner of device.

activation_state: DeviceActivationState

Activation state of device.

class wxc_sdk.person_settings.PersonDevicesResponse(*, devices: list[wxc_sdk.person_settings.TelephonyDevice], maxDeviceCount: int)[source]

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.

devices: list[wxc_sdk.person_settings.TelephonyDevice]

Array of devices available to person.

max_device_count: int

Maximum number of devices a person can be assigned to.

Submodules