wxc_sdk.telephony.location package

class wxc_sdk.telephony.location.CallingLineId(*, name: str | None = None, phoneNumber: str | None = None, **extra_data: Any)

Bases: ApiModel

Location calling line information.

name: str | None

Group calling line ID name. By default it will be org name. when updating the name make sure to also include the phone number

phone_number: str | None

Directory Number / Main number in E164 Forma

class wxc_sdk.telephony.location.PSTNConnection(*, type: RouteType, id: str, **extra_data: Any)

Bases: ApiModel

Connection details

type: RouteType

Webex Calling location only supports TRUNK and ROUTE_GROUP connection type.

id: str

A unique identifier of route type.

class wxc_sdk.telephony.location.TelephonyLocation(*, id: str | None = None, name: str | None = None, announcementLanguage: str | None = None, callingLineId: CallingLineId | None = None, connection: PSTNConnection | None = None, subscriptionId: str | None = None, externalCallerIdName: str | None = None, userLimit: int | None = None, pAccessNetworkInfo: str | None = None, outsideDialDigit: str | None = None, enforceOutsideDialDigit: bool | None = None, routingPrefix: str | None = None, defaultDomain: str | None = None, chargeNumber: str | None = None, useChargeNumberForPChargeInfo: bool | None = None, e911SetupRequired: bool | None = None, **extra_data: Any)

Bases: ApiModel

location_id: str | None

A unique identifier for the location.

name: str | None

The name of the location.

announcement_language: str | None

Location’s phone announcement language.

calling_line_id: CallingLineId | None

Location calling line information.

connection: PSTNConnection | None

Connection details are only returned for local PSTN types of TRUNK or ROUTE_GROUP.

subscription_id: str | None

PSTN connection ID given for locations with a PSTN subscription.

external_caller_id_name: str | None

External Caller ID Name value. Unicode characters.

user_limit: int | None

Limit on the number of people at the location, Read-Only.

p_access_network_info: str | None

Emergency Location Identifier for a location. Set this field to provide the SIP access network information to the provider which will be used to populate the SIP P-Access-Network-Info header. This is helpful to establish the location of a device when you make an emergency call.

outside_dial_digit: str | None

Must dial to reach an outside line, default is None.

enforce_outside_dial_digit: bool | None

True when enforcing outside dial digit at location level to make PSTN calls.

routing_prefix: str | None

Must dial a prefix when calling between locations having same extension within same location.

default_domain: str | None

IP Address, hostname, or domain. Read-Only.

charge_number: str | None

Chargeable number for the line placing the call. When this is set, all calls placed from this location will include a P-Charge-Info header with the selected number in the SIP INVITE.

use_charge_number_for_pcharge_info: bool | None

Indicates whether the location’s chargeNumber (if set) is enabled for use as the P-Charge-Info header in the SIP INVITE for all PSTN calls placed from this location. The field is returned as true if the location’s PSTN allows use of the chargeNumber.

e911_setup_required: bool | None

True if E911 setup is required.

