get_bot

get_bot(**kwargs)

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

See also: AWS API Documentation

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