wxc_sdk.me.voicemail package

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

Bases: ApiChild

settings() → VoicemailSettings

Read Voicemail Settings for a Person

Retrieve a person’s voicemail settings.

The voicemail feature transfers callers to voicemail based on your settings. You can then retrieve voice messages via voicemail.

Optionally, notifications can be sent to a mobile phone via text or email. These notifications will not include the voicemail files.

This API requires a user auth token with a scope of spark-admin:people_read.

Return type:

VoicemailSettings

configure(settings: VoicemailSettings)

Configure Voicemail Settings for a Person

Configure a person’s voicemail settings.

The voicemail feature transfers callers to voicemail based on your settings. You can then retrieve voice messages via voicemail.

Optionally, notifications can be sent to a mobile phone via text or email. These notifications will not include the voicemail files.

This API requires a user auth token with a scope of spark-admin:people_write.

Parameters:

settings (VoicemailSettings) – Voicemail settings

Return type:

None

upload_busy_greeting(content: BufferedReader | str, upload_as: str | None = None)

Upload Voicemail Busy Greeting

Uploads a new busy greeting audio file for the authenticated user’s voicemail.

This endpoint is part of the voicemail greeting management capabilities provided by the Webex Calling platform and is available when the wxc-csg-hydra-call-184017-phase4 feature is enabled. The greeting must be in WAV format and not exceed 5000 kilobytes.

Requires a user auth token with the spark:telephony_config_write scope. Only the authenticated user may upload greetings for their own voicemail.

Parameters:

• content (Union[BufferedReader, str]) – the file to be uploaded, can be a path to a file or a buffered reader (opened file); if a reader referring to an open file is passed then make sure to open the file as binary b/c otherwise the content length might be calculated wrong

• upload_as (str) – filename for the content. Only required if content is a reader; has to be a .wav file name.

Return type:

None

upload_no_answer_greeting(content: BufferedReader | str, upload_as: str | None = None)

Upload Voicemail No Answer Greeting

Uploads a new no answer greeting audio file for the authenticated user’s voicemail.

This endpoint is part of the voicemail greeting management capabilities provided by the Webex Calling platform and is available when the wxc-csg-hydra-call-184017-phase4 feature is enabled. The greeting must be in WAV format and not exceed 5000 kilobytes.

Requires a user auth token with the spark:telephony_config_write scope. Only the authenticated user may upload greetings for their own voicemail.

Parameters:

• content (Union[BufferedReader, str]) – the file to be uploaded, can be a path to a file or a buffered reader (opened file); if a reader referring to an open file is passed then make sure to open the file as binary b/c otherwise the content length might be calculated wrong

• upload_as (str) – filename for the content. Only required if content is a reader; has to be a .wav file name.

Return type:

None

base = 'telephony/config/people/me'