Chime / Client / get_bot

get_bot#

Chime.Client.get_bot(**kwargs)#

Retrieves details for the specified bot, such as bot email address, bot type, status, and display name.

Request Syntax

response = client.get_bot(
    AccountId='string',
    BotId='string'
)

Parameters:

AccountId (string) –
[REQUIRED]

The Amazon Chime account ID.
BotId (string) –
[REQUIRED]

The bot ID.

Return type:

dict

Returns:

Response Syntax

{
    'Bot': {
        'BotId': 'string',
        'UserId': 'string',
        'DisplayName': 'string',
        'BotType': 'ChatBot',
        'Disabled': True|False,
        'CreatedTimestamp': datetime(2015, 1, 1),
        'UpdatedTimestamp': datetime(2015, 1, 1),
        'BotEmail': 'string',
        'SecurityToken': 'string'
    }
}

Response Structure

(dict) –
- Bot (dict) –
  
  The chat bot details.
  - BotId (string) –
    
    The bot ID.
  - UserId (string) –
    
    The unique ID for the bot user.
  - DisplayName (string) –
    
    The bot display name.
  - BotType (string) –
    
    The bot type.
  - Disabled (boolean) –
    
    When true, the bot is stopped from running in your account.
  - CreatedTimestamp (datetime) –
    
    The bot creation timestamp, in ISO 8601 format.
  - UpdatedTimestamp (datetime) –
    
    The updated bot timestamp, in ISO 8601 format.
  - BotEmail (string) –
    
    The bot email address.
  - SecurityToken (string) –
    
    The security token used to authenticate Amazon Chime with the outgoing event endpoint.

Exceptions

Chime.Client.exceptions.ServiceUnavailableException
Chime.Client.exceptions.ServiceFailureException
Chime.Client.exceptions.ForbiddenException
Chime.Client.exceptions.UnauthorizedClientException
Chime.Client.exceptions.NotFoundException
Chime.Client.exceptions.BadRequestException
Chime.Client.exceptions.ThrottledClientException