:doc:`ChimeSDKIdentity <../../chime-sdk-identity>` / Client / update_app_instance_bot

***********************
update_app_instance_bot
***********************



.. py:method:: ChimeSDKIdentity.Client.update_app_instance_bot(**kwargs)

  

  Updates the name and metadata of an ``AppInstanceBot``.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/chime-sdk-identity-2021-04-20/UpdateAppInstanceBot>`_  


  **Request Syntax**
  ::

    response = client.update_app_instance_bot(
        AppInstanceBotArn='string',
        Name='string',
        Metadata='string',
        Configuration={
            'Lex': {
                'RespondsTo': 'STANDARD_MESSAGES',
                'InvokedBy': {
                    'StandardMessages': 'AUTO'|'ALL'|'MENTIONS'|'NONE',
                    'TargetedMessages': 'ALL'|'NONE'
                },
                'LexBotAliasArn': 'string',
                'LocaleId': 'string',
                'WelcomeIntent': 'string'
            }
        }
    )
    
  :type AppInstanceBotArn: string
  :param AppInstanceBotArn: **[REQUIRED]** 

    The ARN of the ``AppInstanceBot``.

    

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

    The name of the ``AppInstanceBot``.

    

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

    The metadata of the ``AppInstanceBot``.

    

  
  :type Configuration: dict
  :param Configuration: 

    The configuration for the bot update.

    

  
    - **Lex** *(dict) --* **[REQUIRED]** 

      The configuration for an Amazon Lex V2 bot.

      

    
      - **RespondsTo** *(string) --* 

        .. warning::

          

          **Deprecated**. Use ``InvokedBy`` instead.

           

         

        Determines whether the Amazon Lex V2 bot responds to all standard messages. Control messages are not supported.

        

      
      - **InvokedBy** *(dict) --* 

        Specifies the type of message that triggers a bot.

        

      
        - **StandardMessages** *(string) --* **[REQUIRED]** 

          Sets standard messages as the bot trigger. For standard messages:

           

          
          * ``ALL``: The bot processes all standard messages.
           
          * ``AUTO``: The bot responds to ALL messages when the channel has one other non-hidden member, and responds to MENTIONS when the channel has more than one other non-hidden member.
           
          * ``MENTIONS``: The bot processes all standard messages that have a message attribute with ``CHIME.mentions`` and a value of the bot ARN.
           
          * ``NONE``: The bot processes no standard messages.
          

          

        
        - **TargetedMessages** *(string) --* **[REQUIRED]** 

          Sets targeted messages as the bot trigger. For targeted messages:

           

          
          * ``ALL``: The bot processes all ``TargetedMessages`` sent to it. The bot then responds with a targeted message back to the sender.
           
          * ``NONE``: The bot processes no targeted messages.
          

          

        
      
      - **LexBotAliasArn** *(string) --* **[REQUIRED]** 

        The ARN of the Amazon Lex V2 bot's alias. The ARN uses this format: ``arn:aws:lex:REGION:ACCOUNT:bot-alias/MYBOTID/MYBOTALIAS``

        

      
      - **LocaleId** *(string) --* **[REQUIRED]** 

        Identifies the Amazon Lex V2 bot's language and locale. The string must match one of the supported locales in Amazon Lex V2. All of the intents, slot types, and slots used in the bot must have the same locale. For more information, see `Supported languages <https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html>`__ in the *Amazon Lex V2 Developer Guide*.

        

      
      - **WelcomeIntent** *(string) --* 

        The name of the welcome intent configured in the Amazon Lex V2 bot.

        

      
    
  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'AppInstanceBotArn': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **AppInstanceBotArn** *(string) --* 

        The ARN of the ``AppInstanceBot``.

        
  
  **Exceptions**
  
  *   :py:class:`ChimeSDKIdentity.Client.exceptions.BadRequestException`

  
  *   :py:class:`ChimeSDKIdentity.Client.exceptions.ConflictException`

  
  *   :py:class:`ChimeSDKIdentity.Client.exceptions.ForbiddenException`

  
  *   :py:class:`ChimeSDKIdentity.Client.exceptions.ResourceLimitExceededException`

  
  *   :py:class:`ChimeSDKIdentity.Client.exceptions.ThrottledClientException`

  
  *   :py:class:`ChimeSDKIdentity.Client.exceptions.UnauthorizedClientException`

  
  *   :py:class:`ChimeSDKIdentity.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`ChimeSDKIdentity.Client.exceptions.ServiceFailureException`

  