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

*************
associate_bot
*************



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

  

  This API is in preview release for Amazon Connect and is subject to change.

   

  Allows the specified Amazon Connect instance to access the specified Amazon Lex or Amazon Lex V2 bot.

  

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


  **Request Syntax**
  ::

    response = client.associate_bot(
        InstanceId='string',
        LexBot={
            'Name': 'string',
            'LexRegion': 'string'
        },
        LexV2Bot={
            'AliasArn': 'string'
        },
        ClientToken='string'
    )
    
  :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.

    

  
  :type LexBot: dict
  :param LexBot: 

    Configuration information of an Amazon Lex bot.

    

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

      The name of the Amazon Lex bot.

      

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

      The Amazon Web Services Region where the Amazon Lex bot was created.

      

    
  
  :type LexV2Bot: dict
  :param LexV2Bot: 

    The Amazon Lex V2 bot to associate with the instance.

    

  
    - **AliasArn** *(string) --* 

      The Amazon Resource Name (ARN) of the Amazon Lex V2 bot.

      

    
  
  :type ClientToken: string
  :param ClientToken: 

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see `Making retries safe with idempotent APIs <https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/>`__.

    This field is autopopulated if not provided.

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

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

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

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

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

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

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

  