%% WARNING: DO NOT EDIT, AUTO-GENERATED CODE!
%% See https://github.com/aws-beam/aws-codegen for more details.
%% @doc Amazon Connect Customer Profiles
%%
%% Welcome to the Amazon Connect Customer Profiles API Reference.
%%
%% This guide provides information about the Amazon Connect Customer Profiles
%% API, including supported operations, data types, parameters, and schemas.
%%
%% Amazon Connect 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 Amazon Connect contact
%% center.
%%
%% If you're new to Amazon Connect , you might find it helpful to also review
%% the Amazon Connect Administrator Guide.
-module(aws_customer_profiles).
-export([add_profile_key/3,
add_profile_key/4,
create_domain/3,
create_domain/4,
create_profile/3,
create_profile/4,
delete_domain/3,
delete_domain/4,
delete_integration/3,
delete_integration/4,
delete_profile/3,
delete_profile/4,
delete_profile_key/3,
delete_profile_key/4,
delete_profile_object/3,
delete_profile_object/4,
delete_profile_object_type/4,
delete_profile_object_type/5,
get_domain/2,
get_domain/4,
get_domain/5,
get_integration/3,
get_integration/4,
get_matches/2,
get_matches/4,
get_matches/5,
get_profile_object_type/3,
get_profile_object_type/5,
get_profile_object_type/6,
get_profile_object_type_template/2,
get_profile_object_type_template/4,
get_profile_object_type_template/5,
list_account_integrations/2,
list_account_integrations/3,
list_domains/1,
list_domains/3,
list_domains/4,
list_integrations/2,
list_integrations/4,
list_integrations/5,
list_profile_object_type_templates/1,
list_profile_object_type_templates/3,
list_profile_object_type_templates/4,
list_profile_object_types/2,
list_profile_object_types/4,
list_profile_object_types/5,
list_profile_objects/3,
list_profile_objects/4,
list_tags_for_resource/2,
list_tags_for_resource/4,
list_tags_for_resource/5,
merge_profiles/3,
merge_profiles/4,
put_integration/3,
put_integration/4,
put_profile_object/3,
put_profile_object/4,
put_profile_object_type/4,
put_profile_object_type/5,
search_profiles/3,
search_profiles/4,
tag_resource/3,
tag_resource/4,
untag_resource/3,
untag_resource/4,
update_domain/3,
update_domain/4,
update_profile/3,
update_profile/4]).
-include_lib("hackney/include/hackney_lib.hrl").
%%====================================================================
%% API
%%====================================================================
%% @doc Associates a new key value with a specific profile, such as a Contact
%% Trace Record (CTR) ContactId.
%%
%% A profile object can have a single unique key and any number of additional
%% keys that can be used to identify the profile that it belongs to.
add_profile_key(Client, DomainName, Input) ->
add_profile_key(Client, DomainName, Input, []).
add_profile_key(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles/keys"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Creates a domain, which is a container for all customer data, such as
%% customer profile attributes, object types, profile keys, and encryption
%% keys.
%%
%% You can create multiple domains, and each domain can have multiple
%% third-party integrations.
%%
%% Each Amazon Connect instance can be associated with only one domain.
%% Multiple Amazon Connect instances can be associated with one domain.
%%
%% Use this API or UpdateDomain to enable identity resolution: set `Matching'
%% to true.
create_domain(Client, DomainName, Input) ->
create_domain(Client, DomainName, Input, []).
create_domain(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Creates a standard profile.
%%
%% A standard profile represents the following attributes for a customer
%% profile in a domain.
create_profile(Client, DomainName, Input) ->
create_profile(Client, DomainName, Input, []).
create_profile(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Deletes a specific domain and all of its customer data, such as
%% customer profile attributes and their related objects.
delete_domain(Client, DomainName, Input) ->
delete_domain(Client, DomainName, Input, []).
delete_domain(Client, DomainName, Input0, Options0) ->
Method = delete,
Path = ["/domains/", aws_util:encode_uri(DomainName), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Removes an integration from a specific domain.
delete_integration(Client, DomainName, Input) ->
delete_integration(Client, DomainName, Input, []).
delete_integration(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/integrations/delete"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Deletes the standard customer profile and all data pertaining to the
%% profile.
delete_profile(Client, DomainName, Input) ->
delete_profile(Client, DomainName, Input, []).
delete_profile(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles/delete"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Removes a searchable key from a customer profile.
delete_profile_key(Client, DomainName, Input) ->
delete_profile_key(Client, DomainName, Input, []).
delete_profile_key(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles/keys/delete"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Removes an object associated with a profile of a given
%% ProfileObjectType.
delete_profile_object(Client, DomainName, Input) ->
delete_profile_object(Client, DomainName, Input, []).
delete_profile_object(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles/objects/delete"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Removes a ProfileObjectType from a specific domain as well as removes
%% all the ProfileObjects of that type.
%%
%% It also disables integrations from this specific ProfileObjectType. In
%% addition, it scrubs all of the fields of the standard profile that were
%% populated from this ProfileObjectType.
delete_profile_object_type(Client, DomainName, ObjectTypeName, Input) ->
delete_profile_object_type(Client, DomainName, ObjectTypeName, Input, []).
delete_profile_object_type(Client, DomainName, ObjectTypeName, Input0, Options0) ->
Method = delete,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/object-types/", aws_util:encode_uri(ObjectTypeName), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Returns information about a specific domain.
get_domain(Client, DomainName)
when is_map(Client) ->
get_domain(Client, DomainName, #{}, #{}).
get_domain(Client, DomainName, QueryMap, HeadersMap)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap) ->
get_domain(Client, DomainName, QueryMap, HeadersMap, []).
get_domain(Client, DomainName, QueryMap, HeadersMap, Options0)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap), is_list(Options0) ->
Path = ["/domains/", aws_util:encode_uri(DomainName), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Query_ = [],
request(Client, get, Path, Query_, Headers, undefined, Options, SuccessStatusCode).
%% @doc Returns an integration for a domain.
get_integration(Client, DomainName, Input) ->
get_integration(Client, DomainName, Input, []).
get_integration(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/integrations"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc This API is in preview release for Amazon Connect and subject to
%% change.
%%
%% Before calling this API, use CreateDomain or UpdateDomain to enable
%% identity resolution: set `Matching' to true.
%%
%% GetMatches returns potentially matching profiles, based on the results of
%% the latest run of a machine learning process.
%%
%% Amazon Connect starts a batch process every Saturday at 12AM UTC to
%% identify matching profiles. The results are returned up to seven days
%% after the Saturday run.
%%
%% Amazon Connect uses the following profile attributes to identify matches:
%%
%%
- PhoneNumber
%%
%%
- HomePhoneNumber
%%
%%
- BusinessPhoneNumber
%%
%%
- MobilePhoneNumber
%%
%%
- EmailAddress
%%
%%
- PersonalEmailAddress
%%
%%
- BusinessEmailAddress
%%
%%
- FullName
%%
%%
- BusinessName
%%
%%
For example, two or more profiles—with spelling mistakes such
%% as John Doe and Jhn Doe, or different casing email addresses such as
%% JOHN_DOE@ANYCOMPANY.COM and johndoe@anycompany.com, or different phone
%% number formats such as 555-010-0000 and +1-555-010-0000—can be detected as
%% belonging to the same customer John Doe and merged into a unified profile.
get_matches(Client, DomainName)
when is_map(Client) ->
get_matches(Client, DomainName, #{}, #{}).
get_matches(Client, DomainName, QueryMap, HeadersMap)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap) ->
get_matches(Client, DomainName, QueryMap, HeadersMap, []).
get_matches(Client, DomainName, QueryMap, HeadersMap, Options0)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap), is_list(Options0) ->
Path = ["/domains/", aws_util:encode_uri(DomainName), "/matches"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Query0_ =
[
{<<"max-results">>, maps:get(<<"max-results">>, QueryMap, undefined)},
{<<"next-token">>, maps:get(<<"next-token">>, QueryMap, undefined)}
],
Query_ = [H || {_, V} = H <- Query0_, V =/= undefined],
request(Client, get, Path, Query_, Headers, undefined, Options, SuccessStatusCode).
%% @doc Returns the object types for a specific domain.
get_profile_object_type(Client, DomainName, ObjectTypeName)
when is_map(Client) ->
get_profile_object_type(Client, DomainName, ObjectTypeName, #{}, #{}).
get_profile_object_type(Client, DomainName, ObjectTypeName, QueryMap, HeadersMap)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap) ->
get_profile_object_type(Client, DomainName, ObjectTypeName, QueryMap, HeadersMap, []).
get_profile_object_type(Client, DomainName, ObjectTypeName, QueryMap, HeadersMap, Options0)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap), is_list(Options0) ->
Path = ["/domains/", aws_util:encode_uri(DomainName), "/object-types/", aws_util:encode_uri(ObjectTypeName), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Query_ = [],
request(Client, get, Path, Query_, Headers, undefined, Options, SuccessStatusCode).
%% @doc Returns the template information for a specific object type.
%%
%% A template is a predefined ProfileObjectType, such as “Salesforce-Account”
%% or “Salesforce-Contact.” When a user sends a ProfileObject, using the
%% PutProfileObject API, with an ObjectTypeName that matches one of the
%% TemplateIds, it uses the mappings from the template.
get_profile_object_type_template(Client, TemplateId)
when is_map(Client) ->
get_profile_object_type_template(Client, TemplateId, #{}, #{}).
get_profile_object_type_template(Client, TemplateId, QueryMap, HeadersMap)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap) ->
get_profile_object_type_template(Client, TemplateId, QueryMap, HeadersMap, []).
get_profile_object_type_template(Client, TemplateId, QueryMap, HeadersMap, Options0)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap), is_list(Options0) ->
Path = ["/templates/", aws_util:encode_uri(TemplateId), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Query_ = [],
request(Client, get, Path, Query_, Headers, undefined, Options, SuccessStatusCode).
%% @doc Lists all of the integrations associated to a specific URI in the AWS
%% account.
list_account_integrations(Client, Input) ->
list_account_integrations(Client, Input, []).
list_account_integrations(Client, Input0, Options0) ->
Method = post,
Path = ["/integrations"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
QueryMapping = [
{<<"max-results">>, <<"MaxResults">>},
{<<"next-token">>, <<"NextToken">>}
],
{Query_, Input} = aws_request:build_headers(QueryMapping, Input2),
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Returns a list of all the domains for an AWS account that have been
%% created.
list_domains(Client)
when is_map(Client) ->
list_domains(Client, #{}, #{}).
list_domains(Client, QueryMap, HeadersMap)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap) ->
list_domains(Client, QueryMap, HeadersMap, []).
list_domains(Client, QueryMap, HeadersMap, Options0)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap), is_list(Options0) ->
Path = ["/domains"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Query0_ =
[
{<<"max-results">>, maps:get(<<"max-results">>, QueryMap, undefined)},
{<<"next-token">>, maps:get(<<"next-token">>, QueryMap, undefined)}
],
Query_ = [H || {_, V} = H <- Query0_, V =/= undefined],
request(Client, get, Path, Query_, Headers, undefined, Options, SuccessStatusCode).
%% @doc Lists all of the integrations in your domain.
list_integrations(Client, DomainName)
when is_map(Client) ->
list_integrations(Client, DomainName, #{}, #{}).
list_integrations(Client, DomainName, QueryMap, HeadersMap)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap) ->
list_integrations(Client, DomainName, QueryMap, HeadersMap, []).
list_integrations(Client, DomainName, QueryMap, HeadersMap, Options0)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap), is_list(Options0) ->
Path = ["/domains/", aws_util:encode_uri(DomainName), "/integrations"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Query0_ =
[
{<<"max-results">>, maps:get(<<"max-results">>, QueryMap, undefined)},
{<<"next-token">>, maps:get(<<"next-token">>, QueryMap, undefined)}
],
Query_ = [H || {_, V} = H <- Query0_, V =/= undefined],
request(Client, get, Path, Query_, Headers, undefined, Options, SuccessStatusCode).
%% @doc Lists all of the template information for object types.
list_profile_object_type_templates(Client)
when is_map(Client) ->
list_profile_object_type_templates(Client, #{}, #{}).
list_profile_object_type_templates(Client, QueryMap, HeadersMap)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap) ->
list_profile_object_type_templates(Client, QueryMap, HeadersMap, []).
list_profile_object_type_templates(Client, QueryMap, HeadersMap, Options0)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap), is_list(Options0) ->
Path = ["/templates"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Query0_ =
[
{<<"max-results">>, maps:get(<<"max-results">>, QueryMap, undefined)},
{<<"next-token">>, maps:get(<<"next-token">>, QueryMap, undefined)}
],
Query_ = [H || {_, V} = H <- Query0_, V =/= undefined],
request(Client, get, Path, Query_, Headers, undefined, Options, SuccessStatusCode).
%% @doc Lists all of the templates available within the service.
list_profile_object_types(Client, DomainName)
when is_map(Client) ->
list_profile_object_types(Client, DomainName, #{}, #{}).
list_profile_object_types(Client, DomainName, QueryMap, HeadersMap)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap) ->
list_profile_object_types(Client, DomainName, QueryMap, HeadersMap, []).
list_profile_object_types(Client, DomainName, QueryMap, HeadersMap, Options0)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap), is_list(Options0) ->
Path = ["/domains/", aws_util:encode_uri(DomainName), "/object-types"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Query0_ =
[
{<<"max-results">>, maps:get(<<"max-results">>, QueryMap, undefined)},
{<<"next-token">>, maps:get(<<"next-token">>, QueryMap, undefined)}
],
Query_ = [H || {_, V} = H <- Query0_, V =/= undefined],
request(Client, get, Path, Query_, Headers, undefined, Options, SuccessStatusCode).
%% @doc Returns a list of objects associated with a profile of a given
%% ProfileObjectType.
list_profile_objects(Client, DomainName, Input) ->
list_profile_objects(Client, DomainName, Input, []).
list_profile_objects(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles/objects"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
QueryMapping = [
{<<"max-results">>, <<"MaxResults">>},
{<<"next-token">>, <<"NextToken">>}
],
{Query_, Input} = aws_request:build_headers(QueryMapping, Input2),
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Displays the tags associated with an Amazon Connect Customer Profiles
%% resource.
%%
%% In Connect Customer Profiles, domains, profile object types, and
%% integrations can be tagged.
list_tags_for_resource(Client, ResourceArn)
when is_map(Client) ->
list_tags_for_resource(Client, ResourceArn, #{}, #{}).
list_tags_for_resource(Client, ResourceArn, QueryMap, HeadersMap)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap) ->
list_tags_for_resource(Client, ResourceArn, QueryMap, HeadersMap, []).
list_tags_for_resource(Client, ResourceArn, QueryMap, HeadersMap, Options0)
when is_map(Client), is_map(QueryMap), is_map(HeadersMap), is_list(Options0) ->
Path = ["/tags/", aws_util:encode_uri(ResourceArn), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Query_ = [],
request(Client, get, Path, Query_, Headers, undefined, Options, SuccessStatusCode).
%% @doc This API is in preview release for Amazon Connect and subject to
%% change.
%%
%% Runs an AWS Lambda job that does the following:
%%
%% - All the profileKeys in the `ProfileToBeMerged' will be moved to
%% the main profile.
%%
%%
- All the objects in the `ProfileToBeMerged' will be moved to the
%% main profile.
%%
%%
- All the `ProfileToBeMerged' will be deleted at the end.
%%
%%
- All the profileKeys in the `ProfileIdsToBeMerged' will be moved
%% to the main profile.
%%
%%
- Standard fields are merged as follows:
%%
%%
- Fields are always "union"-ed if there are no conflicts in
%% standard fields or attributeKeys.
%%
%%
- When there are conflicting fields:
%%
%%
- If no `SourceProfileIds' entry is specified, the main Profile
%% value is always taken.
%%
%%
- If a `SourceProfileIds' entry is specified, the specified
%% profileId is always taken, even if it is a NULL value.
%%
%%
You can use MergeProfiles together
%% with GetMatches, which returns potentially matching profiles, or use it
%% with the results of another matching system. After profiles have been
%% merged, they cannot be separated (unmerged).
merge_profiles(Client, DomainName, Input) ->
merge_profiles(Client, DomainName, Input, []).
merge_profiles(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles/objects/merge"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Adds an integration between the service and a third-party service,
%% which includes Amazon AppFlow and Amazon Connect.
%%
%% An integration can belong to only one domain.
put_integration(Client, DomainName, Input) ->
put_integration(Client, DomainName, Input, []).
put_integration(Client, DomainName, Input0, Options0) ->
Method = put,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/integrations"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Adds additional objects to customer profiles of a given ObjectType.
%%
%% When adding a specific profile object, like a Contact Trace Record (CTR),
%% an inferred profile can get created if it is not mapped to an existing
%% profile. The resulting profile will only have a phone number populated in
%% the standard ProfileObject. Any additional CTRs with the same phone number
%% will be mapped to the same inferred profile.
%%
%% When a ProfileObject is created and if a ProfileObjectType already exists
%% for the ProfileObject, it will provide data to a standard profile
%% depending on the ProfileObjectType definition.
%%
%% PutProfileObject needs an ObjectType, which can be created using
%% PutProfileObjectType.
put_profile_object(Client, DomainName, Input) ->
put_profile_object(Client, DomainName, Input, []).
put_profile_object(Client, DomainName, Input0, Options0) ->
Method = put,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles/objects"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Defines a ProfileObjectType.
put_profile_object_type(Client, DomainName, ObjectTypeName, Input) ->
put_profile_object_type(Client, DomainName, ObjectTypeName, Input, []).
put_profile_object_type(Client, DomainName, ObjectTypeName, Input0, Options0) ->
Method = put,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/object-types/", aws_util:encode_uri(ObjectTypeName), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Searches for profiles within a specific domain name using name, phone
%% number, email address, account number, or a custom defined index.
search_profiles(Client, DomainName, Input) ->
search_profiles(Client, DomainName, Input, []).
search_profiles(Client, DomainName, Input0, Options0) ->
Method = post,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles/search"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
QueryMapping = [
{<<"max-results">>, <<"MaxResults">>},
{<<"next-token">>, <<"NextToken">>}
],
{Query_, Input} = aws_request:build_headers(QueryMapping, Input2),
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Assigns one or more tags (key-value pairs) to the specified Amazon
%% Connect Customer Profiles resource.
%%
%% Tags can help you organize and categorize your resources. You can also use
%% them to scope user permissions by granting a user permission to access or
%% change only resources with certain tag values. In Connect Customer
%% Profiles, domains, profile object types, and integrations can be tagged.
%%
%% Tags don't have any semantic meaning to AWS and are interpreted strictly
%% as strings of characters.
%%
%% You can use the TagResource action with a resource that already has tags.
%% If you specify a new tag key, this tag is appended to the list of tags
%% associated with the resource. If you specify a tag key that is already
%% associated with the resource, the new tag value that you specify replaces
%% the previous value for that tag.
%%
%% You can associate as many as 50 tags with a resource.
tag_resource(Client, ResourceArn, Input) ->
tag_resource(Client, ResourceArn, Input, []).
tag_resource(Client, ResourceArn, Input0, Options0) ->
Method = post,
Path = ["/tags/", aws_util:encode_uri(ResourceArn), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Removes one or more tags from the specified Amazon Connect Customer
%% Profiles resource.
%%
%% In Connect Customer Profiles, domains, profile object types, and
%% integrations can be tagged.
untag_resource(Client, ResourceArn, Input) ->
untag_resource(Client, ResourceArn, Input, []).
untag_resource(Client, ResourceArn, Input0, Options0) ->
Method = delete,
Path = ["/tags/", aws_util:encode_uri(ResourceArn), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
QueryMapping = [
{<<"tagKeys">>, <<"tagKeys">>}
],
{Query_, Input} = aws_request:build_headers(QueryMapping, Input2),
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Updates the properties of a domain, including creating or selecting a
%% dead letter queue or an encryption key.
%%
%% After a domain is created, the name can’t be changed.
%%
%% Use this API or CreateDomain to enable identity resolution: set `Matching'
%% to true.
update_domain(Client, DomainName, Input) ->
update_domain(Client, DomainName, Input, []).
update_domain(Client, DomainName, Input0, Options0) ->
Method = put,
Path = ["/domains/", aws_util:encode_uri(DomainName), ""],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%% @doc Updates the properties of a profile.
%%
%% The ProfileId is required for updating a customer profile.
%%
%% When calling the UpdateProfile API, specifying an empty string value means
%% that any existing value will be removed. Not specifying a string value
%% means that any value already there will be kept.
update_profile(Client, DomainName, Input) ->
update_profile(Client, DomainName, Input, []).
update_profile(Client, DomainName, Input0, Options0) ->
Method = put,
Path = ["/domains/", aws_util:encode_uri(DomainName), "/profiles"],
SuccessStatusCode = undefined,
Options = [{send_body_as_binary, false},
{receive_body_as_binary, false}
| Options0],
Headers = [],
Input1 = Input0,
CustomHeaders = [],
Input2 = Input1,
Query_ = [],
Input = Input2,
request(Client, Method, Path, Query_, CustomHeaders ++ Headers, Input, Options, SuccessStatusCode).
%%====================================================================
%% Internal functions
%%====================================================================
-spec request(aws_client:aws_client(), atom(), iolist(), list(),
list(), map() | undefined, list(), pos_integer() | undefined) ->
{ok, {integer(), list()}} |
{ok, Result, {integer(), list(), hackney:client()}} |
{error, Error, {integer(), list(), hackney:client()}} |
{error, term()} when
Result :: map(),
Error :: map().
request(Client, Method, Path, Query, Headers0, Input, Options, SuccessStatusCode) ->
RequestFun = fun() -> do_request(Client, Method, Path, Query, Headers0, Input, Options, SuccessStatusCode) end,
aws_request:request(RequestFun, Options).
do_request(Client, Method, Path, Query, Headers0, Input, Options, SuccessStatusCode) ->
Client1 = Client#{service => <<"profile">>},
Host = build_host(<<"profile">>, Client1),
URL0 = build_url(Host, Path, Client1),
URL = aws_request:add_query(URL0, Query),
AdditionalHeaders = [ {<<"Host">>, Host}
, {<<"Content-Type">>, <<"application/x-amz-json-1.1">>}
],
Headers1 = aws_request:add_headers(AdditionalHeaders, Headers0),
Payload =
case proplists:get_value(send_body_as_binary, Options) of
true ->
maps:get(<<"Body">>, Input, <<"">>);
false ->
encode_payload(Input)
end,
MethodBin = aws_request:method_to_binary(Method),
SignedHeaders = aws_request:sign_request(Client1, MethodBin, URL, Headers1, Payload),
Response = hackney:request(Method, URL, SignedHeaders, Payload, Options),
DecodeBody = not proplists:get_value(receive_body_as_binary, Options),
handle_response(Response, SuccessStatusCode, DecodeBody).
handle_response({ok, StatusCode, ResponseHeaders}, SuccessStatusCode, _DecodeBody)
when StatusCode =:= 200;
StatusCode =:= 202;
StatusCode =:= 204;
StatusCode =:= SuccessStatusCode ->
{ok, {StatusCode, ResponseHeaders}};
handle_response({ok, StatusCode, ResponseHeaders}, _, _DecodeBody) ->
{error, {StatusCode, ResponseHeaders}};
handle_response({ok, StatusCode, ResponseHeaders, Client}, SuccessStatusCode, DecodeBody)
when StatusCode =:= 200;
StatusCode =:= 202;
StatusCode =:= 204;
StatusCode =:= SuccessStatusCode ->
case hackney:body(Client) of
{ok, <<>>} when StatusCode =:= 200;
StatusCode =:= SuccessStatusCode ->
{ok, #{}, {StatusCode, ResponseHeaders, Client}};
{ok, Body} ->
Result = case DecodeBody of
true -> jsx:decode(Body);
false -> #{<<"Body">> => Body}
end,
{ok, Result, {StatusCode, ResponseHeaders, Client}}
end;
handle_response({ok, StatusCode, ResponseHeaders, Client}, _, _DecodeBody) ->
{ok, Body} = hackney:body(Client),
Error = jsx:decode(Body),
{error, Error, {StatusCode, ResponseHeaders, Client}};
handle_response({error, Reason}, _, _DecodeBody) ->
{error, Reason}.
build_host(_EndpointPrefix, #{region := <<"local">>, endpoint := Endpoint}) ->
Endpoint;
build_host(_EndpointPrefix, #{region := <<"local">>}) ->
<<"localhost">>;
build_host(EndpointPrefix, #{region := Region, endpoint := Endpoint}) ->
aws_util:binary_join([EndpointPrefix, Region, Endpoint], <<".">>).
build_url(Host, Path0, Client) ->
Proto = maps:get(proto, Client),
Path = erlang:iolist_to_binary(Path0),
Port = maps:get(port, Client),
aws_util:binary_join([Proto, <<"://">>, Host, <<":">>, Port, Path], <<"">>).
-spec encode_payload(undefined | map()) -> binary().
encode_payload(undefined) ->
<<>>;
encode_payload(Input) ->
jsx:encode(Input).