:doc:`Connect <../../connect>` / Client / update_user_phone_config

************************
update_user_phone_config
************************



.. py:method:: Connect.Client.update_user_phone_config(**kwargs)

  

  Updates the phone configuration settings for the specified user.

   

  .. note::

    

    We recommend using the `UpdateUserConfig <https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateUserConfig.html>`__ API, which supports additional functionality that is not available in the UpdateUserPhoneConfig API, such as voice enhancement settings and per-channel configuration for auto-accept and After Contact Work (ACW) timeouts. In comparison, the UpdateUserPhoneConfig API will always set the same ACW timeouts to all channels the user handles.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/UpdateUserPhoneConfig>`_  


  **Request Syntax**
  ::

    response = client.update_user_phone_config(
        PhoneConfig={
            'PhoneType': 'SOFT_PHONE'|'DESK_PHONE',
            'AutoAccept': True|False,
            'AfterContactWorkTimeLimit': 123,
            'DeskPhoneNumber': 'string',
            'PersistentConnection': True|False
        },
        UserId='string',
        InstanceId='string'
    )
    
  :type PhoneConfig: dict
  :param PhoneConfig: **[REQUIRED]** 

    Information about phone configuration settings for the user.

    

  
    - **PhoneType** *(string) --* 

      The phone type.

      

    
    - **AutoAccept** *(boolean) --* 

      The Auto accept setting.

      

    
    - **AfterContactWorkTimeLimit** *(integer) --* 

      The After Call Work (ACW) timeout setting, in seconds. This parameter has a minimum value of 0 and a maximum value of 2,000,000 seconds (24 days). Enter 0 if you don't want to allocate a specific amount of ACW time. It essentially means an indefinite amount of time. When the conversation ends, ACW starts; the agent must choose Close contact to end ACW.

       

      .. note::

        

        When returned by a ``SearchUsers`` call, ``AfterContactWorkTimeLimit`` is returned in milliseconds.

        

      

    
    - **DeskPhoneNumber** *(string) --* 

      The phone number for the user's desk phone.

      

    
    - **PersistentConnection** *(boolean) --* 

      The persistent connection setting for the user.

      

    
  
  :type UserId: string
  :param UserId: **[REQUIRED]** 

    The identifier of the user account.

    

  
  :type InstanceId: string
  :param InstanceId: **[REQUIRED]** 

    The identifier of the Amazon Connect instance. You can `find the instance ID <https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html>`__ in the Amazon Resource Name (ARN) of the instance.

    

  
  
  :returns: None
  **Exceptions**
  
  *   :py:class:`Connect.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`Connect.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`Connect.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`Connect.Client.exceptions.ThrottlingException`

  
  *   :py:class:`Connect.Client.exceptions.InternalServiceException`

  