class wxc_sdk.telephony.location.CallBackSelected(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

location_number = 'LOCATION_NUMBER'

Location TN.

location_member_number = 'LOCATION_MEMBER_NUMBER'

Assigned number of a user, workspace, virtual line or hunt group in the location.

class wxc_sdk.telephony.location.ContactDetails(*, personId: str | None = None, firstName: str | None = None, lastName: str | None = None, department: str | None = None, phoneNumber: str | None = None, extension: str | None = None, locationId: str | None = None, featureId: str | None = None, **extra_data: Any)

Bases: ApiModel

person_id: str | None

ID of person.

first_name: str | None

First name of person.

last_name: str | None

Last name of person.

department: str | None

Department ID of person.

phone_number: str | None

Phone number of person.

extension: str | None

Extension of person.

location_id: str | None

Location ID of person.

feature_id: str | None

Location feature ID of the contact. Supported location feature types are Auto Attendant, Call Queue, Hunt Group, Single Number Reach, and Paging Group.

class wxc_sdk.telephony.location.LocationECBNLocation(*, phoneNumber: str | None = None, name: str | None = None, effectiveLevel: ECBNEffectiveLevel | None = None, effectiveValue: str | None = None, quality: ECBNQuality | None = None, **extra_data: Any)

Bases: ApiModel

phone_number: str | None

The location DN.

name: str | None

The name of the location.

effective_level: ECBNEffectiveLevel | None

The source from which the emergency calling line ID (CLID) is selected for an actual emergency call, applying fallback rules as necessary.

effective_value: str | None

Location calling line ID (CLID) number. Avaliable only when number is present and quality would be invalid.

quality: ECBNQuality | None

Used to represent whether a number is a recommended ECBN.

class wxc_sdk.telephony.location.LocationECBNLocationMember(*, phoneNumber: str | None = None, firstName: str | None = None, lastName: str | None = None, memberId: str | None = None, memberType: UserType | None = None, effectiveLevel: ECBNEffectiveLevel | None = None, effectiveValue: str | None = None, quality: ECBNQuality | None = None, **extra_data: Any)

Bases: ApiModel

phone_number: str | None

The member DN.

first_name: str | None

The member first name.

last_name: str | None

The member last name. Always contains . if the member is a place.

member_id: str | None

Member ID of user/place/virtual line/hunt group within the location.

member_type: UserType | None

Member Type.

effective_level: ECBNEffectiveLevel | None

The source from which the emergency calling line ID (CLID) is selected for an actual emergency call, applying fallback rules as necessary.

effective_value: str | None

Location CLID number. Avaliable only when number is present and quality would be invalid.

quality: ECBNQuality | None

Used to represent whether a number is a recommended ECBN.

class wxc_sdk.telephony.location.LocationECBN(*, locationInfo: LocationECBNLocation | None = None, locationMemberInfo: LocationECBNLocationMember | None = None, selected: CallBackSelected | None = None, **extra_data: Any)

Bases: ApiModel

location_info: LocationECBNLocation | None

Data relevant to this location.

location_member_info: LocationECBNLocationMember | None

Data relevant to the user/place/virtual line/hunt group (member) selected for ECBN.

selected: CallBackSelected | None

Selected number type to configure emergency call back.

class wxc_sdk.telephony.location.BlockingDisableCalling(*, lastLocation: bool | None = None, trunksInUseCount: int | None = None, usersInUseCount: int | None = None, workspacesInUseCount: int | None = None, virtualLineInUseCount: int | None = None, numbersOrderPending: bool | None = None, **extra_data: Any)

Bases: ApiModel

last_location: bool | None

Indicates if this is the last calling location in the organization.

trunks_in_use_count: int | None

Number of trunks in use at this location.

users_in_use_count: int | None

Number of users in use at this location.

workspaces_in_use_count: int | None

Number of workspaces in use at this location.

virtual_line_in_use_count: int | None

Number of virtual lines in use at this location.

numbers_order_pending: bool | None

Indicates if there are pending number orders for this location.

class wxc_sdk.telephony.location.NonBlockingDisableCalling(*, numbersPresent: bool | None = None, **extra_data: Any)

Bases: ApiModel

numbers_present: bool | None

Indicates if there are phone numbers at this location.

class wxc_sdk.telephony.location.BlockingUnlessForced(*, nonUserEntitiesInUse: bool | None = None, trunksCount: int | None = None, **extra_data: Any)

Bases: ApiModel

non_user_entities_in_use: bool | None

Indicates if there are non-user entities in use at this location that would block disabling unless force is applied.

trunks_count: int | None

Total number of trunks at this location.

class wxc_sdk.telephony.location.LocationDeleteStatus(value=<no_arg>, names=None, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: str, SafeEnum

An enumeration.

blocked = 'BLOCKED'

Disable Webex Calling location operation is blocked and cannot proceed.

unblocked = 'UNBLOCKED'

Disable Webex Calling location operation can proceed without any restrictions.

force_required = 'FORCE_REQUIRED'

Disable Webex Calling location operation requires forceDelete to be set to true.

class wxc_sdk.telephony.location.SafeDeleteCheckResponse(*, locationDeleteStatus: LocationDeleteStatus | None = None, blocking: BlockingDisableCalling | None = None, nonBlocking: NonBlockingDisableCalling | None = None, blockingUnlessForced: BlockingUnlessForced | None = None, **extra_data: Any)

Bases: ApiModel

location_delete_status: LocationDeleteStatus | None

Status of disable calling location safe delete check.

blocking: BlockingDisableCalling | None

non_blocking: NonBlockingDisableCalling | None

blocking_unless_forced: BlockingUnlessForced | None

class wxc_sdk.telephony.location.LocationCallCaptions(*, locationClosedCaptionsEnabled: bool | None = None, locationTranscriptsEnabled: bool | None = None, orgClosedCaptionsEnabled: bool | None = None, orgTranscriptsEnabled: bool | None = None, useOrgSettingsEnabled: bool | None = None, **extra_data: Any)

Bases: ApiModel

location_closed_captions_enabled: bool | None

Location-level closed captions are enabled or disabled.

location_transcripts_enabled: bool | None

Location-level transcripts are enabled or disabled.

org_closed_captions_enabled: bool | None

Organization closed captions are enabled or disabled.

org_transcripts_enabled: bool | None

Organization transcripts are enabled or disabled.

use_org_settings_enabled: bool | None

If useOrgSettingsEnabled is true, organization-level settings will control the location’s closed captions and transcripts. Otherwise, location-level settings are used.

class wxc_sdk.telephony.location.TelephonyLocationApi(session: wxc_sdk.rest.RestSession)

Bases: ApiChild

__init__(session: RestSession)

emergency_services: LocationEmergencyServicesApi

emergency services

intercept: LocationInterceptApi

call intercept settings

internal_dialing: InternalDialingApi

internal dialing settings

moh: LocationMoHApi

moh settings

number: LocationNumbersApi

number settings

permissions_out: OutgoingPermissionsApi

outgoing permissions settings

voicemail: LocationVoicemailSettingsApi

Location VM settings (only enable/disable transcription for now)

receptionist_contacts_directory: ReceptionistContactsDirectoryApi

Receptionist contacts directories

generate_password(location_id: str, generate: list[str] | None = None, org_id: str | None = None)

Generate example password for Location

Generates an example password using the effective password settings for the location. If you don’t specify anything in the generate field or don’t provide a request body, then you will receive a SIP password by default.

It’s used while creating a trunk and shouldn’t be used anywhere else.

Generating an example password requires a full or write-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:

• location_id (str) – Location for which example password has to be generated.

• generate (list[str]) – password settings array.

• org_id (str) – Organization to which location belongs.

Returns:

new password

Return type:

str

validate_extensions(location_id: str, extensions: list[str], org_id: str | None = None) → ValidateExtensionsResponse

Validate Extensions

Validate extensions for a specific location.

Validating extensions requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:

• location_id (str) – Validate extensions for this location.

• extensions (list[str]) – Array of extensions that will be validated.

• org_id (str) – Validate extensions for this organization.

Returns:

Validation result

Return type:

wxc_sdk.common.ValidateExtensionsResponse

details(location_id: str, org_id: str | None = None) → TelephonyLocation

Get Location Webex Calling Details

Shows Webex Calling details for a location, by ID.

Specify the location ID in the locationId parameter in the URI.

Searching and viewing location in your organization requires an administrator auth token with the spark-admin:telephony_config_read scope.

Parameters:

• location_id (str) – Retrieve Webex Calling location attributes for this location.

• org_id (str) – Retrieve Webex Calling location attributes for this organization.

Returns:

Webex Calling details for location

Return type:

TelephonyLocation

enable_for_calling(location: Location, org_id: str | None = None) → str

Enable a Location for Webex Calling

Enable a location by adding it to Webex Calling. This add Webex Calling support to a location created using the POST /v1/locations API.

Locations are used to support calling features which can be defined at the location level.

This API requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Returns:

A unique identifier for the location.

Return type:

str

list(name: str | None = None, order: str | None = None, org_id: str | None = None) → Generator[TelephonyLocation, None, None]

List Locations Webex Calling Details

Lists Webex Calling locations for an organization with Webex Calling details.

Searching and viewing locations with Webex Calling details in your organization require an administrator auth token with the spark-admin:telephony_config_read scope.

Parameters:

• name (str) – List locations whose name contains this string.

• order (str) – Sort the list of locations based on name, either asc or desc.

• org_id (str) – List locations for this organization.

Returns:

generator of TelephonyLocation instances

update(location_id: str, settings: TelephonyLocation, org_id: str | None = None) → str | None

Update Location Webex Calling Details

Update Webex Calling details for a location, by ID.

Specifies the location ID in the locationId parameter in the URI.

Modifying the connection via API is only supported for the local PSTN types of TRUNK and ROUTE_GROUP.

Updating a location in your organization requires an administrator auth token with the spark-admin:telephony_config_write scope.

Example :

api.telephony.location.update(location_id=location_id,
                              settings=TelephonyLocation(
                                  calling_line_id=CallingLineId(
                                      phone_number=tn),
                                  routing_prefix=routing_prefix,
                                  outside_dial_digit='9'))

Parameters:

• location_id (str) – Updating Webex Calling location attributes for this location.

• settings (TelephonyLocation) – settings to update

• org_id (str) – Updating Webex Calling location attributes for this organization.

Returns:

batch job id of update job if one is created

Return type:

str

change_announcement_language(location_id: str, language_code: str, agent_enabled: bool | None = None, service_enabled: bool | None = None, org_id: str | None = None)

Change Announcement Language

Change announcement language for the given location.

Change announcement language for current people/workspaces and/or existing feature configurations. This does not change the default announcement language which is applied to new users/workspaces and new feature configurations.

Changing announcement language for the given location requires a full administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:

• location_id (str) – Change announcement language for this location.

• language_code (str) – Language code.

• agent_enabled (bool) – Set to true to change announcement language for existing people and workspaces.

• service_enabled (bool) – Set to true to change announcement language for existing feature configurations.

• org_id (str) – Change announcement language for this organization.

read_ecbn(location_id: str, org_id: str | None = None) → LocationECBN

Get a Location Emergency callback number

Get location emergency callback number.

• To retrieve location callback number requires a full, user or read-only administrator or location

administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

• location_id (str) – Update location attributes for this location.

• org_id (str) – Update location attributes for this organization.

Return type:

LocationECBN

update_ecbn(location_id: str, selected: CallBackSelected, location_member_id: str | None = None, org_id: str | None = None)

Update a Location Emergency callback number

Update details for a location emergency callback number.

• Updating a location callback number requires a full administrator or location administrator auth token with a

scope of spark-admin:telephony_config_write.

Parameters:

• location_id (str) – Update location attributes for this location.

• selected (CallBackSelected) – Selected number type to configure emergency call back.

• location_member_id (str) – Member ID of user/place within the location. Required if LOCATION_MEMBER_NUMBER is selected.

• org_id (str) – Update location attributes for this organization.

Return type:

None

device_settings(location_id: str, org_id: str | None = None) → DeviceCustomization

Get device override settings for a location.

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

Parameters:

• location_id (str) – Unique identifier for the location

• org_id (str) – Settings on the device in this organization

Returns:

device customization response

Return type:

DeviceCustomization

phone_numbers_available_for_external_caller_id(location_id: str, phone_number: List[str] | None = None, owner_name: str | None = None, person_id: str | None = None, org_id: str | None = None, **params) → Generator[AvailableNumber, None, None]

Get the List of Phone Numbers Available for External Caller ID

Get the list of phone numbers available for external caller ID usage by a Webex Calling entity (such as a person, virtual line, or workspace) within the specified location. Numbers from the specified location are returned and cross location numbers are returned as well where the number’s location has the same country, PSTN provider, and zone (only applicable for India locations) as the specified location. When personId is specified, and the person belongs to a cisco PSTN location, has a mobile number assigned as primary DN, and does not have a billing plan, only the assigned mobile number is returned as the available number for caller ID.

The available numbers APIs help identify candidate numbers and their owning entities to simplify the assignment or association of these numbers to members or features.

Retrieving this list requires a full or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

• location_id (str) – Retrieve available external caller ID numbers for this location.

• phone_number (list[str]) – Filter phone numbers based on the provided list in the phoneNumber array.

• owner_name (str) – Return the list of phone numbers that are owned by the given ownerName. Maximum length is 255.

• person_id (str) – Retrieve available external caller ID numbers for this person. If personId is not provided it may result in the unsuccessful assignment of the returned number. This parameter has no effect when workspace or virtual line ID is used.

• org_id (str) – List numbers for this organization.

Returns:

Generator yielding AvailableNumber instances

phone_numbers(location_id: str, phone_number: List[str] | None = None, owner_name: str | None = None, org_id: str | None = None, **params) → Generator[AvailableNumber, None, None]

Get Available Phone Numbers for a Location with Given Criteria

List the service and standard PSTN numbers that are available to be assigned as the location’s main number. These numbers are associated with the location specified in the request URL and can be active/inactive and assigned to an owning entity or unassigned.

The available numbers APIs help identify candidate numbers and their owning entities to simplify the assignment or association of these numbers to members or features.

Retrieving this list requires a full or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

• location_id (str) – Return the list of phone numbers for this location within the given organization. The maximum length is 36.

• phone_number (list[str]) – Filter phone numbers based on the comma-separated list provided in the phoneNumber array.

• owner_name (str) – Return the list of phone numbers that are owned by the given ownerName. Maximum length is 255.

• org_id (str) – List numbers for this organization.

Returns:

Generator yielding AvailableNumber instances

webex_go_available_phone_numbers(location_id: str, phone_number: List[str] | None = None, org_id: str | None = None, **params) → Generator[AvailableNumber, None, None]

Get Webex Go Available Phone Numbers

List standard numbers that are available to be assigned as the webex go phone number. These numbers are associated with the location specified in the request URL, can be active or inactive, and are unassigned.

The available numbers APIs help identify candidate numbers and their owning entities to simplify the assignment or association of these numbers to members or features.

Retrieving this list requires a full, read-only or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

• location_id (str) – Return the list of phone numbers for this location within the given organization. The maximum length is 36.

• phone_number (list[str]) – Filter phone numbers based on the comma-separated list provided in the phoneNumber array.

• org_id (str) – List numbers for this organization.

Returns:

Generator yielding AvailableNumber instances

ecbn_available_phone_numbers(location_id: str, phone_number: List[str] | None = None, owner_name: str | None = None, org_id: str | None = None, **params) → Generator[AvailableNumber, None, None]

Get Location ECBN Available Phone Numbers

List standard numbers that are available to be assigned as the location’s emergency callback number. These numbers are associated with the location specified in the request URL, can be active or inactive, and are assigned to an owning entity.

The available numbers APIs help identify candidate numbers and their owning entities to simplify the assignment or association of these numbers to members or features.

Retrieving this list requires a full, read-only or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

• location_id (str) – Return the list of phone numbers for this location within the given organization. The maximum length is 36.

• phone_number (list[str]) – Filter phone numbers based on the comma-separated list provided in the phoneNumber array.

• owner_name (str) – Return the list of phone numbers that are owned by the given ownerName. Maximum length is 255.

• org_id (str) – List numbers for this organization.

Returns:

Generator yielding AvailableNumber instances

charge_number_available_phone_numbers(location_id: str, phone_number: List[str] | None = None, owner_name: str | None = None, org_id: str | None = None, **params) → Generator[AvailableNumber, None, None]

Get Available Charge Numbers for a Location with Given Criteria

List the numbers that are available to be assigned as the location’s charge number.

These numbers are non-toll-free and non-mobile numbers assigned to the location specified in the request URL.

Retrieving this list requires a full or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

• location_id (str) – Return the list of available charge numbers for this location within the given organization. The maximum length is 36.

• phone_number (list[str]) – Filter phone numbers based on the comma-separated list provided in the phoneNumber array.

• owner_name (str) – Return the list of phone numbers that are owned by the given ownerName. Maximum length is 255.

• org_id (str) – List numbers for this organization.

Returns:

Generator yielding AvailableNumber instances

call_intercept_available_phone_numbers(location_id: str, phone_number: List[str] | None = None, owner_name: str | None = None, org_id: str | None = None, **params) → Generator[AvailableNumber, None, None]

Get Location Call Intercept Available Phone Numbers

List service and standard numbers that are available to be assigned as the location’s call intercept number. These numbers are associated with the location specified in the request URL and can be active/inactive and assigned to an owning entity or unassigned.

The available numbers APIs help identify candidate numbers and their owning entities to simplify the assignment or association of these numbers to members or features.

Retrieving this list requires a full or read-only administrator or location administrator auth token with a scope of spark-admin:telephony_config_read.

Parameters:

• location_id (str) – Return the list of phone numbers for this location within the given organization. The maximum length is 36.

• phone_number (list[str]) – Filter phone numbers based on the comma-separated list provided in the phoneNumber array.

• owner_name (str) – Return the list of phone numbers that are owned by the given ownerName. Maximum length is 255.

• org_id (str) – List numbers for this organization.

Returns:

Generator yielding LocationAvailableNumberObject instances

base = 'telephony/config/locations'

create_receptionist_contact_directory(location_id: str, name: str, contacts: List[str], org_id: str | None = None) → str

Create a Receptionist Contact Directory

Create a new Receptionist Contact Directory for a location.

Receptionist Contact Directories can be used to create named directories of users and/or location features (Auto Attendant, Call Queue, Hunt Group, Single Number Reach, and Paging Group).

Adding a directory requires a full or write-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:

• location_id (str) – Add a Receptionist Contact Directory to this location.

• name (str) – Receptionist Contact Directory name. The directory name should be greater than 0 and less than 41 characters in length.

• contacts (list[str]) – Non-empty array of users or location features assigned to this Receptionist Contact Directory.

• org_id (str) – Add a Receptionist Contact Directory to this organization.

Return type:

str

list_receptionist_contact_directories(location_id: str, org_id: str | None = None) → List[IdAndName]

Read list of Receptionist Contact Directories

List all Receptionist Contact Directories for a location.

Receptionist Contact Directories can be used to create named directories of users.

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

Parameters:

• location_id (str) – List Receptionist Contact Directories for this location.

• org_id (str) – List Receptionist Contact Directories for this organization.

Return type:

list[IdAndName]

receptionist_contact_directory_details(location_id: str, directory_id: str, search_criteria_mode_or: bool | None = None, first_name: str | None = None, last_name: str | None = None, phone_number: str | None = None, extension: str | None = None, person_id: str | None = None, org_id: str | None = None) → List[ContactDetails]

Get details for a Receptionist Contact Directory

Get details for a specific Receptionist Contact Directory from a location.

Receptionist Contact Directories are uniquely named per location and contain directories of Persons, Auto Attendants, Call Queues, Hunt Groups, Single Number Reaches, and Paging Groups.

This API is currently supported for Webex calling organizations with fewer than 2000 users or location-based calling features. For organizations with more than 2000 users or location features, the API will throw an error 25395.

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

Parameters:

• location_id (str) – Get a Receptionist Contact Directory from this location.

• directory_id (str) – Get details for the Receptionist Contact Directory with this identifier.

• search_criteria_mode_or (bool) – When true, results matching any one of the search criteria are included. The value can only be true or not included in the request. Specifying searchCriteriaModeOr without any search criteria, or setting it to false results in an ErrorResponse. If no search criteria is specified, all results are returned.

• first_name (str) – Search for directories that contain people with the indicated first name.

• last_name (str) – Search for directories that contain people with the indicated last name.

• phone_number (str) – Search for directories that contain people with the indicated phone number.

• extension (str) – Search for directories that contain people with the indicated extension.

• person_id (str) – Search for directories that contain people with the indicated person ID.

• org_id (str) – Get a Receptionist Contact Directory from this organization.

Return type:

list[ContactDetails]

delete_receptionist_contact_directory(location_id: str, directory_id: str, org_id: str | None = None)

Delete a Receptionist Contact Directory

Delete a Receptionist Contact Directory from a location.

Receptionist Contact Directories can be used to create named directories of users.

Deleting a directory requires a full or write-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:

• location_id (str) – Delete a Receptionist Contact Directory from this location.

• directory_id (str) – Add a Receptionist Contact Directory ID.

• org_id (str) – Delete a Receptionist Contact Directory from this organization.

Return type:

None

modify_receptionist_contact_directory(location_id: str, directory_id: str, name: str, contacts: List[str], org_id: str | None = None) → str

Modify a Receptionist Contact Directory

Modify Receptionist Contact Directories attached to a location. This modification will replace the existing list of contacts with the new incoming contacts list from the request body. The API does not support incremental updates.

Receptionist Contact Directories can be used to create named groups of Persons, Auto Attendants, Call Queues, Hunt Groups, Single Number Reaches, and Paging Groups.

Modifying a directory requires a full or write-only administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:

• location_id (str) – Modify list of Receptionist Contact Directories for this location.

• directory_id (str) – Get details for the Receptionist Contact Directory with this identifier.

• name (str) – Receptionist Contact Directory name. The directory name should be greater than 0 and less than 41 characters in length.

• contacts (list[str]) – Non-empty array of users or location features assigned to this Receptionist Contact Directory.

• org_id (str) – Modify list of Receptionist Contact Directories for this organization.

Return type:

str

safe_delete_check_before_disabling_calling_location(location_id: str, org_id: str | None = None) → SafeDeleteCheckResponse

Safe Delete Check Before Disabling a Location for Webex Calling

Performs a safe delete check operation to identify any issues that would prevent the calling location from being disabled. This API helps identify resources that need to be addressed before a calling location can be successfully disabled.

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

Parameters:

• location_id (str) – Unique identifier for the location to be checked.

• org_id (str) – Organization ID for which the safe delete check operation is being performed.

Return type:

SafeDeleteCheckResponse

get_call_captions_settings(location_id: str, org_id: str | None = None) → LocationCallCaptions

Get the location call captions settings

Retrieve the location’s call captions settings.

NOTE: The call captions feature is not supported for locations in India.

The call caption feature allows the customer to enable and manage closed captions and transcript functionality (rolling caption panel) in Webex Calling, without requiring the user to escalate the call to a meeting.

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

Parameters:

• location_id (str) – Unique identifier for the location.

• org_id (str) – Unique identifier for the organization.

Return type:

LocationCallCaptions

update_call_captions_settings(location_id: str, settings: LocationCallCaptions, org_id: str | None = None)

Update the location call captions settings

Update the location’s call captions settings.

NOTE: The call captions feature is not supported for locations in India.

The call caption feature allows the customer to enable and manage closed captions and transcript functionality (rolling caption panel) in Webex Calling, without requiring the user to escalate the call to a meeting.

This API requires a full or location administrator auth token with a scope of spark-admin:telephony_config_write.

Parameters:

• location_id (str) – Unique identifier for the location.

• settings (LocationCallCaptions) – settings to update

• org_id (str) – Unique identifier for the organization.

Return type:

None

Subpackages

• wxc_sdk.telephony.location.emergency_services package
  • LocationEmergencyServicesApi
    • LocationEmergencyServicesApi.read_emergency_call_notification()
    • LocationEmergencyServicesApi.update_emergency_call_notification()
    • LocationEmergencyServicesApi.base
  • LocationEmergencyCallNotification
    • LocationEmergencyCallNotification.emergency_call_notification_enabled
    • LocationEmergencyCallNotification.email_address
    • LocationEmergencyCallNotification.organization
  • LocationCallNotificationOrganization
    • LocationCallNotificationOrganization.emergency_call_notification_enabled
    • LocationCallNotificationOrganization.allow_email_notification_all_location_enabled
    • LocationCallNotificationOrganization.email_address

Submodules

• wxc_sdk.telephony.location.intercept module
  • LocationInterceptApi
    • LocationInterceptApi.read()
    • LocationInterceptApi.configure()
    • LocationInterceptApi.base
• wxc_sdk.telephony.location.internal_dialing module
  • InternalDialing
    • InternalDialing.enable_unknown_extension_route_policy
    • InternalDialing.unknown_extension_route_identity
  • InternalDialingApi
    • InternalDialingApi.url()
    • InternalDialingApi.read()
    • InternalDialingApi.update()
    • InternalDialingApi.base
• wxc_sdk.telephony.location.moh module
  • LocationMoHGreetingType
    • LocationMoHGreetingType.system
    • LocationMoHGreetingType.custom
  • LocationMoHSetting
    • LocationMoHSetting.call_hold_enabled
    • LocationMoHSetting.call_park_enabled
    • LocationMoHSetting.greeting
    • LocationMoHSetting.audio_file
    • LocationMoHSetting.playlist
  • LocationMoHApi
    • LocationMoHApi.read()
    • LocationMoHApi.update()
    • LocationMoHApi.base
• wxc_sdk.telephony.location.numbers module
  • TelephoneNumberType
    • TelephoneNumberType.tollfree
    • TelephoneNumberType.did
    • TelephoneNumberType.mobile
  • NumberUsageType
    • NumberUsageType.none_
    • NumberUsageType.service
  • NumberAddError
    • NumberAddError.number
    • NumberAddError.error_type
    • NumberAddError.error_code
    • NumberAddError.error_message
    • NumberAddError.error_title
  • NumberAddResponse
    • NumberAddResponse.errors
  • NumbersRequestAction
    • NumbersRequestAction.activate
    • NumbersRequestAction.deactivate
  • LocationNumbersApi
    • LocationNumbersApi.remove()
    • LocationNumbersApi.add()
    • LocationNumbersApi.activate()
    • LocationNumbersApi.manage_number_state()
    • LocationNumbersApi.base
• wxc_sdk.telephony.location.receptionist_contacts module
  • ReceptionistContactsDirectoryApi
    • ReceptionistContactsDirectoryApi.create()
    • ReceptionistContactsDirectoryApi.list()
    • ReceptionistContactsDirectoryApi.delete()
    • ReceptionistContactsDirectoryApi.base
• wxc_sdk.telephony.location.vm module
  • LocationVoiceMailSettings
    • LocationVoiceMailSettings.voicemail_transcription_enabled
  • LocationVoicemailSettingsApi
    • LocationVoicemailSettingsApi.read()
    • LocationVoicemailSettingsApi.update()
    • LocationVoicemailSettingsApi.base