from wxc_sdk.api_child import ApiChild
from wxc_sdk.person_settings.personal_assistant import PersonalAssistant
[docs]
class MePersonalAssistantApi(ApiChild, base='telephony/config/people/me/settings/personalAssistant'):
"""
Personal Assistant Settings For Me
Call settings for me APIs allow a person to read or modify their settings.
Viewing settings requires a user auth token with a scope of `spark:telephony_config_read`.
Configuring settings requires a user auth token with a scope of `spark:telephony_config_write`.
"""
[docs]
def get(self) -> PersonalAssistant: # type: ignore[override]
"""
Get Personal Assistant Settings
Retrieve personal assistant settings for a person. The personal assistant feature allows users to configure an
automated attendant that can handle incoming calls when they are unavailable, including presence-based routing
and call transfer options.
Personal Assistant is a feature of Webex Calling that helps manage incoming calls based on the user's
availability status.
This API requires a user auth token with a scope of `spark:telephony_config_read`.
:rtype: :class:`PersonalAssistant`
"""
url = self.ep()
data = super().get(url)
r = PersonalAssistant.model_validate(data)
return r
[docs]
def update(self, settings: PersonalAssistant):
"""
Modify My Personal Assistant
Update user's own Personal Assistant details.
Personal Assistant is used to manage a user's incoming calls when they are away.
Updating Personal Assistant details requires a auth token with the `spark:telephony_config_write`.
:param settings: Personal Assistant settings.
:type settings: PersonalAssistant
:rtype: None
"""
body = settings.model_dump(mode='json', exclude_unset=True, by_alias=True)
url = self.ep()
super().put(url, json=body)