paws.customer.engagement (version 0.5.0)

connect: 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

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

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.

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.

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_formActivates an evaluation form in the specified Amazon Connect instance
associate_analytics_data_setThis API is in preview release for Amazon Connect and is subject to change
associate_approved_originThis API is in preview release for Amazon Connect and is subject to change
associate_botThis API is in preview release for Amazon Connect and is subject to change
associate_default_vocabularyAssociates an existing vocabulary as the default
associate_flowAssociates a connect resource to a flow
associate_instance_storage_configThis API is in preview release for Amazon Connect and is subject to change
associate_lambda_functionThis API is in preview release for Amazon Connect and is subject to change
associate_lex_botThis API is in preview release for Amazon Connect and is subject to change
associate_phone_number_contact_flowAssociates a flow with a phone number claimed to your Amazon Connect instance
associate_queue_quick_connectsThis API is in preview release for Amazon Connect and is subject to change
associate_routing_profile_queuesAssociates a set of queues with a routing profile
associate_security_keyThis API is in preview release for Amazon Connect and is subject to change
associate_traffic_distribution_group_userAssociates an agent with a traffic distribution group
associate_user_proficiencies>Associates a set of proficiencies with a user
batch_associate_analytics_data_setThis API is in preview release for Amazon Connect and is subject to change
batch_disassociate_analytics_data_setThis API is in preview release for Amazon Connect and is subject to change
batch_get_flow_associationRetrieve the flow associations for the given resources
batch_put_contactOnly the Amazon Connect outbound campaigns service principal is allowed to assume a role in your account and call this API
claim_phone_numberClaims an available phone number to your Amazon Connect instance or traffic distribution group
create_agent_statusThis API is in preview release for Amazon Connect and is subject to change
create_contact_flowCreates a flow for the specified Amazon Connect instance
create_contact_flow_moduleCreates a flow module for the specified Amazon Connect instance
create_evaluation_formCreates an evaluation form in the specified Amazon Connect instance
create_hours_of_operationThis API is in preview release for Amazon Connect and is subject to change
create_instanceThis API is in preview release for Amazon Connect and is subject to change
create_integration_associationCreates an Amazon Web Services resource association with an Amazon Connect instance
create_participantAdds a new participant into an on-going chat contact
create_persistent_contact_associationEnables rehydration of chats for the lifespan of a contact
create_predefined_attributeCreates a new predefined attribute for the specified Amazon Connect instance
create_promptCreates a prompt
create_queueThis API is in preview release for Amazon Connect and is subject to change
create_quick_connectCreates a quick connect for the specified Amazon Connect instance
create_routing_profileCreates a new routing profile
create_ruleCreates a rule for the specified Amazon Connect instance
create_security_profileCreates a security profile
create_task_templateCreates a new task template in the specified Amazon Connect instance
create_traffic_distribution_groupCreates a traffic distribution group given an Amazon Connect instance that has been replicated
create_use_caseCreates a use case for an integration association
create_userCreates a user account for the specified Amazon Connect instance
create_user_hierarchy_groupCreates a new user hierarchy group
create_viewCreates a new view with the possible status of SAVED or PUBLISHED
create_view_versionPublishes a new version of the view identifier
create_vocabularyCreates a custom vocabulary associated with your Amazon Connect instance
deactivate_evaluation_formDeactivates an evaluation form in the specified Amazon Connect instance
delete_contact_evaluationDeletes a contact evaluation in the specified Amazon Connect instance
delete_contact_flowDeletes a flow for the specified Amazon Connect instance
delete_contact_flow_moduleDeletes the specified flow module
delete_evaluation_formDeletes an evaluation form in the specified Amazon Connect instance
delete_hours_of_operationThis API is in preview release for Amazon Connect and is subject to change
delete_instanceThis API is in preview release for Amazon Connect and is subject to change
delete_integration_associationDeletes an Amazon Web Services resource association from an Amazon Connect instance
delete_predefined_attributeDeletes a predefined attribute from the specified Amazon Connect instance
delete_promptDeletes a prompt
delete_queueDeletes a queue
delete_quick_connectDeletes a quick connect
delete_routing_profileDeletes a routing profile
delete_ruleDeletes a rule for the specified Amazon Connect instance
delete_security_profileDeletes a security profile
delete_task_templateDeletes the task template
delete_traffic_distribution_groupDeletes a traffic distribution group
delete_use_caseDeletes a use case from an integration association
delete_userDeletes a user account from the specified Amazon Connect instance
delete_user_hierarchy_groupDeletes an existing user hierarchy group
delete_viewDeletes the view entirely
delete_view_versionDeletes the particular version specified in ViewVersion identifier
delete_vocabularyDeletes the vocabulary that has the given identifier
describe_agent_statusThis API is in preview release for Amazon Connect and is subject to change
describe_contactThis API is in preview release for Amazon Connect and is subject to change
describe_contact_evaluationDescribes a contact evaluation in the specified Amazon Connect instance
describe_contact_flowDescribes the specified flow
describe_contact_flow_moduleDescribes the specified flow module
describe_evaluation_formDescribes an evaluation form in the specified Amazon Connect instance
describe_hours_of_operationThis API is in preview release for Amazon Connect and is subject to change
describe_instanceThis API is in preview release for Amazon Connect and is subject to change
describe_instance_attributeThis API is in preview release for Amazon Connect and is subject to change
describe_instance_storage_configThis API is in preview release for Amazon Connect and is subject to change
describe_phone_numberGets details and status of a phone number that’s claimed to your Amazon Connect instance or traffic distribution group
describe_predefined_attributeDescribes a predefined attribute for the specified Amazon Connect instance
describe_promptDescribes the prompt
describe_queueThis API is in preview release for Amazon Connect and is subject to change
describe_quick_connectDescribes the quick connect
describe_routing_profileDescribes the specified routing profile
describe_ruleDescribes a rule for the specified Amazon Connect instance
describe_security_profileGets basic information about the security profle
describe_traffic_distribution_groupGets details and status of a traffic distribution group
describe_userDescribes the specified user
describe_user_hierarchy_groupDescribes the specified hierarchy group
describe_user_hierarchy_structureDescribes the hierarchy structure of the specified Amazon Connect instance
describe_viewRetrieves the view for the specified Amazon Connect instance and view identifier
describe_vocabularyDescribes the specified vocabulary
disassociate_analytics_data_setThis API is in preview release for Amazon Connect and is subject to change
disassociate_approved_originThis API is in preview release for Amazon Connect and is subject to change
disassociate_botThis API is in preview release for Amazon Connect and is subject to change
disassociate_flowDisassociates a connect resource from a flow
disassociate_instance_storage_configThis API is in preview release for Amazon Connect and is subject to change
disassociate_lambda_functionThis API is in preview release for Amazon Connect and is subject to change
disassociate_lex_botThis API is in preview release for Amazon Connect and is subject to change
disassociate_phone_number_contact_flowRemoves the flow association from a phone number claimed to your Amazon Connect instance
disassociate_queue_quick_connectsThis API is in preview release for Amazon Connect and is subject to change
disassociate_routing_profile_queuesDisassociates a set of queues from a routing profile
disassociate_security_keyThis API is in preview release for Amazon Connect and is subject to change
disassociate_traffic_distribution_group_userDisassociates an agent from a traffic distribution group
disassociate_user_proficienciesDisassociates a set of proficiencies from a user
dismiss_user_contactDismisses 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_contact_attributesRetrieves the contact attributes for the specified contact
get_current_metric_dataGets the real-time metric data from the specified Amazon Connect instance
get_current_user_dataGets the real-time active user data from the specified Amazon Connect instance
get_federation_tokenSupports SAML sign-in for Amazon Connect
get_flow_associationRetrieves the flow associated for a given resource
get_metric_dataGets historical metric data from the specified Amazon Connect instance
get_metric_data_v2Gets metric data from the specified Amazon Connect instance
get_prompt_fileGets the prompt file
get_task_templateGets details about a specific task template in the specified Amazon Connect instance
get_traffic_distributionRetrieves the current traffic distribution for a given traffic distribution group
import_phone_numberImports a claimed phone number from an external service, such as Amazon Pinpoint, into an Amazon Connect instance
list_agent_statusesThis API is in preview release for Amazon Connect and is subject to change
list_analytics_data_associationsThis API is in preview release for Amazon Connect and is subject to change
list_approved_originsThis API is in preview release for Amazon Connect and is subject to change
list_botsThis API is in preview release for Amazon Connect and is subject to change
list_contact_evaluationsLists contact evaluations in the specified Amazon Connect instance
list_contact_flow_modulesProvides information about the flow modules for the specified Amazon Connect instance
list_contact_flowsProvides information about the flows for the specified Amazon Connect instance
list_contact_referencesThis API is in preview release for Amazon Connect and is subject to change
list_default_vocabulariesLists the default vocabularies for the specified Amazon Connect instance
list_evaluation_formsLists evaluation forms in the specified Amazon Connect instance
list_evaluation_form_versionsLists versions of an evaluation form in the specified Amazon Connect instance
list_flow_associationsList the flow association based on the filters
list_hours_of_operationsProvides information about the hours of operation for the specified Amazon Connect instance
list_instance_attributesThis API is in preview release for Amazon Connect and is subject to change
list_instancesThis API is in preview release for Amazon Connect and is subject to change
list_instance_storage_configsThis API is in preview release for Amazon Connect and is subject to change
list_integration_associationsProvides summary information about the Amazon Web Services resource associations for the specified Amazon Connect instance
list_lambda_functionsThis API is in preview release for Amazon Connect and is subject to change
list_lex_botsThis API is in preview release for Amazon Connect and is subject to change
list_phone_numbersProvides information about the phone numbers for the specified Amazon Connect instance
list_phone_numbers_v2Lists phone numbers claimed to your Amazon Connect instance or traffic distribution group
list_predefined_attributesLists predefined attributes for the specified Amazon Connect instance
list_promptsProvides information about the prompts for the specified Amazon Connect instance
list_queue_quick_connectsThis API is in preview release for Amazon Connect and is subject to change
list_queuesProvides information about the queues for the specified Amazon Connect instance
list_quick_connectsProvides information about the quick connects for the specified Amazon Connect instance
list_realtime_contact_analysis_segments_v2Provides a list of analysis segments for a real-time analysis session
list_routing_profile_queuesLists the queues associated with a routing profile
list_routing_profilesProvides summary information about the routing profiles for the specified Amazon Connect instance
list_rulesList all rules for the specified Amazon Connect instance
list_security_keysThis API is in preview release for Amazon Connect and is subject to change
list_security_profile_applicationsReturns a list of third-party applications in a specific security profile
list_security_profile_permissionsLists the permissions granted to a security profile
list_security_profilesProvides summary information about the security profiles for the specified Amazon Connect instance
list_tags_for_resourceLists the tags for the specified resource
list_task_templatesLists task templates for the specified Amazon Connect instance
list_traffic_distribution_groupsLists traffic distribution groups
list_traffic_distribution_group_usersLists traffic distribution group users
list_use_casesLists the use cases for the integration association
list_user_hierarchy_groupsProvides summary information about the hierarchy groups for the specified Amazon Connect instance
list_user_proficienciesLists proficiencies associated with a user
list_usersProvides summary information about the users for the specified Amazon Connect instance
list_viewsReturns views in the given instance
list_view_versionsReturns all the available versions for the specified Amazon Connect instance and view identifier
monitor_contactInitiates silent monitoring of a contact
pause_contactAllows pausing an ongoing task contact
put_user_statusChanges the current status of a user or agent in Amazon Connect
release_phone_numberReleases a phone number previously claimed to an Amazon Connect instance or traffic distribution group
replicate_instanceReplicates 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_contactAllows resuming a task contact in a paused state
resume_contact_recordingWhen 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_available_phone_numbersSearches for available phone numbers that you can claim to your Amazon Connect instance or traffic distribution group
search_contactsSearches contacts in an Amazon Connect instance
search_hours_of_operationsSearches the hours of operation in an Amazon Connect instance, with optional filtering
search_predefined_attributesPredefined attributes that meet certain criteria
search_promptsSearches prompts in an Amazon Connect instance, with optional filtering
search_queuesSearches queues in an Amazon Connect instance, with optional filtering
search_quick_connectsSearches quick connects in an Amazon Connect instance, with optional filtering
search_resource_tagsSearches tags used in an Amazon Connect instance using optional search criteria
search_routing_profilesSearches routing profiles in an Amazon Connect instance, with optional filtering
search_security_profilesSearches security profiles in an Amazon Connect instance, with optional filtering
search_usersSearches users in an Amazon Connect instance, with optional filtering
search_vocabulariesSearches for vocabularies within a specific Amazon Connect instance using State, NameStartsWith, and LanguageCode
send_chat_integration_eventProcesses chat integration events from Amazon Web Services or external integrations to Amazon Connect
start_chat_contactInitiates a flow to start a new chat for the customer
start_contact_evaluationStarts an empty evaluation in the specified Amazon Connect instance, using the given evaluation form for the particular contact
start_contact_recordingStarts recording the contact:
start_contact_streamingInitiates real-time message streaming for a new chat contact
start_outbound_voice_contactPlaces an outbound call to a contact, and then initiates the flow
start_task_contactInitiates a flow to start a new task contact
start_web_rtc_contactPlaces an inbound in-app, web, or video call to a contact, and then initiates the flow
stop_contactEnds the specified contact
stop_contact_recordingStops recording a call when a contact is being recorded
stop_contact_streamingEnds message streaming on a specified contact
submit_contact_evaluationSubmits a contact evaluation in the specified Amazon Connect instance
suspend_contact_recordingWhen a contact is being recorded, this API suspends recording whatever is selected in the flow configuration: call, screen, or both
tag_contactAdds the specified tags to the contact resource
tag_resourceAdds the specified tags to the specified resource
transfer_contactTransfers contacts from one agent or queue to another agent or queue at any point after a contact is created
untag_contactRemoves the specified tags from the contact resource
untag_resourceRemoves the specified tags from the specified resource
update_agent_statusThis API is in preview release for Amazon Connect and is subject to change
update_contactThis API is in preview release for Amazon Connect and is subject to change
update_contact_attributesCreates or updates user-defined contact attributes associated with the specified contact
update_contact_evaluationUpdates details about a contact evaluation in the specified Amazon Connect instance
update_contact_flow_contentUpdates the specified flow
update_contact_flow_metadataUpdates metadata about specified flow
update_contact_flow_module_contentUpdates specified flow module for the specified Amazon Connect instance
update_contact_flow_module_metadataUpdates metadata about specified flow module
update_contact_flow_nameThe name of the flow
update_contact_routing_dataThis API is in preview release for Amazon Connect and is subject to change
update_contact_scheduleUpdates the scheduled time of a task contact that is already scheduled
update_evaluation_formUpdates details about a specific evaluation form version in the specified Amazon Connect instance
update_hours_of_operationThis API is in preview release for Amazon Connect and is subject to change
update_instance_attributeThis API is in preview release for Amazon Connect and is subject to change
update_instance_storage_configThis API is in preview release for Amazon Connect and is subject to change
update_participant_role_configUpdates 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_numberUpdates 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_metadataUpdates a phone number’s metadata
update_predefined_attributeUpdates a predefined attribute for the specified Amazon Connect instance
update_promptUpdates a prompt
update_queue_hours_of_operationThis API is in preview release for Amazon Connect and is subject to change
update_queue_max_contactsThis API is in preview release for Amazon Connect and is subject to change
update_queue_nameThis API is in preview release for Amazon Connect and is subject to change
update_queue_outbound_caller_configThis API is in preview release for Amazon Connect and is subject to change
update_queue_statusThis API is in preview release for Amazon Connect and is subject to change
update_quick_connect_configUpdates the configuration settings for the specified quick connect
update_quick_connect_nameUpdates the name and description of a quick connect
update_routing_profile_agent_availability_timerWhether 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_concurrencyUpdates the channels that agents can handle in the Contact Control Panel (CCP) for a routing profile
update_routing_profile_default_outbound_queueUpdates the default outbound queue of a routing profile
update_routing_profile_nameUpdates the name and description of a routing profile
update_routing_profile_queuesUpdates the properties associated with a set of queues for a routing profile
update_ruleUpdates a rule for the specified Amazon Connect instance
update_security_profileUpdates a security profile
update_task_templateUpdates details about a specific task template in the specified Amazon Connect instance
update_traffic_distributionUpdates the traffic distribution for a given traffic distribution group
update_user_hierarchyAssigns the specified hierarchy group to the specified user
update_user_hierarchy_group_nameUpdates the name of the user hierarchy group
update_user_hierarchy_structureUpdates the user hierarchy structure: add, remove, and rename user hierarchy levels
update_user_identity_infoUpdates the identity information for the specified user
update_user_phone_configUpdates the phone configuration settings for the specified user
update_user_proficienciesUpdates the properties associated with the proficiencies of a user
update_user_routing_profileAssigns the specified routing profile to the specified user
update_user_security_profilesAssigns the specified security profiles to the specified user
update_view_contentUpdates the view content of the given view identifier in the specified Amazon Connect instance
update_view_metadataUpdates the view metadata

Examples

Run this code
if (FALSE) {
svc <- connect()
svc$activate_evaluation_form(
  Foo = 123
)
}

Run the code above in your browser using DataLab