chatbot function

AWS Chatbot

AWS Chatbot

The AWS Chatbot API Reference provides descriptions, API request parameters, and the XML response for each of the AWS Chatbot API actions.

AWS Chatbot APIs are currently available in the following Regions:

  • US East (Ohio) - us-east-2
  • US West (Oregon) - us-west-2
  • Asia Pacific (Singapore) - ap-southeast-1
  • Europe (Ireland) - eu-west-1

The AWS Chatbot console can only be used in US East (Ohio). Your configuration data however, is stored in each of the relevant available Regions.

Your AWS CloudTrail events are logged in whatever Region you call from, not US East (N. Virginia) by default.

chatbot(config = list(), credentials = list(), endpoint = NULL, region = NULL)

Arguments

  • config: Optional configuration of credentials, endpoint, and/or region.

    • credentials :

      • creds :

        • access_key_id : AWS access key ID
        • secret_access_key : AWS secret access key
        • session_token : AWS temporary session token
      • profile : The name of a profile to use. If not given, then the default profile is used.

      • anonymous : Set anonymous credentials.

    • endpoint : The complete URL to use for the constructed client.

    • region : The AWS Region used in instantiating the client.

    • close_connection : Immediately close all HTTP connections.

    • timeout : The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

    • s3_force_path_style : Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

    • sts_regional_endpoint : Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

  • credentials: Optional credentials shorthand for the config parameter

    • creds :

      • access_key_id : AWS access key ID
      • secret_access_key : AWS secret access key
      • session_token : AWS temporary session token
    • profile : The name of a profile to use. If not given, then the default profile is used.

    • anonymous : Set anonymous credentials.

  • endpoint: Optional shorthand for complete URL to use for the constructed client.

  • region: Optional shorthand for AWS Region used in instantiating the client.

Returns

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- chatbot(
  config = list(
    credentials = list(
 creds = list(
   access_key_id = "string",
   secret_access_key = "string",
   session_token = "string"
 ),
 profile = "string",
 anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
 access_key_id = "string",
 secret_access_key = "string",
 session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

associate_to_configurationLinks a resource (for example, a custom action) to a channel configuration
create_chime_webhook_configurationCreates an AWS Chatbot configuration for Amazon Chime
create_custom_actionCreates a custom action that can be invoked as an alias or as a button on a notification
create_microsoft_teams_channel_configurationCreates an AWS Chatbot configuration for Microsoft Teams
create_slack_channel_configurationCreates an AWS Chatbot confugration for Slack
delete_chime_webhook_configurationDeletes a Amazon Chime webhook configuration for AWS Chatbot
delete_custom_actionDeletes a custom action
delete_microsoft_teams_channel_configurationDeletes a Microsoft Teams channel configuration for AWS Chatbot
delete_microsoft_teams_configured_teamDeletes the Microsoft Teams team authorization allowing for channels to be configured in that Microsoft Teams team
delete_microsoft_teams_user_identityIdentifes a user level permission for a channel configuration
delete_slack_channel_configurationDeletes a Slack channel configuration for AWS Chatbot
delete_slack_user_identityDeletes a user level permission for a Slack channel configuration
delete_slack_workspace_authorizationDeletes the Slack workspace authorization that allows channels to be configured in that workspace
describe_chime_webhook_configurationsLists Amazon Chime webhook configurations optionally filtered by ChatConfigurationArn
describe_slack_channel_configurationsLists Slack channel configurations optionally filtered by ChatConfigurationArn
describe_slack_user_identitiesLists all Slack user identities with a mapped role
describe_slack_workspacesList all authorized Slack workspaces connected to the AWS Account onboarded with AWS Chatbot
disassociate_from_configurationUnlink a resource, for example a custom action, from a channel configuration
get_account_preferencesReturns AWS Chatbot account preferences
get_custom_actionReturns a custom action
get_microsoft_teams_channel_configurationReturns a Microsoft Teams channel configuration in an AWS account
list_associationsLists resources associated with a channel configuration
list_custom_actionsLists custom actions defined in this account
list_microsoft_teams_channel_configurationsLists all AWS Chatbot Microsoft Teams channel configurations in an AWS account
list_microsoft_teams_configured_teamsLists all authorized Microsoft Teams for an AWS Account
list_microsoft_teams_user_identitiesA list all Microsoft Teams user identities with a mapped role
list_tags_for_resourceLists all of the tags associated with the Amazon Resource Name (ARN) that you specify
tag_resourceAttaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN)
untag_resourceDetaches a key-value pair from a resource, as identified by its Amazon Resource Name (ARN)
update_account_preferencesUpdates AWS Chatbot account preferences
update_chime_webhook_configurationUpdates a Amazon Chime webhook configuration
update_custom_actionUpdates a custom action
update_microsoft_teams_channel_configurationUpdates an Microsoft Teams channel configuration
update_slack_channel_configurationUpdates a Slack channel configuration

Examples

## Not run: svc <- chatbot() svc$associate_to_configuration( Foo = 123 ) ## End(Not run)
  • Maintainer: Dyfan Jones
  • License: Apache License (>= 2.0)
  • Last published: 2025-03-17