wxc_sdk.person_settings.barge module

Person barge settings API

class wxc_sdk.person_settings.barge.BargeSettings(*, enabled: bool, toneEnabled: bool)[source]

Bases: ApiModel

Barge settings

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.

enabled: bool

indicates if the Barge In feature is enabled.

tone_enabled: bool

Indicates that a stutter dial tone will be played when a person is barging in on the active call.

class wxc_sdk.person_settings.barge.BargeApi(*, session: RestSession, workspaces: bool = False, locations: bool = False)[source]

Bases: PersonSettingsApiChild

API for person’s barge settings

feature = 'bargeIn'
read(person_id: str, org_id: str | None = None) → BargeSettings[source]

Retrieve a Person’s Barge In Settings

The Barge In feature enables you to use a Feature Access Code (FAC) to answer a call that was directed to another subscriber, or barge-in on the call if it was already answered. Barge In can be used across locations.

This API requires a full, user, or read-only administrator auth token with a scope of spark-admin:people_read or a user auth token with spark:people_read scope can be used by a person to read their own settings.

Parameters:

  • person_id (str) – Unique identifier for the person.

  • org_id (str) – 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.

Returns:

barge settings for specific user

Return type:

BargeSettings

configure(person_id: str, barge_settings: BargeSettings, org_id: str | None = None)[source]

Configure a Person’s Barge In Settings

The Barge In feature enables you to use a Feature Access Code (FAC) to answer a call that was directed to another subscriber, or barge-in on the call if it was already answered. Barge In can be used across locations.

This API requires a full or user administrator auth token with the spark-admin:people_write scope or a user auth token with spark:people_write scope can be used by a person to update their own settings.

Parameters:

  • person_id (str) – Unique identifier for the person.

  • barge_settings (BargeSettings) – new setting to be applied

  • 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.

base = ''
session: RestSession

REST session