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.

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