Skip to contents

Connect Customer Customer Profiles

Connect Customer Customer Profiles is a unified customer profile for your contact center that has pre-built connectors powered by AppFlow that make it easy to combine customer information from third party applications, such as Salesforce (CRM), ServiceNow (ITSM), and your enterprise resource planning (ERP), with contact history from your Connect Customer contact center.

For more information about the Connect Customer Customer Profiles feature, see Use Customer Profiles in the Connect Customer Administrator's Guide.

Usage

customerprofiles(
  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.

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 <- customerprofiles(
  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

add_profile_keyAssociates a new key value with a specific profile, such as a Contact Record ContactId
batch_get_calculated_attribute_for_profileFetch the possible attribute values given the attribute name
batch_get_profileGet a batch of profiles
create_calculated_attribute_definitionCreates a new calculated attribute definition
create_domainCreates a domain, which is a container for all customer data, such as customer profile attributes, object types, profile keys, and encryption keys
create_domain_layoutCreates the layout to view data for a specific domain
create_event_streamCreates an event stream, which is a subscription to real-time events, such as when profiles are created and updated through Connect Customer Customer Profiles
create_event_triggerCreates an event trigger, which specifies the rules when to perform action based on customer's ingested data
create_integration_workflowCreates an integration workflow
create_profileCreates a standard profile
create_recommenderCreates a recommender
create_recommender_filterCreates a recommender filter
create_recommender_schemaCreates a recommender schema
create_segment_definitionCreates a segment definition associated to the given domain
create_segment_estimateCreates a segment estimate query
create_segment_snapshotTriggers a job to export a segment to a specified destination
create_upload_jobCreates an Upload job to ingest data for segment imports
delete_calculated_attribute_definitionDeletes an existing calculated attribute definition
delete_domainDeletes a specific domain and all of its customer data, such as customer profile attributes and their related objects
delete_domain_layoutDeletes the layout used to view data for a specific domain
delete_domain_object_typeDelete a DomainObjectType for the given Domain and ObjectType name
delete_event_streamDisables and deletes the specified event stream
delete_event_triggerDisable and deletes the Event Trigger
delete_integrationRemoves an integration from a specific domain
delete_profileDeletes the standard customer profile and all data pertaining to the profile
delete_profile_keyRemoves a searchable key from a customer profile
delete_profile_objectRemoves an object associated with a profile of a given ProfileObjectType
delete_profile_object_typeRemoves a ProfileObjectType from a specific domain as well as removes all the ProfileObjects of that type
delete_recommenderDeletes a recommender
delete_recommender_filterDeletes a recommender filter from a domain
delete_recommender_schemaDeletes a recommender schema from a domain
delete_segment_definitionDeletes a segment definition from the domain
delete_workflowDeletes the specified workflow and all its corresponding resources
detect_profile_object_typeThe process of detecting profile object type mapping by using given objects
get_auto_merging_previewTests the auto-merging settings of your Identity Resolution Job without merging your data
get_calculated_attribute_definitionProvides more information on a calculated attribute definition for Customer Profiles
get_calculated_attribute_for_profileRetrieve a calculated attribute for a customer profile
get_domainReturns information about a specific domain
get_domain_layoutGets the layout to view data for a specific domain
get_domain_object_typeReturn a DomainObjectType for the input Domain and ObjectType names
get_event_streamReturns information about the specified event stream in a specific domain
get_event_triggerGet a specific Event Trigger from the domain
get_identity_resolution_jobReturns information about an Identity Resolution Job in a specific domain
get_integrationReturns an integration for a domain
get_matchesBefore calling this API, use CreateDomain or UpdateDomain to enable identity resolution: set Matching to true
get_object_type_attribute_statisticsThe GetObjectTypeAttributeValues API delivers statistical insights about attributes within a specific object type, but is exclusively available for domains with data store enabled
get_profile_history_recordReturns a history record for a specific profile, for a specific domain
get_profile_object_typeReturns the object types for a specific domain
get_profile_object_type_templateReturns the template information for a specific object type
get_profile_recommendationsFetches the recommendations for a profile in the input Customer Profiles domain
get_recommenderRetrieves a recommender
get_recommender_filterRetrieves information about a specific recommender filter in a domain
get_recommender_schemaRetrieves information about a specific recommender schema in a domain
get_segment_definitionGets a segment definition from the domain
get_segment_estimateGets the result of a segment estimate query
get_segment_membershipDetermines if the given profiles are within a segment
get_segment_snapshotRetrieve the latest status of a segment snapshot
get_similar_profilesReturns a set of profiles that belong to the same matching group using the matchId or profileId
get_upload_jobThis API retrieves the details of a specific upload job
get_upload_job_pathThis API retrieves the pre-signed URL and client token for uploading the file associated with the upload job
get_workflowGet details of specified workflow
get_workflow_stepsGet granular list of steps in workflow
list_account_integrationsLists all of the integrations associated to a specific URI in the AWS account
list_calculated_attribute_definitionsLists calculated attribute definitions for Customer Profiles
list_calculated_attributes_for_profileRetrieve a list of calculated attributes for a customer profile
list_domain_layoutsLists the existing layouts that can be used to view data for a specific domain
list_domain_object_typesList all DomainObjectType(s) in a Customer Profiles domain
list_domainsReturns a list of all the domains for an AWS account that have been created
list_event_streamsReturns a list of all the event streams in a specific domain
list_event_triggersList all Event Triggers under a domain
list_identity_resolution_jobsLists all of the Identity Resolution Jobs in your domain
list_integrationsLists all of the integrations in your domain
list_object_type_attributesFetch the possible attribute values given the attribute name
list_object_type_attribute_valuesThe ListObjectTypeAttributeValues API provides access to the most recent distinct values for any specified attribute, making it valuable for real-time data validation and consistency checks within your object types
list_profile_attribute_valuesFetch the possible attribute values given the attribute name
list_profile_history_recordsReturns a list of history records for a specific profile, for a specific domain
list_profile_objectsReturns a list of objects associated with a profile of a given ProfileObjectType
list_profile_object_typesLists all of the templates available within the service
list_profile_object_type_templatesLists all of the template information for object types
list_recommender_filtersReturns a list of recommender filters in the specified domain
list_recommender_recipesReturns a list of available recommender recipes that can be used to create recommenders
list_recommendersReturns a list of recommenders in the specified domain
list_recommender_schemasReturns a list of recommender schemas in the specified domain
list_rule_based_matchesReturns a set of MatchIds that belong to the given domain
list_segment_definitionsLists all segment definitions under a domain
list_tags_for_resourceDisplays the tags associated with an Amazon Connect Customer Profiles resource
list_upload_jobsThis API retrieves a list of upload jobs for the specified domain
list_workflowsQuery to list all workflows
merge_profilesRuns an AWS Lambda job that does the following:
put_domain_object_typeCreate/Update a DomainObjectType in a Customer Profiles domain
put_integrationAdds an integration between the service and a third-party service, which includes Amazon AppFlow and Amazon Connect
put_profile_objectAdds additional objects to customer profiles of a given ObjectType
put_profile_object_typeDefines a ProfileObjectType
search_profilesSearches for profiles within a specific domain using one or more predefined search keys (e
start_recommenderStarts a recommender that was previously stopped
start_upload_jobThis API starts the processing of an upload job to ingest profile data
stop_recommenderStops a recommender, suspending its ability to generate recommendations
stop_upload_jobThis API stops the processing of an upload job
tag_resourceAssigns one or more tags (key-value pairs) to the specified Amazon Connect Customer Profiles resource
untag_resourceRemoves one or more tags from the specified Amazon Connect Customer Profiles resource
update_calculated_attribute_definitionUpdates an existing calculated attribute definition
update_domainUpdates the properties of a domain, including creating or selecting a dead letter queue or an encryption key
update_domain_layoutUpdates the layout used to view data for a specific domain
update_event_triggerUpdate the properties of an Event Trigger
update_profileUpdates the properties of a profile
update_recommenderUpdates the properties of an existing recommender, allowing you to modify its configuration and description

Examples

if (FALSE) { # \dontrun{
svc <- customerprofiles()
svc$add_profile_key(
  Foo = 123
)
} # }