Client
connect | R Documentation |
Amazon Connect Service¶
Description¶
Amazon Connect is a cloud-based contact center solution that you use to set up and manage a customer contact center and provide reliable customer engagement at any scale.
Amazon Connect provides metrics and real-time reporting that enable you to optimize contact routing. You can also resolve customer issues more efficiently by getting customers in touch with the appropriate agents.
There are limits to the number of Amazon Connect resources that you can create. There are also limits to the number of requests that you can make per second. For more information, see Amazon Connect Service Quotas in the Amazon Connect Administrator Guide.
You can connect programmatically to an Amazon Web Services service by using an endpoint. For a list of Amazon Connect endpoints, see Amazon Connect Endpoints.
Usage¶
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.
Value¶
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 <- connect(
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¶
- activate_evaluation_form
- Activates an evaluation form in the specified Amazon Connect instance
- associate_analytics_data_set
- This API is in preview release for Amazon Connect and is subject to change
- associate_approved_origin
- This API is in preview release for Amazon Connect and is subject to change
- associate_bot
- This API is in preview release for Amazon Connect and is subject to change
- associate_default_vocabulary
- Associates an existing vocabulary as the default
- associate_flow
- Associates a connect resource to a flow
- associate_instance_storage_config
- This API is in preview release for Amazon Connect and is subject to change
- associate_lambda_function
- This API is in preview release for Amazon Connect and is subject to change
- associate_lex_bot
- This API is in preview release for Amazon Connect and is subject to change
- associate_phone_number_contact_flow
- Associates a flow with a phone number claimed to your Amazon Connect instance
- associate_queue_quick_connects
- This API is in preview release for Amazon Connect and is subject to change
- associate_routing_profile_queues
- Associates a set of queues with a routing profile
- associate_security_key
- This API is in preview release for Amazon Connect and is subject to change
- Associates an agent with a traffic distribution group
- associate_user_proficiencies
- >Associates a set of proficiencies with a user
- batch_associate_analytics_data_set
- This API is in preview release for Amazon Connect and is subject to change
- batch_disassociate_analytics_data_set
- This API is in preview release for Amazon Connect and is subject to change
- batch_get_attached_file_metadata
- Allows you to retrieve metadata about multiple attached files on an associated resource
- batch_get_flow_association
- Retrieve the flow associations for the given resources
- batch_put_contact
- Only the Amazon Connect outbound campaigns service principal is allowed to assume a role in your account and call this API
- claim_phone_number
- Claims an available phone number to your Amazon Connect instance or traffic distribution group
- complete_attached_file_upload
- Allows you to confirm that the attached file has been uploaded using the pre-signed URL provided in the StartAttachedFileUpload API
- create_agent_status
- This API is in preview release for Amazon Connect and is subject to change
- create_contact_flow
- Creates a flow for the specified Amazon Connect instance
- create_contact_flow_module
- Creates a flow module for the specified Amazon Connect instance
- create_evaluation_form
- Creates an evaluation form in the specified Amazon Connect instance
- create_hours_of_operation
- This API is in preview release for Amazon Connect and is subject to change
- create_instance
- This API is in preview release for Amazon Connect and is subject to change
- create_integration_association
- Creates an Amazon Web Services resource association with an Amazon Connect instance
- create_participant
- Adds a new participant into an on-going chat contact
- create_persistent_contact_association
- Enables rehydration of chats for the lifespan of a contact
- create_predefined_attribute
- Creates a new predefined attribute for the specified Amazon Connect instance
- create_prompt
- Creates a prompt
- create_queue
- This API is in preview release for Amazon Connect and is subject to change
- create_quick_connect
- Creates a quick connect for the specified Amazon Connect instance
- create_routing_profile
- Creates a new routing profile
- create_rule
- Creates a rule for the specified Amazon Connect instance
- create_security_profile
- Creates a security profile
- create_task_template
- Creates a new task template in the specified Amazon Connect instance
- create_traffic_distribution_group
- Creates a traffic distribution group given an Amazon Connect instance that has been replicated
- create_use_case
- Creates a use case for an integration association
- create_user
- Creates a user account for the specified Amazon Connect instance
- create_user_hierarchy_group
- Creates a new user hierarchy group
- create_view
- Creates a new view with the possible status of SAVED or PUBLISHED
- create_view_version
- Publishes a new version of the view identifier
- create_vocabulary
- Creates a custom vocabulary associated with your Amazon Connect instance
- deactivate_evaluation_form
- Deactivates an evaluation form in the specified Amazon Connect instance
- delete_attached_file
- Deletes an attached file along with the underlying S3 Object
- delete_contact_evaluation
- Deletes a contact evaluation in the specified Amazon Connect instance
- delete_contact_flow
- Deletes a flow for the specified Amazon Connect instance
- delete_contact_flow_module
- Deletes the specified flow module
- delete_evaluation_form
- Deletes an evaluation form in the specified Amazon Connect instance
- delete_hours_of_operation
- This API is in preview release for Amazon Connect and is subject to change
- delete_instance
- This API is in preview release for Amazon Connect and is subject to change
- delete_integration_association
- Deletes an Amazon Web Services resource association from an Amazon Connect instance
- delete_predefined_attribute
- Deletes a predefined attribute from the specified Amazon Connect instance
- delete_prompt
- Deletes a prompt
- delete_queue
- Deletes a queue
- delete_quick_connect
- Deletes a quick connect
- delete_routing_profile
- Deletes a routing profile
- delete_rule
- Deletes a rule for the specified Amazon Connect instance
- delete_security_profile
- Deletes a security profile
- delete_task_template
- Deletes the task template
- delete_traffic_distribution_group
- Deletes a traffic distribution group
- delete_use_case
- Deletes a use case from an integration association
- delete_user
- Deletes a user account from the specified Amazon Connect instance
- delete_user_hierarchy_group
- Deletes an existing user hierarchy group
- delete_view
- Deletes the view entirely
- delete_view_version
- Deletes the particular version specified in ViewVersion identifier
- delete_vocabulary
- Deletes the vocabulary that has the given identifier
- describe_agent_status
- This API is in preview release for Amazon Connect and is subject to change
- describe_authentication_profile
- This API is in preview release for Amazon Connect and is subject to change
- describe_contact
- This API is in preview release for Amazon Connect and is subject to change
- describe_contact_evaluation
- Describes a contact evaluation in the specified Amazon Connect instance
- describe_contact_flow
- Describes the specified flow
- describe_contact_flow_module
- Describes the specified flow module
- describe_evaluation_form
- Describes an evaluation form in the specified Amazon Connect instance
- describe_hours_of_operation
- This API is in preview release for Amazon Connect and is subject to change
- describe_instance
- This API is in preview release for Amazon Connect and is subject to change
- describe_instance_attribute
- This API is in preview release for Amazon Connect and is subject to change
- describe_instance_storage_config
- This API is in preview release for Amazon Connect and is subject to change
- describe_phone_number
- Gets details and status of a phone number that’s claimed to your Amazon Connect instance or traffic distribution group
- describe_predefined_attribute
- Describes a predefined attribute for the specified Amazon Connect instance
- describe_prompt
- Describes the prompt
- describe_queue
- This API is in preview release for Amazon Connect and is subject to change
- describe_quick_connect
- Describes the quick connect
- describe_routing_profile
- Describes the specified routing profile
- describe_rule
- Describes a rule for the specified Amazon Connect instance
- describe_security_profile
- Gets basic information about the security profile
- describe_traffic_distribution_group
- Gets details and status of a traffic distribution group
- describe_user
- Describes the specified user
- describe_user_hierarchy_group
- Describes the specified hierarchy group
- describe_user_hierarchy_structure
- Describes the hierarchy structure of the specified Amazon Connect instance
- describe_view
- Retrieves the view for the specified Amazon Connect instance and view identifier
- describe_vocabulary
- Describes the specified vocabulary
- disassociate_analytics_data_set
- This API is in preview release for Amazon Connect and is subject to change
- disassociate_approved_origin
- This API is in preview release for Amazon Connect and is subject to change
- disassociate_bot
- This API is in preview release for Amazon Connect and is subject to change
- disassociate_flow
- Disassociates a connect resource from a flow
- disassociate_instance_storage_config
- This API is in preview release for Amazon Connect and is subject to change
- disassociate_lambda_function
- This API is in preview release for Amazon Connect and is subject to change
- disassociate_lex_bot
- This API is in preview release for Amazon Connect and is subject to change
- Removes the flow association from a phone number claimed to your Amazon Connect instance
- disassociate_queue_quick_connects
- This API is in preview release for Amazon Connect and is subject to change
- disassociate_routing_profile_queues
- Disassociates a set of queues from a routing profile
- disassociate_security_key
- This API is in preview release for Amazon Connect and is subject to change
- Disassociates an agent from a traffic distribution group
- disassociate_user_proficiencies
- Disassociates a set of proficiencies from a user
- dismiss_user_contact
- Dismisses contacts from an agent’s CCP and returns the agent to an available state, which allows the agent to receive a new routed contact
- get_attached_file
- Provides a pre-signed URL for download of an approved attached file
- get_contact_attributes
- Retrieves the contact attributes for the specified contact
- get_current_metric_data
- Gets the real-time metric data from the specified Amazon Connect instance
- get_current_user_data
- Gets the real-time active user data from the specified Amazon Connect instance
- get_federation_token
- Supports SAML sign-in for Amazon Connect
- get_flow_association
- Retrieves the flow associated for a given resource
- get_metric_data
- Gets historical metric data from the specified Amazon Connect instance
- get_metric_data_v2
- Gets metric data from the specified Amazon Connect instance
- get_prompt_file
- Gets the prompt file
- get_task_template
- Gets details about a specific task template in the specified Amazon Connect instance
- get_traffic_distribution
- Retrieves the current traffic distribution for a given traffic distribution group
- import_phone_number
- Imports a claimed phone number from an external service, such as Amazon Pinpoint, into an Amazon Connect instance
- list_agent_statuses
- This API is in preview release for Amazon Connect and is subject to change
- list_analytics_data_associations
- This API is in preview release for Amazon Connect and is subject to change
- list_approved_origins
- This API is in preview release for Amazon Connect and is subject to change
- list_authentication_profiles
- This API is in preview release for Amazon Connect and is subject to change
- list_bots
- This API is in preview release for Amazon Connect and is subject to change
- list_contact_evaluations
- Lists contact evaluations in the specified Amazon Connect instance
- list_contact_flow_modules
- Provides information about the flow modules for the specified Amazon Connect instance
- list_contact_flows
- Provides information about the flows for the specified Amazon Connect instance
- list_contact_references
- This API is in preview release for Amazon Connect and is subject to change
- list_default_vocabularies
- Lists the default vocabularies for the specified Amazon Connect instance
- list_evaluation_forms
- Lists evaluation forms in the specified Amazon Connect instance
- list_evaluation_form_versions
- Lists versions of an evaluation form in the specified Amazon Connect instance
- list_flow_associations
- List the flow association based on the filters
- list_hours_of_operations
- Provides information about the hours of operation for the specified Amazon Connect instance
- list_instance_attributes
- This API is in preview release for Amazon Connect and is subject to change
- list_instances
- This API is in preview release for Amazon Connect and is subject to change
- list_instance_storage_configs
- This API is in preview release for Amazon Connect and is subject to change
- list_integration_associations
- Provides summary information about the Amazon Web Services resource associations for the specified Amazon Connect instance
- list_lambda_functions
- This API is in preview release for Amazon Connect and is subject to change
- list_lex_bots
- This API is in preview release for Amazon Connect and is subject to change
- list_phone_numbers
- Provides information about the phone numbers for the specified Amazon Connect instance
- list_phone_numbers_v2
- Lists phone numbers claimed to your Amazon Connect instance or traffic distribution group
- list_predefined_attributes
- Lists predefined attributes for the specified Amazon Connect instance
- list_prompts
- Provides information about the prompts for the specified Amazon Connect instance
- list_queue_quick_connects
- This API is in preview release for Amazon Connect and is subject to change
- list_queues
- Provides information about the queues for the specified Amazon Connect instance
- list_quick_connects
- Provides information about the quick connects for the specified Amazon Connect instance
- Provides a list of analysis segments for a real-time analysis session
- list_routing_profile_queues
- Lists the queues associated with a routing profile
- list_routing_profiles
- Provides summary information about the routing profiles for the specified Amazon Connect instance
- list_rules
- List all rules for the specified Amazon Connect instance
- list_security_keys
- This API is in preview release for Amazon Connect and is subject to change
- list_security_profile_applications
- Returns a list of third-party applications in a specific security profile
- list_security_profile_permissions
- Lists the permissions granted to a security profile
- list_security_profiles
- Provides summary information about the security profiles for the specified Amazon Connect instance
- list_tags_for_resource
- Lists the tags for the specified resource
- list_task_templates
- Lists task templates for the specified Amazon Connect instance
- list_traffic_distribution_groups
- Lists traffic distribution groups
- list_traffic_distribution_group_users
- Lists traffic distribution group users
- list_use_cases
- Lists the use cases for the integration association
- list_user_hierarchy_groups
- Provides summary information about the hierarchy groups for the specified Amazon Connect instance
- list_user_proficiencies
- Lists proficiencies associated with a user
- list_users
- Provides summary information about the users for the specified Amazon Connect instance
- list_views
- Returns views in the given instance
- list_view_versions
- Returns all the available versions for the specified Amazon Connect instance and view identifier
- monitor_contact
- Initiates silent monitoring of a contact
- pause_contact
- Allows pausing an ongoing task contact
- put_user_status
- Changes the current status of a user or agent in Amazon Connect
- release_phone_number
- Releases a phone number previously claimed to an Amazon Connect instance or traffic distribution group
- replicate_instance
- Replicates an Amazon Connect instance in the specified Amazon Web Services Region and copies configuration information for Amazon Connect resources across Amazon Web Services Regions
- resume_contact
- Allows resuming a task contact in a paused state
- resume_contact_recording
- When a contact is being recorded, and the recording has been suspended using SuspendContactRecording, this API resumes recording whatever recording is selected in the flow configuration: call, screen, or both
- search_agent_statuses
- Searches AgentStatuses in an Amazon Connect instance, with optional filtering
- search_available_phone_numbers
- Searches for available phone numbers that you can claim to your Amazon Connect instance or traffic distribution group
- search_contact_flow_modules
- Searches the flow modules in an Amazon Connect instance, with optional filtering
- search_contact_flows
- Searches the contact flows in an Amazon Connect instance, with optional filtering
- search_contacts
- Searches contacts in an Amazon Connect instance
- search_hours_of_operations
- Searches the hours of operation in an Amazon Connect instance, with optional filtering
- search_predefined_attributes
- Searches predefined attributes that meet certain criteria
- search_prompts
- Searches prompts in an Amazon Connect instance, with optional filtering
- search_queues
- Searches queues in an Amazon Connect instance, with optional filtering
- search_quick_connects
- Searches quick connects in an Amazon Connect instance, with optional filtering
- search_resource_tags
- Searches tags used in an Amazon Connect instance using optional search criteria
- search_routing_profiles
- Searches routing profiles in an Amazon Connect instance, with optional filtering
- search_security_profiles
- Searches security profiles in an Amazon Connect instance, with optional filtering
- search_user_hierarchy_groups
- Searches UserHierarchyGroups in an Amazon Connect instance, with optional filtering
- search_users
- Searches users in an Amazon Connect instance, with optional filtering
- search_vocabularies
- Searches for vocabularies within a specific Amazon Connect instance using State, NameStartsWith, and LanguageCode
- send_chat_integration_event
- Processes chat integration events from Amazon Web Services or external integrations to Amazon Connect
- start_attached_file_upload
- Provides a pre-signed Amazon S3 URL in response for uploading your content
- start_chat_contact
- Initiates a flow to start a new chat for the customer
- start_contact_evaluation
- Starts an empty evaluation in the specified Amazon Connect instance, using the given evaluation form for the particular contact
- start_contact_recording
- Starts recording the contact:
- start_contact_streaming
- Initiates real-time message streaming for a new chat contact
- start_outbound_voice_contact
- Places an outbound call to a contact, and then initiates the flow
- start_task_contact
- Initiates a flow to start a new task contact
- start_web_rtc_contact
- Places an inbound in-app, web, or video call to a contact, and then initiates the flow
- stop_contact
- Ends the specified contact
- stop_contact_recording
- Stops recording a call when a contact is being recorded
- stop_contact_streaming
- Ends message streaming on a specified contact
- submit_contact_evaluation
- Submits a contact evaluation in the specified Amazon Connect instance
- suspend_contact_recording
- When a contact is being recorded, this API suspends recording whatever is selected in the flow configuration: call, screen, or both
- tag_contact
- Adds the specified tags to the contact resource
- tag_resource
- Adds the specified tags to the specified resource
- transfer_contact
- Transfers contacts from one agent or queue to another agent or queue at any point after a contact is created
- untag_contact
- Removes the specified tags from the contact resource
- untag_resource
- Removes the specified tags from the specified resource
- update_agent_status
- This API is in preview release for Amazon Connect and is subject to change
- update_authentication_profile
- This API is in preview release for Amazon Connect and is subject to change
- update_contact
- This API is in preview release for Amazon Connect and is subject to change
- update_contact_attributes
- Creates or updates user-defined contact attributes associated with the specified contact
- update_contact_evaluation
- Updates details about a contact evaluation in the specified Amazon Connect instance
- update_contact_flow_content
- Updates the specified flow
- update_contact_flow_metadata
- Updates metadata about specified flow
- update_contact_flow_module_content
- Updates specified flow module for the specified Amazon Connect instance
- update_contact_flow_module_metadata
- Updates metadata about specified flow module
- update_contact_flow_name
- The name of the flow
- update_contact_routing_data
- Updates routing priority and age on the contact (QueuePriority and QueueTimeAdjustmentInSeconds)
- update_contact_schedule
- Updates the scheduled time of a task contact that is already scheduled
- update_evaluation_form
- Updates details about a specific evaluation form version in the specified Amazon Connect instance
- update_hours_of_operation
- This API is in preview release for Amazon Connect and is subject to change
- update_instance_attribute
- This API is in preview release for Amazon Connect and is subject to change
- update_instance_storage_config
- This API is in preview release for Amazon Connect and is subject to change
- update_participant_role_config
- Updates timeouts for when human chat participants are to be considered idle, and when agents are automatically disconnected from a chat due to idleness
- update_phone_number
- Updates your claimed phone number from its current Amazon Connect instance or traffic distribution group to another Amazon Connect instance or traffic distribution group in the same Amazon Web Services Region
- update_phone_number_metadata
- Updates a phone number’s metadata
- update_predefined_attribute
- Updates a predefined attribute for the specified Amazon Connect instance
- update_prompt
- Updates a prompt
- update_queue_hours_of_operation
- This API is in preview release for Amazon Connect and is subject to change
- update_queue_max_contacts
- This API is in preview release for Amazon Connect and is subject to change
- update_queue_name
- This API is in preview release for Amazon Connect and is subject to change
- update_queue_outbound_caller_config
- This API is in preview release for Amazon Connect and is subject to change
- update_queue_status
- This API is in preview release for Amazon Connect and is subject to change
- update_quick_connect_config
- Updates the configuration settings for the specified quick connect
- update_quick_connect_name
- Updates the name and description of a quick connect
- Whether agents with this routing profile will have their routing order calculated based on time since their last inbound contact or longest idle time
- update_routing_profile_concurrency
- Updates the channels that agents can handle in the Contact Control Panel (CCP) for a routing profile
- Updates the default outbound queue of a routing profile
- update_routing_profile_name
- Updates the name and description of a routing profile
- update_routing_profile_queues
- Updates the properties associated with a set of queues for a routing profile
- update_rule
- Updates a rule for the specified Amazon Connect instance
- update_security_profile
- Updates a security profile
- update_task_template
- Updates details about a specific task template in the specified Amazon Connect instance
- update_traffic_distribution
- Updates the traffic distribution for a given traffic distribution group
- update_user_hierarchy
- Assigns the specified hierarchy group to the specified user
- update_user_hierarchy_group_name
- Updates the name of the user hierarchy group
- update_user_hierarchy_structure
- Updates the user hierarchy structure: add, remove, and rename user hierarchy levels
- update_user_identity_info
- Updates the identity information for the specified user
- update_user_phone_config
- Updates the phone configuration settings for the specified user
- update_user_proficiencies
- Updates the properties associated with the proficiencies of a user
- update_user_routing_profile
- Assigns the specified routing profile to the specified user
- update_user_security_profiles
- Assigns the specified security profiles to the specified user
- update_view_content
- Updates the view content of the given view identifier in the specified Amazon Connect instance
- update_view_metadata
- Updates the view metadata