View Source aws_connect (aws v0.7.13)
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.Link to this section Summary
Functions
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Associates an existing vocabulary as the default.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Associates a flow with a phone number claimed to your Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Claims an available phone number to your Amazon Connect instance or traffic distribution group.
This API is in preview release for Amazon Connect and is subject to change.
Creates a flow for the specified Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Creates a rule for the specified Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
Creates a traffic distribution group given an Amazon Connect instance that has been replicated.
Creates a user account for the specified Amazon Connect instance.
Creates a custom vocabulary associated with your Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Deletes an Amazon Web Services resource association from an Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
Deletes a traffic distribution group.
Deletes a user account from the specified Amazon Connect instance.
Deletes an existing user hierarchy group.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Describes the specified flow.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Gets details and status of a phone number that’s claimed to your Amazon Connect instance or traffic distribution group.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Describes the specified user account.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
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.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
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.
Gets the real-time metric data from the specified Amazon Connect instance.
Retrieves a token for federation.
Gets historical metric data from the specified Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Provides information about the flows for the specified Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
Provides information about the hours of operation for the specified Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Provides information about the phone numbers for the specified Amazon Connect instance.
Lists phone numbers claimed to your Amazon Connect instance or traffic distribution group.
This API is in preview release for Amazon Connect and is subject to change.
Provides information about the queues for the specified Amazon Connect instance.
Provides summary information about the routing profiles for the specified Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Provides summary information about the security profiles for the specified Amazon Connect instance.
Lists the tags for the specified resource.
Provides summary information about the hierarchy groups for the specified Amazon Connect instance.
Initiates silent monitoring of a contact.
Changes the current status of a user or agent in Amazon Connect.
Releases a phone number previously claimed to an Amazon Connect instance or traffic distribution group.
Replicates an Amazon Connect instance in the specified Amazon Web Services Region.
When a contact is being recorded, and the recording has been suspended using SuspendContactRecording, this API resumes recording the call.
Searches for available phone numbers that you can claim to your Amazon Connect instance or traffic distribution group.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Searches users in an Amazon Connect instance, with optional filtering.
State
, NameStartsWith
, and LanguageCode
.Initiates a flow to start a new chat for the customer.
Starts recording the contact
Initiates real-time message streaming for a new chat contact.
Places an outbound call to a contact, and then initiates the flow.
Ends the specified contact.
Stops recording a call when a contact is being recorded.
Ends message streaming on a specified contact.
When a contact is being recorded, this API suspends recording the call.
Adds the specified tags to the specified resource.
Transfers contacts from one agent or queue to another agent or queue at any point after a contact is created.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Creates or updates user-defined contact attributes associated with the specified contact.
Updates the specified flow.
The name of the flow.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Updates timeouts for when human chat participants are to be considered idle, and when agents are automatically disconnected from a chat due to idleness.
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.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
This API is in preview release for Amazon Connect and is subject to change.
Updates the name and description of a quick connect.
Updates the name and description of a routing profile.
Updates a rule for the specified Amazon Connect instance.
This API is in preview release for Amazon Connect and is subject to change.
Updates details about a specific task template in the specified Amazon Connect instance.
Updates the traffic distribution for a given traffic distribution group.
Updates the identity information for the specified user.
Link to this section Functions
This API is in preview release for Amazon Connect and is subject to change.
Associates an approved origin to an Amazon Connect instance.This API is in preview release for Amazon Connect and is subject to change.
Allows the specified Amazon Connect instance to access the specified Amazon Lex or Amazon Lex V2 bot.associate_default_vocabulary(Client, InstanceId, LanguageCode, Input)
View SourceAssociates an existing vocabulary as the default.
Contact Lens for Amazon Connect uses the vocabulary in post-call and real-time analysis sessions for the given language.associate_default_vocabulary(Client, InstanceId, LanguageCode, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Associates a storage resource type for the first time. You can only associate one type of storage configuration in a single call. This means, for example, that you can't define an instance with multiple S3 buckets for storing chat transcripts.
This API does not create a resource that doesn't exist. It only associates it to the instance. Ensure that the resource being specified in the storage configuration, like an S3 bucket, exists when being used for association.associate_instance_storage_config(Client, InstanceId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Allows the specified Amazon Connect instance to access the specified Lambda function.This API is in preview release for Amazon Connect and is subject to change.
Allows the specified Amazon Connect instance to access the specified Amazon Lex bot.Associates a flow with a phone number claimed to your Amazon Connect instance.
If the number is claimed to a traffic distribution group, and you are calling this API using an instance in the Amazon Web Services Region where the traffic distribution group was created, you can use either a full phone number ARN or UUID value for thePhoneNumberId
URI request parameter. However, if the number is claimed to a traffic distribution group and you are calling this API using an instance in the alternate Amazon Web Services Region associated with the traffic distribution group, you must provide a full phone number ARN. If a UUID is provided in this scenario, you will receive a ResourceNotFoundException
.
associate_phone_number_contact_flow(Client, PhoneNumberId, Input0, Options0)
View Sourceassociate_queue_quick_connects(Client, InstanceId, QueueId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Associates a set of quick connects with a queue.associate_queue_quick_connects(Client, InstanceId, QueueId, Input0, Options0)
View Sourceassociate_routing_profile_queues(Client, InstanceId, RoutingProfileId, Input)
View Sourceassociate_routing_profile_queues(Client, InstanceId, RoutingProfileId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Associates a security key to the instance.Claims an available phone number to your Amazon Connect instance or traffic distribution group.
You can call this API only in the same Amazon Web Services Region where the Amazon Connect instance or traffic distribution group was created.
For more information about how to use this operation, see Claim a phone number in your country and Claim phone numbers to traffic distribution groups in the Amazon Connect Administrator Guide.
You can call the SearchAvailablePhoneNumbers API for available phone numbers that you can claim. Call the DescribePhoneNumber API to verify the status of a previous ClaimPhoneNumber operation.This API is in preview release for Amazon Connect and is subject to change.
Creates an agent status for the specified Amazon Connect instance.Creates a flow for the specified Amazon Connect instance.
You can also create and update flows using the Amazon Connect Flow language.This API is in preview release for Amazon Connect and is subject to change.
Creates hours of operation.This API is in preview release for Amazon Connect and is subject to change.
Initiates an Amazon Connect instance with all the supported channels enabled. It does not attach any storage, such as Amazon Simple Storage Service (Amazon S3) or Amazon Kinesis. It also does not allow for any configurations on features, such as Contact Lens for Amazon Connect.
Amazon Connect enforces a limit on the total number of instances that you can create or delete in 30 days. If you exceed this limit, you will get an error message indicating there has been an excessive number of attempts at creating or deleting instances. You must wait 30 days before you can restart creating and deleting instances in your account.create_integration_association(Client, InstanceId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Creates a new queue for the specified Amazon Connect instance.
If the number being used in the input is claimed to a traffic distribution group, and you are calling this API using an instance in the Amazon Web Services Region where the traffic distribution group was created, you can use either a full phone number ARN or UUID value for theOutboundCallerIdNumberId
value of the OutboundCallerConfig request body parameter. However, if the number is claimed to a traffic distribution group and you are calling this API using an instance in the alternate Amazon Web Services Region associated with the traffic distribution group, you must provide a full phone number ARN. If a UUID is provided in this scenario, you will receive a ResourceNotFoundException
.
Creates a rule for the specified Amazon Connect instance.
Use the Rules Function language to code conditions for the rule.This API is in preview release for Amazon Connect and is subject to change.
Creates a security profile.Creates a traffic distribution group given an Amazon Connect instance that has been replicated.
For more information about creating traffic distribution groups, see Set up traffic distribution groups in the Amazon Connect Administrator Guide.create_use_case(Client, InstanceId, IntegrationAssociationId, Input)
View Sourcecreate_use_case(Client, InstanceId, IntegrationAssociationId, Input0, Options0)
View SourceCreates a user account for the specified Amazon Connect instance.
For information about how to create user accounts using the Amazon Connect console, see Add Users in the Amazon Connect Administrator Guide.Creates a custom vocabulary associated with your Amazon Connect instance.
You can set a custom vocabulary to be your default vocabulary for a given language. Contact Lens for Amazon Connect uses the default vocabulary in post-call and real-time contact analysis sessions for that language.delete_contact_flow(Client, ContactFlowId, InstanceId, Input0, Options0)
View Sourcedelete_contact_flow_module(Client, ContactFlowModuleId, InstanceId, Input)
View Sourcedelete_contact_flow_module(Client, ContactFlowModuleId, InstanceId, Input0, Options0)
View Sourcedelete_hours_of_operation(Client, HoursOfOperationId, InstanceId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Deletes an hours of operation.delete_hours_of_operation(Client, HoursOfOperationId, InstanceId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Deletes the Amazon Connect instance.
Amazon Connect enforces a limit on the total number of instances that you can create or delete in 30 days. If you exceed this limit, you will get an error message indicating there has been an excessive number of attempts at creating or deleting instances. You must wait 30 days before you can restart creating and deleting instances in your account.delete_integration_association(Client, InstanceId, IntegrationAssociationId, Input)
View SourceDeletes an Amazon Web Services resource association from an Amazon Connect instance.
The association must not have any use cases associated with it.delete_integration_association(Client, InstanceId, IntegrationAssociationId, Input0, Options0)
View Sourcedelete_quick_connect(Client, InstanceId, QuickConnectId, Input0, Options0)
View Sourcedelete_security_profile(Client, InstanceId, SecurityProfileId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Deletes a security profile.delete_security_profile(Client, InstanceId, SecurityProfileId, Input0, Options0)
View Sourcedelete_task_template(Client, InstanceId, TaskTemplateId, Input0, Options0)
View Sourcedelete_traffic_distribution_group(Client, TrafficDistributionGroupId, Input)
View SourceDeletes a traffic distribution group.
This API can be called only in the Region where the traffic distribution group is created.
For more information about deleting traffic distribution groups, see Delete traffic distribution groups in the Amazon Connect Administrator Guide.delete_traffic_distribution_group(Client, TrafficDistributionGroupId, Input0, Options0)
View Sourcedelete_use_case(Client, InstanceId, IntegrationAssociationId, UseCaseId, Input)
View Sourcedelete_use_case(Client, InstanceId, IntegrationAssociationId, UseCaseId, Input0, Options0)
View SourceDeletes a user account from the specified Amazon Connect instance.
For information about what happens to a user's data when their account is deleted, see Delete Users from Your Amazon Connect Instance in the Amazon Connect Administrator Guide.delete_user_hierarchy_group(Client, HierarchyGroupId, InstanceId, Input)
View SourceDeletes an existing user hierarchy group.
It must not be associated with any agents or have any active child groups.delete_user_hierarchy_group(Client, HierarchyGroupId, InstanceId, Input0, Options0)
View Sourcedelete_vocabulary(Client, InstanceId, VocabularyId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Describes an agent status.describe_agent_status(Client, AgentStatusId, InstanceId, QueryMap, HeadersMap)
View Sourcedescribe_agent_status(Client, AgentStatusId, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Describes the specified contact.
Contact information remains available in Amazon Connect for 24 months, and then it is deleted.
Only data from November 12, 2021, and later is returned by this API.describe_contact(Client, ContactId, InstanceId, QueryMap, HeadersMap)
View Sourcedescribe_contact(Client, ContactId, InstanceId, QueryMap, HeadersMap, Options0)
View SourceDescribes the specified flow.
You can also create and update flows using the Amazon Connect Flow language.describe_contact_flow(Client, ContactFlowId, InstanceId, QueryMap, HeadersMap)
View Sourcedescribe_contact_flow(Client, ContactFlowId, InstanceId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_contact_flow_module(Client, ContactFlowModuleId, InstanceId)
View Sourcedescribe_contact_flow_module(Client, ContactFlowModuleId, InstanceId, QueryMap, HeadersMap)
View Sourcedescribe_contact_flow_module(Client, ContactFlowModuleId, InstanceId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_hours_of_operation(Client, HoursOfOperationId, InstanceId)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Describes the hours of operation.describe_hours_of_operation(Client, HoursOfOperationId, InstanceId, QueryMap, HeadersMap)
View Sourcedescribe_hours_of_operation(Client, HoursOfOperationId, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Returns the current state of the specified instance identifier. It tracks the instance while it is being created and returns an error status, if applicable.
If an instance is not created successfully, the instance status reason field returns details relevant to the reason. The instance in a failed state is returned only for 24 hours after the CreateInstance API was invoked.describe_instance(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Describes the specified instance attribute.describe_instance_attribute(Client, AttributeType, InstanceId, QueryMap, HeadersMap)
View Sourcedescribe_instance_attribute(Client, AttributeType, InstanceId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_instance_storage_config(Client, AssociationId, InstanceId, ResourceType)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Retrieves the current storage configurations for the specified resource type, association ID, and instance ID.describe_instance_storage_config(Client, AssociationId, InstanceId, ResourceType, QueryMap, HeadersMap)
View Sourcedescribe_instance_storage_config(Client, AssociationId, InstanceId, ResourceType, QueryMap, HeadersMap, Options0)
View SourceGets details and status of a phone number that’s claimed to your Amazon Connect instance or traffic distribution group.
If the number is claimed to a traffic distribution group, and you are calling in the Amazon Web Services Region where the traffic distribution group was created, you can use either a phone number ARN or UUID value for thePhoneNumberId
URI request parameter. However, if the number is claimed to a traffic distribution group and you are calling this API in the alternate Amazon Web Services Region associated with the traffic distribution group, you must provide a full phone number ARN. If a UUID is provided in this scenario, you will receive a ResourceNotFoundException
.
describe_phone_number(Client, PhoneNumberId, QueryMap, HeadersMap)
View Sourcedescribe_phone_number(Client, PhoneNumberId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Describes the specified queue.describe_queue(Client, InstanceId, QueueId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_quick_connect(Client, InstanceId, QuickConnectId, QueryMap, HeadersMap)
View Sourcedescribe_quick_connect(Client, InstanceId, QuickConnectId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_routing_profile(Client, InstanceId, RoutingProfileId, QueryMap, HeadersMap)
View Sourcedescribe_routing_profile(Client, InstanceId, RoutingProfileId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_rule(Client, InstanceId, RuleId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Gets basic information about the security profle.describe_security_profile(Client, InstanceId, SecurityProfileId, QueryMap, HeadersMap)
View Sourcedescribe_security_profile(Client, InstanceId, SecurityProfileId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_traffic_distribution_group(Client, TrafficDistributionGroupId)
View Sourcedescribe_traffic_distribution_group(Client, TrafficDistributionGroupId, QueryMap, HeadersMap)
View Sourcedescribe_traffic_distribution_group(Client, TrafficDistributionGroupId, QueryMap, HeadersMap, Options0)
View SourceDescribes the specified user account.
You can find the instance ID in the console (it’s the final part of the ARN). The console does not display the user IDs. Instead, list the users and note the IDs provided in the output.describe_user(Client, InstanceId, UserId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_user_hierarchy_group(Client, HierarchyGroupId, InstanceId)
View Sourcedescribe_user_hierarchy_group(Client, HierarchyGroupId, InstanceId, QueryMap, HeadersMap)
View Sourcedescribe_user_hierarchy_group(Client, HierarchyGroupId, InstanceId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_user_hierarchy_structure(Client, InstanceId, QueryMap, HeadersMap)
View Sourcedescribe_user_hierarchy_structure(Client, InstanceId, QueryMap, HeadersMap, Options0)
View Sourcedescribe_vocabulary(Client, InstanceId, VocabularyId, QueryMap, HeadersMap)
View Sourcedescribe_vocabulary(Client, InstanceId, VocabularyId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Revokes access to integrated applications from Amazon Connect.disassociate_approved_origin(Client, InstanceId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Revokes authorization from the specified instance to access the specified Amazon Lex or Amazon Lex V2 bot.disassociate_instance_storage_config(Client, AssociationId, InstanceId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Removes the storage type configurations for the specified resource type and association ID.disassociate_instance_storage_config(Client, AssociationId, InstanceId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Remove the Lambda function from the dropdown options available in the relevant flow blocks.disassociate_lambda_function(Client, InstanceId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Revokes authorization from the specified instance to access the specified Amazon Lex bot.disassociate_phone_number_contact_flow(Client, PhoneNumberId, Input)
View SourceRemoves the flow association from a phone number claimed to your Amazon Connect instance.
If the number is claimed to a traffic distribution group, and you are calling this API using an instance in the Amazon Web Services Region where the traffic distribution group was created, you can use either a full phone number ARN or UUID value for thePhoneNumberId
URI request parameter. However, if the number is claimed to a traffic distribution group and you are calling this API using an instance in the alternate Amazon Web Services Region associated with the traffic distribution group, you must provide a full phone number ARN. If a UUID is provided in this scenario, you will receive a ResourceNotFoundException
.
disassociate_phone_number_contact_flow(Client, PhoneNumberId, Input0, Options0)
View Sourcedisassociate_queue_quick_connects(Client, InstanceId, QueueId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Disassociates a set of quick connects from a queue.disassociate_queue_quick_connects(Client, InstanceId, QueueId, Input0, Options0)
View Sourcedisassociate_routing_profile_queues(Client, InstanceId, RoutingProfileId, Input)
View Sourcedisassociate_routing_profile_queues(Client, InstanceId, RoutingProfileId, Input0, Options0)
View Sourcedisassociate_security_key(Client, AssociationId, InstanceId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Deletes the specified security key.disassociate_security_key(Client, AssociationId, InstanceId, Input0, Options0)
View SourceDismisses contacts from an agent’s CCP and returns the agent to an available state, which allows the agent to receive a new routed contact.
Contacts can only be dismissed if they are in aMISSED
, ERROR
, ENDED
, or REJECTED
state in the Agent Event Stream.
dismiss_user_contact(Client, InstanceId, UserId, Input0, Options0)
View Sourceget_contact_attributes(Client, InitialContactId, InstanceId, QueryMap, HeadersMap)
View Sourceget_contact_attributes(Client, InitialContactId, InstanceId, QueryMap, HeadersMap, Options0)
View SourceGets the real-time metric data from the specified Amazon Connect instance.
For a description of each metric, see Real-time Metrics Definitions in the Amazon Connect Administrator Guide.Retrieves a token for federation.
This API doesn't support root users. If you try to invoke GetFederationToken with root credentials, an error message similar to the following one appears:
Provided identity: Principal: .... User: .... cannot be used for federation with Amazon Connect
get_federation_token(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceGets historical metric data from the specified Amazon Connect instance.
For a description of each historical metric, see Historical Metrics Definitions in the Amazon Connect Administrator Guide.get_task_template(Client, InstanceId, TaskTemplateId, QueryMap, HeadersMap)
View Sourceget_task_template(Client, InstanceId, TaskTemplateId, QueryMap, HeadersMap, Options0)
View Sourceget_traffic_distribution(Client, Id, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Lists agent statuses.list_agent_statuses(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Returns a paginated list of all approved origins associated with the instance.list_approved_origins(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
For the specified version of Amazon Lex, returns a paginated list of all the Amazon Lex bots currently associated with the instance. Use this API to returns both Amazon Lex V1 and V2 bots.list_bots(Client, InstanceId, LexVersion, QueryMap, HeadersMap, Options0)
View Sourcelist_contact_flow_modules(Client, InstanceId, QueryMap, HeadersMap)
View Sourcelist_contact_flow_modules(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceProvides information about the flows for the specified Amazon Connect instance.
You can also create and update flows using the Amazon Connect Flow language.
For more information about flows, see Flows in the Amazon Connect Administrator Guide.list_contact_flows(Client, InstanceId, QueryMap, HeadersMap, Options0)
View Sourcelist_contact_references(Client, ContactId, InstanceId, ReferenceTypes)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
For the specifiedreferenceTypes
, returns a list of references associated with the contact.
list_contact_references(Client, ContactId, InstanceId, ReferenceTypes, QueryMap, HeadersMap)
View Sourcelist_contact_references(Client, ContactId, InstanceId, ReferenceTypes, QueryMap, HeadersMap, Options0)
View SourceProvides information about the hours of operation for the specified Amazon Connect instance.
For more information about hours of operation, see Set the Hours of Operation for a Queue in the Amazon Connect Administrator Guide.list_hours_of_operations(Client, InstanceId, QueryMap, HeadersMap)
View Sourcelist_hours_of_operations(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Returns a paginated list of all attribute types for the given instance.list_instance_attributes(Client, InstanceId, QueryMap, HeadersMap)
View Sourcelist_instance_attributes(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Returns a paginated list of storage configs for the identified instance and resource type.list_instance_storage_configs(Client, InstanceId, ResourceType, QueryMap, HeadersMap)
View Sourcelist_instance_storage_configs(Client, InstanceId, ResourceType, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Return a list of instances which are in active state, creation-in-progress state, and failed state. Instances that aren't successfully created (they are in a failed state) are returned only for 24 hours after the CreateInstance API was invoked.list_integration_associations(Client, InstanceId, QueryMap, HeadersMap)
View Sourcelist_integration_associations(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Returns a paginated list of all Lambda functions that display in the dropdown options in the relevant flow blocks.list_lambda_functions(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Returns a paginated list of all the Amazon Lex V1 bots currently associated with the instance. To return both Amazon Lex V1 and V2 bots, use the ListBots API.Provides information about the phone numbers for the specified Amazon Connect instance.
For more information about phone numbers, see Set Up Phone Numbers for Your Contact Center in the Amazon Connect Administrator Guide.
The phone numberArn
value that is returned from each of the items in the PhoneNumberSummaryList cannot be used to tag phone number resources. It will fail with a ResourceNotFoundException
. Instead, use the ListPhoneNumbersV2 API. It returns the new phone number ARN that can be used to tag phone number resources.
list_phone_numbers(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceLists phone numbers claimed to your Amazon Connect instance or traffic distribution group.
If the provided TargetArn
is a traffic distribution group, you can call this API in both Amazon Web Services Regions associated with traffic distribution group.
This API is in preview release for Amazon Connect and is subject to change.
Lists the quick connects associated with a queue.list_queue_quick_connects(Client, InstanceId, QueueId, QueryMap, HeadersMap)
View Sourcelist_queue_quick_connects(Client, InstanceId, QueueId, QueryMap, HeadersMap, Options0)
View SourceProvides information about the queues for the specified Amazon Connect instance.
If you do not specify a QueueTypes
parameter, both standard and agent queues are returned. This might cause an unexpected truncation of results if you have more than 1000 agents and you limit the number of results of the API call in code.
list_quick_connects(Client, InstanceId, QueryMap, HeadersMap, Options0)
View Sourcelist_routing_profile_queues(Client, InstanceId, RoutingProfileId, QueryMap, HeadersMap)
View Sourcelist_routing_profile_queues(Client, InstanceId, RoutingProfileId, QueryMap, HeadersMap, Options0)
View SourceProvides summary information about the routing profiles for the specified Amazon Connect instance.
For more information about routing profiles, see Routing Profiles and Create a Routing Profile in the Amazon Connect Administrator Guide.list_routing_profiles(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Returns a paginated list of all security keys associated with the instance.list_security_keys(Client, InstanceId, QueryMap, HeadersMap, Options0)
View Sourcelist_security_profile_permissions(Client, InstanceId, SecurityProfileId)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Lists the permissions granted to a security profile.list_security_profile_permissions(Client, InstanceId, SecurityProfileId, QueryMap, HeadersMap)
View Sourcelist_security_profile_permissions(Client, InstanceId, SecurityProfileId, QueryMap, HeadersMap, Options0)
View SourceProvides summary information about the security profiles for the specified Amazon Connect instance.
For more information about security profiles, see Security Profiles in the Amazon Connect Administrator Guide.list_security_profiles(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceLists the tags for the specified resource.
For sample policies that use tags, see Amazon Connect Identity-Based Policy Examples in the Amazon Connect Administrator Guide.list_tags_for_resource(Client, ResourceArn, QueryMap, HeadersMap, Options0)
View Sourcelist_task_templates(Client, InstanceId, QueryMap, HeadersMap, Options0)
View Sourcelist_traffic_distribution_groups(Client, QueryMap, HeadersMap, Options0)
View Sourcelist_use_cases(Client, InstanceId, IntegrationAssociationId, QueryMap, HeadersMap)
View Sourcelist_use_cases(Client, InstanceId, IntegrationAssociationId, QueryMap, HeadersMap, Options0)
View SourceProvides summary information about the hierarchy groups for the specified Amazon Connect instance.
For more information about agent hierarchies, see Set Up Agent Hierarchies in the Amazon Connect Administrator Guide.list_user_hierarchy_groups(Client, InstanceId, QueryMap, HeadersMap)
View Sourcelist_user_hierarchy_groups(Client, InstanceId, QueryMap, HeadersMap, Options0)
View SourceInitiates silent monitoring of a contact.
The Contact Control Panel (CCP) of the user specified by userId will be set to silent monitoring mode on the contact.Changes the current status of a user or agent in Amazon Connect.
If the agent is currently handling a contact, this sets the agent's next status.
For more information, see Agent status and Set your next status in the Amazon Connect Administrator Guide.Releases a phone number previously claimed to an Amazon Connect instance or traffic distribution group.
You can call this API only in the Amazon Web Services Region where the number was claimed.
To release phone numbers from a traffic distribution group, use the ReleasePhoneNumber
API, not the Amazon Connect console.
Replicates an Amazon Connect instance in the specified Amazon Web Services Region.
For more information about replicating an Amazon Connect instance, see Create a replica of your existing Amazon Connect instance in the Amazon Connect Administrator Guide.When a contact is being recorded, and the recording has been suspended using SuspendContactRecording, this API resumes recording the call.
Only voice recordings are supported at this time.Searches for available phone numbers that you can claim to your Amazon Connect instance or traffic distribution group.
If the providedTargetArn
is a traffic distribution group, you can call this API in both Amazon Web Services Regions associated with the traffic distribution group.
This API is in preview release for Amazon Connect and is subject to change.
Searches queues in an Amazon Connect instance, with optional filtering.This API is in preview release for Amazon Connect and is subject to change.
Searches routing profiles in an Amazon Connect instance, with optional filtering.This API is in preview release for Amazon Connect and is subject to change.
Searches security profiles in an Amazon Connect instance, with optional filtering.Searches users in an Amazon Connect instance, with optional filtering.
AfterContactWorkTimeLimit
is returned in milliseconds.
State
, NameStartsWith
, and LanguageCode
.
Initiates a flow to start a new chat for the customer.
Response of this API provides a token required to obtain credentials from the CreateParticipantConnection API in the Amazon Connect Participant Service.
When a new chat contact is successfully created, clients must subscribe to the participant’s connection for the created chat within 5 minutes. This is achieved by invoking CreateParticipantConnection with WEBSOCKET and CONNECTION_CREDENTIALS.
A 429 error occurs in the following situations:
API rate limit is exceeded. API TPS throttling returns a
TooManyRequests
exception.The quota for concurrent active chats is exceeded. Active chat throttling returns a
LimitExceededException
.
If you use the ChatDurationInMinutes
parameter and receive a 400 error, your account may not support the ability to configure custom chat durations. For more information, contact Amazon Web Services Support.
Starts recording the contact:
If the API is called before the agent joins the call, recording starts when the agent joins the call.
If the API is called after the agent joins the call, recording starts at the time of the API call.
StartContactRecording is a one-time action. For example, if you use StopContactRecording to stop recording an ongoing call, you can't use StartContactRecording to restart it. For scenarios where the recording has started and you want to suspend and resume it, such as when collecting sensitive information (for example, a credit card number), use SuspendContactRecording and ResumeContactRecording.
You can use this API to override the recording behavior configured in the Set recording behavior block.
Only voice recordings are supported at this time.Initiates real-time message streaming for a new chat contact.
For more information about message streaming, see Enable real-time chat message streaming in the Amazon Connect Administrator Guide.Places an outbound call to a contact, and then initiates the flow.
It performs the actions in the flow that's specified (in ContactFlowId
).
Agents do not initiate the outbound API, which means that they do not dial the contact. If the flow places an outbound call to a contact, and then puts the contact in queue, the call is then routed to the agent, like any other inbound case.
There is a 60-second dialing timeout for this operation. If the call is not connected after 60 seconds, it fails.
UK numbers with a 447 prefix are not allowed by default. Before you can dial these UK mobile numbers, you must submit a service quota increase request. For more information, see Amazon Connect Service Quotas in the Amazon Connect Administrator Guide.
Campaign calls are not allowed by default. Before you can make a call withTrafficType
= CAMPAIGN
, you must submit a service quota increase request to the quota Amazon Connect campaigns.
Ends the specified contact.
This call does not work for the following initiation methods:
DISCONNECT
TRANSFER
QUEUE_TRANSFER
Stops recording a call when a contact is being recorded.
StopContactRecording is a one-time action. If you use StopContactRecording to stop recording an ongoing call, you can't use StartContactRecording to restart it. For scenarios where the recording has started and you want to suspend it for sensitive information (for example, to collect a credit card number), and then restart it, use SuspendContactRecording and ResumeContactRecording.
Only voice recordings are supported at this time.Ends message streaming on a specified contact.
To restart message streaming on that contact, call the StartContactStreaming API.When a contact is being recorded, this API suspends recording the call.
For example, you might suspend the call recording while collecting sensitive information, such as a credit card number. Then use ResumeContactRecording to restart recording.
The period of time that the recording is suspended is filled with silence in the final recording.
Only voice recordings are supported at this time.Adds the specified tags to the specified resource.
Some of the supported resource types are agents, routing profiles, queues, quick connects, contact flows, agent statuses, hours of operation, phone numbers, security profiles, and task templates. For a complete list, see Tagging resources in Amazon Connect.
For sample policies that use tags, see Amazon Connect Identity-Based Policy Examples in the Amazon Connect Administrator Guide.Transfers contacts from one agent or queue to another agent or queue at any point after a contact is created.
You can transfer a contact to another queue by providing the flow which orchestrates the contact to the destination queue. This gives you more control over contact handling and helps you adhere to the service level agreement (SLA) guaranteed to your customers.
Note the following requirements:
Transfer is supported for only
TASK
contacts.Do not use both
QueueId
andUserId
in the same call.The following flow types are supported: Inbound flow, Transfer to agent flow, and Transfer to queue flow.
The
TransferContact
API can be called only on active contacts.A contact cannot be transferred more than 11 times.
This API is in preview release for Amazon Connect and is subject to change.
Updates agent status.update_agent_status(Client, AgentStatusId, InstanceId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Adds or updates user-defined contact information associated with the specified contact. At least one field to be updated must be present in the request.
You can add or update user-defined contact information for both ongoing and completed contacts.Creates or updates user-defined contact attributes associated with the specified contact.
You can create or update user-defined attributes for both ongoing and completed contacts. For example, while the call is active, you can update the customer's name or the reason the customer called. You can add notes about steps that the agent took during the call that display to the next agent that takes the call. You can also update attributes for a contact using data from your CRM application and save the data with the contact in Amazon Connect. You could also flag calls for additional analysis, such as legal review or to identify abusive callers.
Contact attributes are available in Amazon Connect for 24 months, and are then deleted. For information about contact record retention and the maximum size of the contact record attributes section, see Feature specifications in the Amazon Connect Administrator Guide.update_contact_flow_content(Client, ContactFlowId, InstanceId, Input)
View SourceUpdates the specified flow.
You can also create and update flows using the Amazon Connect Flow language.update_contact_flow_content(Client, ContactFlowId, InstanceId, Input0, Options0)
View Sourceupdate_contact_flow_metadata(Client, ContactFlowId, InstanceId, Input)
View Sourceupdate_contact_flow_metadata(Client, ContactFlowId, InstanceId, Input0, Options0)
View Sourceupdate_contact_flow_module_content(Client, ContactFlowModuleId, InstanceId, Input)
View Sourceupdate_contact_flow_module_content(Client, ContactFlowModuleId, InstanceId, Input0, Options0)
View Sourceupdate_contact_flow_module_metadata(Client, ContactFlowModuleId, InstanceId, Input)
View Sourceupdate_contact_flow_module_metadata(Client, ContactFlowModuleId, InstanceId, Input0, Options0)
View Sourceupdate_contact_flow_name(Client, ContactFlowId, InstanceId, Input)
View SourceThe name of the flow.
You can also create and update flows using the Amazon Connect Flow language.update_contact_flow_name(Client, ContactFlowId, InstanceId, Input0, Options0)
View Sourceupdate_hours_of_operation(Client, HoursOfOperationId, InstanceId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Updates the hours of operation.update_hours_of_operation(Client, HoursOfOperationId, InstanceId, Input0, Options0)
View Sourceupdate_instance_attribute(Client, AttributeType, InstanceId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Updates the value for the specified attribute type.update_instance_attribute(Client, AttributeType, InstanceId, Input0, Options0)
View Sourceupdate_instance_storage_config(Client, AssociationId, InstanceId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Updates an existing configuration for a resource type. This API is idempotent.update_instance_storage_config(Client, AssociationId, InstanceId, Input0, Options0)
View Sourceupdate_participant_role_config(Client, ContactId, InstanceId, Input)
View SourceUpdates timeouts for when human chat participants are to be considered idle, and when agents are automatically disconnected from a chat due to idleness.
You can set four timers:
Customer idle timeout
Customer auto-disconnect timeout
Agent idle timeout
Agent auto-disconnect timeout
update_participant_role_config(Client, ContactId, InstanceId, Input0, Options0)
View SourceUpdates 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.
You can call DescribePhoneNumber API to verify the status of a previous UpdatePhoneNumber operation.update_queue_hours_of_operation(Client, InstanceId, QueueId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Updates the hours of operation for the specified queue.update_queue_hours_of_operation(Client, InstanceId, QueueId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Updates the maximum number of contacts allowed in a queue before it is considered full.update_queue_max_contacts(Client, InstanceId, QueueId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Updates the name and description of a queue. At leastName
or Description
must be provided.
update_queue_outbound_caller_config(Client, InstanceId, QueueId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Updates the outbound caller ID name, number, and outbound whisper flow for a specified queue.
If the number being used in the input is claimed to a traffic distribution group, and you are calling this API using an instance in the Amazon Web Services Region where the traffic distribution group was created, you can use either a full phone number ARN or UUID value for theOutboundCallerIdNumberId
value of the OutboundCallerConfig request body parameter. However, if the number is claimed to a traffic distribution group and you are calling this API using an instance in the alternate Amazon Web Services Region associated with the traffic distribution group, you must provide a full phone number ARN. If a UUID is provided in this scenario, you will receive a ResourceNotFoundException
.
update_queue_outbound_caller_config(Client, InstanceId, QueueId, Input0, Options0)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Updates the status of the queue.update_queue_status(Client, InstanceId, QueueId, Input0, Options0)
View Sourceupdate_quick_connect_config(Client, InstanceId, QuickConnectId, Input)
View Sourceupdate_quick_connect_config(Client, InstanceId, QuickConnectId, Input0, Options0)
View Sourceupdate_quick_connect_name(Client, InstanceId, QuickConnectId, Input)
View SourceUpdates the name and description of a quick connect.
The request accepts the following data in JSON format. At leastName
or Description
must be provided.
update_quick_connect_name(Client, InstanceId, QuickConnectId, Input0, Options0)
View Sourceupdate_routing_profile_concurrency(Client, InstanceId, RoutingProfileId, Input)
View Sourceupdate_routing_profile_concurrency(Client, InstanceId, RoutingProfileId, Input0, Options0)
View Sourceupdate_routing_profile_default_outbound_queue(Client, InstanceId, RoutingProfileId, Input)
View Sourceupdate_routing_profile_default_outbound_queue(Client, InstanceId, RoutingProfileId, Input0, Options0)
View Sourceupdate_routing_profile_name(Client, InstanceId, RoutingProfileId, Input)
View SourceUpdates the name and description of a routing profile.
The request accepts the following data in JSON format. At leastName
or Description
must be provided.
update_routing_profile_name(Client, InstanceId, RoutingProfileId, Input0, Options0)
View Sourceupdate_routing_profile_queues(Client, InstanceId, RoutingProfileId, Input)
View Sourceupdate_routing_profile_queues(Client, InstanceId, RoutingProfileId, Input0, Options0)
View SourceUpdates a rule for the specified Amazon Connect instance.
Use the Rules Function language to code conditions for the rule.update_security_profile(Client, InstanceId, SecurityProfileId, Input)
View SourceThis API is in preview release for Amazon Connect and is subject to change.
Updates a security profile.update_security_profile(Client, InstanceId, SecurityProfileId, Input0, Options0)
View SourceUpdates details about a specific task template in the specified Amazon Connect instance.
This operation does not support partial updates. Instead it does a full update of template content.update_task_template(Client, InstanceId, TaskTemplateId, Input0, Options0)
View SourceUpdates the traffic distribution for a given traffic distribution group.
For more information about updating a traffic distribution group, see Update telephony traffic distribution across Amazon Web Services Regions in the Amazon Connect Administrator Guide.update_user_hierarchy(Client, InstanceId, UserId, Input0, Options0)
View Sourceupdate_user_hierarchy_group_name(Client, HierarchyGroupId, InstanceId, Input)
View Sourceupdate_user_hierarchy_group_name(Client, HierarchyGroupId, InstanceId, Input0, Options0)
View Sourceupdate_user_hierarchy_structure(Client, InstanceId, Input0, Options0)
View SourceUpdates the identity information for the specified user.
We strongly recommend limiting who has the ability to invokeUpdateUserIdentityInfo
. Someone with that ability can change the login credentials of other users by changing their email address. This poses a security risk to your organization. They can change the email address of a user to the attacker's email address, and then reset the password through email. For more information, see Best Practices for Security Profiles in the Amazon Connect Administrator Guide.