2024/11/22 - Amazon Connect Service - 11 new44 updated api methods
Changes Amazon Connect Service Feature: Add APIs for Amazon Connect Email Channel
See also: AWS API Documentation
Request Syntax
client.list_associated_contacts(
InstanceId='string',
ContactId='string',
MaxResults=123,
NextToken='string'
)
string
[REQUIRED]
string
[REQUIRED]
integer
string
dict
Response Syntax
{
'ContactSummaryList': [
{
'ContactId': 'string',
'ContactArn': 'string',
'InitiationTimestamp': datetime(2015, 1, 1),
'DisconnectTimestamp': datetime(2015, 1, 1),
'InitialContactId': 'string',
'PreviousContactId': 'string',
'RelatedContactId': 'string',
'InitiationMethod': 'INBOUND'|'OUTBOUND'|'TRANSFER'|'QUEUE_TRANSFER'|'CALLBACK'|'API'|'DISCONNECT'|'MONITOR'|'EXTERNAL_OUTBOUND'|'WEBRTC_API'|'AGENT_REPLY'|'FLOW',
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
ContactSummaryList (list) --
(dict) --
ContactId (string) --
ContactArn (string) --
InitiationTimestamp (datetime) --
DisconnectTimestamp (datetime) --
InitialContactId (string) --
PreviousContactId (string) --
RelatedContactId (string) --
InitiationMethod (string) --
Channel (string) --
NextToken (string) --
See also: AWS API Documentation
Request Syntax
client.delete_email_address(
InstanceId='string',
EmailAddressId='string'
)
string
[REQUIRED]
string
[REQUIRED]
dict
Response Syntax
{}
Response Structure
(dict) --
See also: AWS API Documentation
Request Syntax
client.search_email_addresses(
InstanceId='string',
MaxResults=123,
NextToken='string',
SearchCriteria={
'OrConditions': [
{'... recursive ...'},
],
'AndConditions': [
{'... recursive ...'},
],
'StringCondition': {
'FieldName': 'string',
'Value': 'string',
'ComparisonType': 'STARTS_WITH'|'CONTAINS'|'EXACT'
}
},
SearchFilter={
'TagFilter': {
'OrConditions': [
[
{
'TagKey': 'string',
'TagValue': 'string'
},
],
],
'AndConditions': [
{
'TagKey': 'string',
'TagValue': 'string'
},
],
'TagCondition': {
'TagKey': 'string',
'TagValue': 'string'
}
}
}
)
string
[REQUIRED]
integer
string
dict
OrConditions (list) --
(dict) --
AndConditions (list) --
(dict) --
StringCondition (dict) --
A leaf node condition which can be used to specify a string condition.
FieldName (string) --
The name of the field in the string condition.
Value (string) --
The value of the string.
ComparisonType (string) --
The type of comparison to be made when evaluating the string condition.
dict
TagFilter (dict) --
An object that can be used to specify Tag conditions inside the SearchFilter. This accepts an OR of AND (List of List) input where:
Top level list specifies conditions that need to be applied with OR operator
Inner list specifies conditions that need to be applied with AND operator.
OrConditions (list) --
A list of conditions which would be applied together with an OR condition.
(list) --
(dict) --
A leaf node condition which can be used to specify a tag condition, for example, HAVE BPO = 123.
TagKey (string) --
The tag key in the tag condition.
TagValue (string) --
The tag value in the tag condition.
AndConditions (list) --
A list of conditions which would be applied together with an AND condition.
(dict) --
A leaf node condition which can be used to specify a tag condition, for example, HAVE BPO = 123.
TagKey (string) --
The tag key in the tag condition.
TagValue (string) --
The tag value in the tag condition.
TagCondition (dict) --
A leaf node condition which can be used to specify a tag condition.
TagKey (string) --
The tag key in the tag condition.
TagValue (string) --
The tag value in the tag condition.
dict
Response Syntax
{
'NextToken': 'string',
'EmailAddresses': [
{
'EmailAddressId': 'string',
'EmailAddressArn': 'string',
'EmailAddress': 'string',
'Description': 'string',
'DisplayName': 'string'
},
],
'ApproximateTotalCount': 123
}
Response Structure
(dict) --
NextToken (string) --
EmailAddresses (list) --
(dict) --
EmailAddressId (string) --
EmailAddressArn (string) --
EmailAddress (string) --
Description (string) --
DisplayName (string) --
ApproximateTotalCount (integer) --
See also: AWS API Documentation
Request Syntax
client.create_email_address(
Description='string',
InstanceId='string',
EmailAddress='string',
DisplayName='string',
Tags={
'string': 'string'
},
ClientToken='string'
)
string
string
[REQUIRED]
string
[REQUIRED]
string
dict
(string) --
(string) --
string
dict
Response Syntax
{
'EmailAddressId': 'string',
'EmailAddressArn': 'string'
}
Response Structure
(dict) --
EmailAddressId (string) --
EmailAddressArn (string) --
See also: AWS API Documentation
Request Syntax
client.describe_email_address(
InstanceId='string',
EmailAddressId='string'
)
string
[REQUIRED]
string
[REQUIRED]
dict
Response Syntax
{
'EmailAddressId': 'string',
'EmailAddressArn': 'string',
'EmailAddress': 'string',
'DisplayName': 'string',
'Description': 'string',
'CreateTimestamp': 'string',
'ModifiedTimestamp': 'string',
'Tags': {
'string': 'string'
}
}
Response Structure
(dict) --
EmailAddressId (string) --
EmailAddressArn (string) --
EmailAddress (string) --
DisplayName (string) --
Description (string) --
CreateTimestamp (string) --
ModifiedTimestamp (string) --
Tags (dict) --
(string) --
(string) --
See also: AWS API Documentation
Request Syntax
client.create_contact(
InstanceId='string',
ClientToken='string',
RelatedContactId='string',
Attributes={
'string': 'string'
},
References={
'string': {
'Value': 'string',
'Type': 'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string',
'StatusReason': 'string'
}
},
Channel='VOICE'|'CHAT'|'TASK'|'EMAIL',
InitiationMethod='INBOUND'|'OUTBOUND'|'TRANSFER'|'QUEUE_TRANSFER'|'CALLBACK'|'API'|'DISCONNECT'|'MONITOR'|'EXTERNAL_OUTBOUND'|'WEBRTC_API'|'AGENT_REPLY'|'FLOW',
ExpiryDurationInMinutes=123,
UserInfo={
'UserId': 'string'
},
InitiateAs='CONNECTED_TO_USER',
Name='string',
Description='string',
SegmentAttributes={
'string': {
'ValueString': 'string'
}
}
)
string
[REQUIRED]
string
This field is autopopulated if not provided.
string
dict
(string) --
(string) --
dict
(string) --
(dict) --
Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.
Value (string) --
A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).
Type (string) -- [REQUIRED]
The type of the reference. DATE must be of type Epoch timestamp.
Status (string) --
Arn (string) --
StatusReason (string) --
string
[REQUIRED]
string
[REQUIRED]
integer
dict
UserId (string) --
string
string
string
dict
(string) --
(dict) --
A value for a segment attribute. This is structured as a map where the key is valueString and the value is a string.
ValueString (string) --
The value of a segment attribute.
dict
Response Syntax
{
'ContactId': 'string',
'ContactArn': 'string'
}
Response Structure
(dict) --
ContactId (string) --
ContactArn (string) --
See also: AWS API Documentation
Request Syntax
client.start_outbound_email_contact(
InstanceId='string',
ContactId='string',
FromEmailAddress={
'EmailAddress': 'string',
'DisplayName': 'string'
},
DestinationEmailAddress={
'EmailAddress': 'string',
'DisplayName': 'string'
},
AdditionalRecipients={
'CcEmailAddresses': [
{
'EmailAddress': 'string',
'DisplayName': 'string'
},
]
},
EmailMessage={
'MessageSourceType': 'TEMPLATE'|'RAW',
'TemplatedMessageConfig': {
'KnowledgeBaseId': 'string',
'MessageTemplateId': 'string',
'TemplateAttributes': {
'CustomAttributes': {
'string': 'string'
},
'CustomerProfileAttributes': 'string'
}
},
'RawMessage': {
'Subject': 'string',
'Body': 'string',
'ContentType': 'string'
}
},
ClientToken='string'
)
string
[REQUIRED]
string
[REQUIRED]
dict
EmailAddress (string) -- [REQUIRED]
DisplayName (string) --
dict
[REQUIRED]
EmailAddress (string) -- [REQUIRED]
DisplayName (string) --
dict
CcEmailAddresses (list) --
(dict) --
EmailAddress (string) -- [REQUIRED]
DisplayName (string) --
dict
[REQUIRED]
MessageSourceType (string) -- [REQUIRED]
TemplatedMessageConfig (dict) --
KnowledgeBaseId (string) -- [REQUIRED]
MessageTemplateId (string) -- [REQUIRED]
TemplateAttributes (dict) -- [REQUIRED]
CustomAttributes (dict) --
(string) --
(string) --
CustomerProfileAttributes (string) --
RawMessage (dict) --
Subject (string) -- [REQUIRED]
Body (string) -- [REQUIRED]
ContentType (string) -- [REQUIRED]
string
This field is autopopulated if not provided.
dict
Response Syntax
{
'ContactId': 'string'
}
Response Structure
(dict) --
ContactId (string) --
See also: AWS API Documentation
Request Syntax
client.send_outbound_email(
InstanceId='string',
FromEmailAddress={
'EmailAddress': 'string',
'DisplayName': 'string'
},
DestinationEmailAddress={
'EmailAddress': 'string',
'DisplayName': 'string'
},
AdditionalRecipients={
'CcEmailAddresses': [
{
'EmailAddress': 'string',
'DisplayName': 'string'
},
]
},
EmailMessage={
'MessageSourceType': 'TEMPLATE'|'RAW',
'TemplatedMessageConfig': {
'KnowledgeBaseId': 'string',
'MessageTemplateId': 'string',
'TemplateAttributes': {
'CustomAttributes': {
'string': 'string'
},
'CustomerProfileAttributes': 'string'
}
},
'RawMessage': {
'Subject': 'string',
'Body': 'string',
'ContentType': 'string'
}
},
TrafficType='GENERAL'|'CAMPAIGN',
SourceCampaign={
'CampaignId': 'string',
'OutboundRequestId': 'string'
},
ClientToken='string'
)
string
[REQUIRED]
dict
[REQUIRED]
EmailAddress (string) -- [REQUIRED]
DisplayName (string) --
dict
[REQUIRED]
EmailAddress (string) -- [REQUIRED]
DisplayName (string) --
dict
CcEmailAddresses (list) --
(dict) --
EmailAddress (string) -- [REQUIRED]
DisplayName (string) --
dict
[REQUIRED]
MessageSourceType (string) -- [REQUIRED]
TemplatedMessageConfig (dict) --
KnowledgeBaseId (string) -- [REQUIRED]
MessageTemplateId (string) -- [REQUIRED]
TemplateAttributes (dict) -- [REQUIRED]
CustomAttributes (dict) --
(string) --
(string) --
CustomerProfileAttributes (string) --
RawMessage (dict) --
Subject (string) -- [REQUIRED]
Body (string) -- [REQUIRED]
ContentType (string) -- [REQUIRED]
string
[REQUIRED]
dict
CampaignId (string) --
OutboundRequestId (string) --
string
This field is autopopulated if not provided.
dict
Response Syntax
{}
Response Structure
(dict) --
See also: AWS API Documentation
Request Syntax
client.update_email_address_metadata(
InstanceId='string',
EmailAddressId='string',
Description='string',
DisplayName='string',
ClientToken='string'
)
string
[REQUIRED]
string
[REQUIRED]
string
string
string
dict
Response Syntax
{
'EmailAddressId': 'string',
'EmailAddressArn': 'string'
}
Response Structure
(dict) --
EmailAddressId (string) --
EmailAddressArn (string) --
See also: AWS API Documentation
Request Syntax
client.update_queue_outbound_email_config(
InstanceId='string',
QueueId='string',
OutboundEmailConfig={
'OutboundEmailAddressId': 'string'
}
)
string
[REQUIRED]
string
[REQUIRED]
dict
[REQUIRED]
OutboundEmailAddressId (string) --
None
See also: AWS API Documentation
Request Syntax
client.start_email_contact(
InstanceId='string',
FromEmailAddress={
'EmailAddress': 'string',
'DisplayName': 'string'
},
DestinationEmailAddress='string',
Description='string',
References={
'string': {
'Value': 'string',
'Type': 'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string',
'StatusReason': 'string'
}
},
Name='string',
EmailMessage={
'MessageSourceType': 'RAW',
'RawMessage': {
'Subject': 'string',
'Body': 'string',
'ContentType': 'string',
'Headers': {
'string': 'string'
}
}
},
AdditionalRecipients={
'ToAddresses': [
{
'EmailAddress': 'string',
'DisplayName': 'string'
},
],
'CcAddresses': [
{
'EmailAddress': 'string',
'DisplayName': 'string'
},
]
},
Attachments=[
{
'FileName': 'string',
'S3Url': 'string'
},
],
ContactFlowId='string',
RelatedContactId='string',
Attributes={
'string': 'string'
},
SegmentAttributes={
'string': {
'ValueString': 'string'
}
},
ClientToken='string'
)
string
[REQUIRED]
dict
[REQUIRED]
EmailAddress (string) -- [REQUIRED]
DisplayName (string) --
string
[REQUIRED]
string
dict
(string) --
(dict) --
Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.
Value (string) --
A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).
Type (string) -- [REQUIRED]
The type of the reference. DATE must be of type Epoch timestamp.
Status (string) --
Arn (string) --
StatusReason (string) --
string
dict
[REQUIRED]
MessageSourceType (string) -- [REQUIRED]
RawMessage (dict) --
Subject (string) -- [REQUIRED]
Body (string) -- [REQUIRED]
ContentType (string) -- [REQUIRED]
Headers (dict) --
(string) --
(string) --
dict
ToAddresses (list) --
(dict) --
EmailAddress (string) -- [REQUIRED]
DisplayName (string) --
CcAddresses (list) --
(dict) --
EmailAddress (string) -- [REQUIRED]
DisplayName (string) --
list
(dict) --
FileName (string) -- [REQUIRED]
S3Url (string) -- [REQUIRED]
string
string
dict
(string) --
(string) --
dict
(string) --
(dict) --
A value for a segment attribute. This is structured as a map where the key is valueString and the value is a string.
ValueString (string) --
The value of a segment attribute.
string
This field is autopopulated if not provided.
dict
Response Syntax
{
'ContactId': 'string'
}
Response Structure
(dict) --
ContactId (string) --
{'ResourceType': {'OUTBOUND_EMAIL', 'INBOUND_EMAIL'}}
Associates a connect resource to a flow.
See also: AWS API Documentation
Request Syntax
client.associate_flow(
InstanceId='string',
ResourceId='string',
FlowId='string',
ResourceType='SMS_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the resource.
string
[REQUIRED]
The identifier of the flow.
string
[REQUIRED]
A valid resource type.
dict
Response Syntax
{}
Response Structure
(dict) --
{'ResourceType': {'EMAIL_MESSAGES'}}
This 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.
See also: AWS API Documentation
Request Syntax
client.associate_instance_storage_config(
InstanceId='string',
ResourceType='CHAT_TRANSCRIPTS'|'CALL_RECORDINGS'|'SCHEDULED_REPORTS'|'MEDIA_STREAMS'|'CONTACT_TRACE_RECORDS'|'AGENT_EVENTS'|'REAL_TIME_CONTACT_ANALYSIS_SEGMENTS'|'ATTACHMENTS'|'CONTACT_EVALUATIONS'|'SCREEN_RECORDINGS'|'REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS'|'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS'|'EMAIL_MESSAGES',
StorageConfig={
'AssociationId': 'string',
'StorageType': 'S3'|'KINESIS_VIDEO_STREAM'|'KINESIS_STREAM'|'KINESIS_FIREHOSE',
'S3Config': {
'BucketName': 'string',
'BucketPrefix': 'string',
'EncryptionConfig': {
'EncryptionType': 'KMS',
'KeyId': 'string'
}
},
'KinesisVideoStreamConfig': {
'Prefix': 'string',
'RetentionPeriodHours': 123,
'EncryptionConfig': {
'EncryptionType': 'KMS',
'KeyId': 'string'
}
},
'KinesisStreamConfig': {
'StreamArn': 'string'
},
'KinesisFirehoseConfig': {
'FirehoseArn': 'string'
}
}
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
A valid resource type. To enable streaming for real-time analysis of contacts, use the following types:
For chat contacts, use REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS.
For voice contacts, use REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS.
dict
[REQUIRED]
A valid storage type.
AssociationId (string) --
The existing association identifier that uniquely identifies the resource type and storage config for the given instance ID.
StorageType (string) -- [REQUIRED]
A valid storage type.
S3Config (dict) --
The S3 bucket configuration.
BucketName (string) -- [REQUIRED]
The S3 bucket name.
BucketPrefix (string) -- [REQUIRED]
The S3 bucket prefix.
EncryptionConfig (dict) --
The Amazon S3 encryption configuration.
EncryptionType (string) -- [REQUIRED]
The type of encryption.
KeyId (string) -- [REQUIRED]
The full ARN of the encryption key.
KinesisVideoStreamConfig (dict) --
The configuration of the Kinesis video stream.
Prefix (string) -- [REQUIRED]
The prefix of the video stream.
RetentionPeriodHours (integer) -- [REQUIRED]
The number of hours data is retained in the stream. Kinesis Video Streams retains the data in a data store that is associated with the stream.
The default value is 0, indicating that the stream does not persist data.
EncryptionConfig (dict) -- [REQUIRED]
The encryption configuration.
EncryptionType (string) -- [REQUIRED]
The type of encryption.
KeyId (string) -- [REQUIRED]
The full ARN of the encryption key.
KinesisStreamConfig (dict) --
The configuration of the Kinesis data stream.
StreamArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the data stream.
KinesisFirehoseConfig (dict) --
The configuration of the Kinesis Firehose delivery stream.
FirehoseArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the delivery stream.
dict
Response Syntax
{
'AssociationId': 'string'
}
Response Structure
(dict) --
AssociationId (string) --
The existing association identifier that uniquely identifies the resource type and storage config for the given instance ID.
{'QueueConfigs': {'QueueReference': {'Channel': {'EMAIL'}}}}
Associates a set of queues with a routing profile.
See also: AWS API Documentation
Request Syntax
client.associate_routing_profile_queues(
InstanceId='string',
RoutingProfileId='string',
QueueConfigs=[
{
'QueueReference': {
'QueueId': 'string',
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL'
},
'Priority': 123,
'Delay': 123
},
]
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the routing profile.
list
[REQUIRED]
The queues to associate with this routing profile.
(dict) --
Contains information about the queue and channel for which priority and delay can be set.
QueueReference (dict) -- [REQUIRED]
Contains information about a queue resource.
QueueId (string) -- [REQUIRED]
The identifier for the queue.
Channel (string) -- [REQUIRED]
The channels agents can handle in the Contact Control Panel (CCP) for this routing profile.
Priority (integer) -- [REQUIRED]
The order in which contacts are to be handled for the queue. For more information, see Queues: priority and delay.
Delay (integer) -- [REQUIRED]
The delay, in seconds, a contact should be in the queue before they are routed to an available agent. For more information, see Queues: priority and delay in the Amazon Connect Administrator Guide.
None
{'Files': {'FileUseCaseType': {'EMAIL_MESSAGE'}}}
Allows you to retrieve metadata about multiple attached files on an associated resource. Each attached file provided in the input list must be associated with the input AssociatedResourceArn.
See also: AWS API Documentation
Request Syntax
client.batch_get_attached_file_metadata(
FileIds=[
'string',
],
InstanceId='string',
AssociatedResourceArn='string'
)
list
[REQUIRED]
The unique identifiers of the attached file resource.
(string) --
string
[REQUIRED]
The unique identifier of the Connect instance.
string
[REQUIRED]
The resource to which the attached file is (being) uploaded to. Cases are the only current supported resource.
dict
Response Syntax
{
'Files': [
{
'CreationTime': 'string',
'FileArn': 'string',
'FileId': 'string',
'FileName': 'string',
'FileSizeInBytes': 123,
'FileStatus': 'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'CreatedBy': {
'ConnectUserArn': 'string',
'AWSIdentityArn': 'string'
},
'FileUseCaseType': 'EMAIL_MESSAGE'|'ATTACHMENT',
'AssociatedResourceArn': 'string',
'Tags': {
'string': 'string'
}
},
],
'Errors': [
{
'ErrorCode': 'string',
'ErrorMessage': 'string',
'FileId': 'string'
},
]
}
Response Structure
(dict) --
Files (list) --
List of attached files that were successfully retrieved.
(dict) --
Information about the attached file.
CreationTime (string) --
The time of Creation of the file resource as an ISO timestamp. It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2024-05-03T02:41:28.172Z.
FileArn (string) --
The unique identifier of the attached file resource (ARN).
FileId (string) --
The unique identifier of the attached file resource.
FileName (string) --
A case-sensitive name of the attached file being uploaded.
FileSizeInBytes (integer) --
The size of the attached file in bytes.
FileStatus (string) --
The current status of the attached file.
CreatedBy (dict) --
Represents the identity that created the file.
ConnectUserArn (string) --
An agent ARN representing a connect user.
AWSIdentityArn (string) --
STS or IAM ARN representing the identity of API Caller. SDK users cannot populate this and this value is calculated automatically if ConnectUserArn is not provided.
FileUseCaseType (string) --
The use case for the file.
AssociatedResourceArn (string) --
The resource to which the attached file is (being) uploaded to. Cases are the only current supported resource.
Tags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
Errors (list) --
List of errors of attached files that could not be retrieved.
(dict) --
Error describing a failure to retrieve attached file metadata through BatchGetAttachedFileMetadata action.
ErrorCode (string) --
Status code describing the failure.
ErrorMessage (string) --
Why the attached file couldn't be retrieved.
FileId (string) --
The unique identifier of the attached file resource.
{'ResourceType': {'OUTBOUND_EMAIL', 'INBOUND_EMAIL'}}
Response {'FlowAssociationSummaryList': {'ResourceType': {'INBOUND_EMAIL',
'OUTBOUND_EMAIL'}}}
Retrieve the flow associations for the given resources.
See also: AWS API Documentation
Request Syntax
client.batch_get_flow_association(
InstanceId='string',
ResourceIds=[
'string',
],
ResourceType='VOICE_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
list
[REQUIRED]
A list of resource identifiers to retrieve flow associations.
(string) --
string
The type of resource association.
dict
Response Syntax
{
'FlowAssociationSummaryList': [
{
'ResourceId': 'string',
'FlowId': 'string',
'ResourceType': 'VOICE_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'
},
]
}
Response Structure
(dict) --
FlowAssociationSummaryList (list) --
Information about flow associations.
(dict) --
Information about flow associations.
ResourceId (string) --
The identifier of the resource.
FlowId (string) --
The identifier of the flow.
ResourceType (string) --
The type of resource association.
{'ContactDataRequestList': {'CustomerEndpoint': {'Type': {'EMAIL_ADDRESS'}},
'SystemEndpoint': {'Type': {'EMAIL_ADDRESS'}}}}
Allows you to create a batch of contacts in Amazon Connect. The outbound campaigns capability ingests dial requests via the PutDialRequestBatch API. It then uses BatchPutContact to create contacts corresponding to those dial requests. If agents are available, the dial requests are dialed out, which results in a voice call. The resulting voice call uses the same contactId that was created by BatchPutContact.
See also: AWS API Documentation
Request Syntax
client.batch_put_contact(
ClientToken='string',
InstanceId='string',
ContactDataRequestList=[
{
'SystemEndpoint': {
'Type': 'TELEPHONE_NUMBER'|'VOIP'|'CONTACT_FLOW'|'CONNECT_PHONENUMBER_ARN'|'EMAIL_ADDRESS',
'Address': 'string'
},
'CustomerEndpoint': {
'Type': 'TELEPHONE_NUMBER'|'VOIP'|'CONTACT_FLOW'|'CONNECT_PHONENUMBER_ARN'|'EMAIL_ADDRESS',
'Address': 'string'
},
'RequestIdentifier': 'string',
'QueueId': 'string',
'Attributes': {
'string': 'string'
},
'Campaign': {
'CampaignId': 'string'
}
},
]
)
string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.
This field is autopopulated if not provided.
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
list
[REQUIRED]
List of individual contact requests.
(dict) --
Request object with information to create a contact.
SystemEndpoint (dict) --
Endpoint associated with the Amazon Connect instance from which outbound contact will be initiated for the campaign.
Type (string) --
Type of the endpoint.
Address (string) --
Address of the endpoint.
CustomerEndpoint (dict) --
Endpoint of the customer for which contact will be initiated.
Type (string) --
Type of the endpoint.
Address (string) --
Address of the endpoint.
RequestIdentifier (string) --
Identifier to uniquely identify individual requests in the batch.
QueueId (string) --
The identifier of the queue associated with the Amazon Connect instance in which contacts that are created will be queued.
Attributes (dict) --
List of attributes to be stored in a contact.
(string) --
(string) --
Campaign (dict) --
Structure to store information associated with a campaign.
CampaignId (string) --
A unique identifier for a campaign.
dict
Response Syntax
{
'SuccessfulRequestList': [
{
'RequestIdentifier': 'string',
'ContactId': 'string'
},
],
'FailedRequestList': [
{
'RequestIdentifier': 'string',
'FailureReasonCode': 'INVALID_ATTRIBUTE_KEY'|'INVALID_CUSTOMER_ENDPOINT'|'INVALID_SYSTEM_ENDPOINT'|'INVALID_QUEUE'|'MISSING_CAMPAIGN'|'MISSING_CUSTOMER_ENDPOINT'|'MISSING_QUEUE_ID_AND_SYSTEM_ENDPOINT'|'REQUEST_THROTTLED'|'IDEMPOTENCY_EXCEPTION'|'INTERNAL_ERROR',
'FailureReasonMessage': 'string'
},
]
}
Response Structure
(dict) --
SuccessfulRequestList (list) --
List of requests for which contact was successfully created.
(dict) --
Request for which contact was successfully created.
RequestIdentifier (string) --
Request identifier provided in the API call in the ContactDataRequest to create a contact.
ContactId (string) --
The contactId of the contact that was created successfully.
FailedRequestList (list) --
List of requests for which contact creation failed.
(dict) --
Request for which contact failed to be generated.
RequestIdentifier (string) --
Request identifier provided in the API call in the ContactDataRequest to create a contact.
FailureReasonCode (string) --
Reason code for the failure.
FailureReasonMessage (string) --
Why the request to create a contact failed.
{'IntegrationType': {'SES_IDENTITY'}}
Creates an Amazon Web Services resource association with an Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.create_integration_association(
InstanceId='string',
IntegrationType='EVENT'|'VOICE_ID'|'PINPOINT_APP'|'WISDOM_ASSISTANT'|'WISDOM_KNOWLEDGE_BASE'|'WISDOM_QUICK_RESPONSES'|'Q_MESSAGE_TEMPLATES'|'CASES_DOMAIN'|'APPLICATION'|'FILE_SCANNER'|'SES_IDENTITY',
IntegrationArn='string',
SourceApplicationUrl='string',
SourceApplicationName='string',
SourceType='SALESFORCE'|'ZENDESK'|'CASES',
Tags={
'string': 'string'
}
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The type of information to be ingested.
string
[REQUIRED]
The Amazon Resource Name (ARN) of the integration.
string
The URL for the external application. This field is only required for the EVENT integration type.
string
The name of the external application. This field is only required for the EVENT integration type.
string
The type of the data source. This field is only required for the EVENT integration type.
dict
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
dict
Response Syntax
{
'IntegrationAssociationId': 'string',
'IntegrationAssociationArn': 'string'
}
Response Structure
(dict) --
IntegrationAssociationId (string) --
The identifier for the integration association.
IntegrationAssociationArn (string) --
The Amazon Resource Name (ARN) for the association.
{'OutboundEmailConfig': {'OutboundEmailAddressId': 'string'}}
This API is in preview release for Amazon Connect and is subject to change.
Creates a new queue for the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.create_queue(
InstanceId='string',
Name='string',
Description='string',
OutboundCallerConfig={
'OutboundCallerIdName': 'string',
'OutboundCallerIdNumberId': 'string',
'OutboundFlowId': 'string'
},
OutboundEmailConfig={
'OutboundEmailAddressId': 'string'
},
HoursOfOperationId='string',
MaxContacts=123,
QuickConnectIds=[
'string',
],
Tags={
'string': 'string'
}
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The name of the queue.
string
The description of the queue.
dict
The outbound caller ID name, number, and outbound whisper flow.
OutboundCallerIdName (string) --
The caller ID name.
OutboundCallerIdNumberId (string) --
The caller ID number.
OutboundFlowId (string) --
The outbound whisper flow to be used during an outbound call.
dict
OutboundEmailAddressId (string) --
string
[REQUIRED]
The identifier for the hours of operation.
integer
The maximum number of contacts that can be in the queue before it is considered full.
list
The quick connects available to agents who are working the queue.
(string) --
dict
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
dict
Response Syntax
{
'QueueArn': 'string',
'QueueId': 'string'
}
Response Structure
(dict) --
QueueArn (string) --
The Amazon Resource Name (ARN) of the queue.
QueueId (string) --
The identifier for the queue.
{'MediaConcurrencies': {'Channel': {'EMAIL'}},
'QueueConfigs': {'QueueReference': {'Channel': {'EMAIL'}}}}
Creates a new routing profile.
See also: AWS API Documentation
Request Syntax
client.create_routing_profile(
InstanceId='string',
Name='string',
Description='string',
DefaultOutboundQueueId='string',
QueueConfigs=[
{
'QueueReference': {
'QueueId': 'string',
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL'
},
'Priority': 123,
'Delay': 123
},
],
MediaConcurrencies=[
{
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL',
'Concurrency': 123,
'CrossChannelBehavior': {
'BehaviorType': 'ROUTE_CURRENT_CHANNEL_ONLY'|'ROUTE_ANY_CHANNEL'
}
},
],
Tags={
'string': 'string'
},
AgentAvailabilityTimer='TIME_SINCE_LAST_ACTIVITY'|'TIME_SINCE_LAST_INBOUND'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The name of the routing profile. Must not be more than 127 characters.
string
[REQUIRED]
Description of the routing profile. Must not be more than 250 characters.
string
[REQUIRED]
The default outbound queue for the routing profile.
list
The inbound queues associated with the routing profile. If no queue is added, the agent can make only outbound calls.
The limit of 10 array members applies to the maximum number of RoutingProfileQueueConfig objects that can be passed during a CreateRoutingProfile API request. It is different from the quota of 50 queues per routing profile per instance that is listed in Amazon Connect service quotas.
(dict) --
Contains information about the queue and channel for which priority and delay can be set.
QueueReference (dict) -- [REQUIRED]
Contains information about a queue resource.
QueueId (string) -- [REQUIRED]
The identifier for the queue.
Channel (string) -- [REQUIRED]
The channels agents can handle in the Contact Control Panel (CCP) for this routing profile.
Priority (integer) -- [REQUIRED]
The order in which contacts are to be handled for the queue. For more information, see Queues: priority and delay.
Delay (integer) -- [REQUIRED]
The delay, in seconds, a contact should be in the queue before they are routed to an available agent. For more information, see Queues: priority and delay in the Amazon Connect Administrator Guide.
list
[REQUIRED]
The channels that agents can handle in the Contact Control Panel (CCP) for this routing profile.
(dict) --
Contains information about which channels are supported, and how many contacts an agent can have on a channel simultaneously.
Channel (string) -- [REQUIRED]
The channels that agents can handle in the Contact Control Panel (CCP).
Concurrency (integer) -- [REQUIRED]
The number of contacts an agent can have on a channel simultaneously.
Valid Range for VOICE: Minimum value of 1. Maximum value of 1.
Valid Range for CHAT: Minimum value of 1. Maximum value of 10.
Valid Range for TASK: Minimum value of 1. Maximum value of 10.
CrossChannelBehavior (dict) --
Defines the cross-channel routing behavior for each channel that is enabled for this Routing Profile. For example, this allows you to offer an agent a different contact from another channel when they are currently working with a contact from a Voice channel.
BehaviorType (string) -- [REQUIRED]
Specifies the other channels that can be routed to an agent handling their current channel.
dict
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
string
Whether agents with this routing profile will have their routing order calculated based on longest idle time or time since their last inbound contact.
dict
Response Syntax
{
'RoutingProfileArn': 'string',
'RoutingProfileId': 'string'
}
Response Structure
(dict) --
RoutingProfileArn (string) --
The Amazon Resource Name (ARN) of the routing profile.
RoutingProfileId (string) --
The identifier of the routing profile.
{'Actions': {'TaskAction': {'References': {'Arn': 'string',
'Status': 'AVAILABLE | DELETED | '
'APPROVED | REJECTED | '
'PROCESSING | FAILED',
'StatusReason': 'string',
'Type': {'CONTACT_ANALYSIS',
'EMAIL_MESSAGE'}}}}}
Creates a rule for the specified Amazon Connect instance.
Use the Rules Function language to code conditions for the rule.
See also: AWS API Documentation
Request Syntax
client.create_rule(
InstanceId='string',
Name='string',
TriggerEventSource={
'EventSourceName': 'OnPostCallAnalysisAvailable'|'OnRealTimeCallAnalysisAvailable'|'OnRealTimeChatAnalysisAvailable'|'OnPostChatAnalysisAvailable'|'OnZendeskTicketCreate'|'OnZendeskTicketStatusUpdate'|'OnSalesforceCaseCreate'|'OnContactEvaluationSubmit'|'OnMetricDataUpdate'|'OnCaseCreate'|'OnCaseUpdate',
'IntegrationAssociationId': 'string'
},
Function='string',
Actions=[
{
'ActionType': 'CREATE_TASK'|'ASSIGN_CONTACT_CATEGORY'|'GENERATE_EVENTBRIDGE_EVENT'|'SEND_NOTIFICATION'|'CREATE_CASE'|'UPDATE_CASE'|'END_ASSOCIATED_TASKS'|'SUBMIT_AUTO_EVALUATION',
'TaskAction': {
'Name': 'string',
'Description': 'string',
'ContactFlowId': 'string',
'References': {
'string': {
'Value': 'string',
'Type': 'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string',
'StatusReason': 'string'
}
}
},
'EventBridgeAction': {
'Name': 'string'
},
'AssignContactCategoryAction': {}
,
'SendNotificationAction': {
'DeliveryMethod': 'EMAIL',
'Subject': 'string',
'Content': 'string',
'ContentType': 'PLAIN_TEXT',
'Recipient': {
'UserTags': {
'string': 'string'
},
'UserIds': [
'string',
]
}
},
'CreateCaseAction': {
'Fields': [
{
'Id': 'string',
'Value': {
'BooleanValue': True|False,
'DoubleValue': 123.0,
'EmptyValue': {}
,
'StringValue': 'string'
}
},
],
'TemplateId': 'string'
},
'UpdateCaseAction': {
'Fields': [
{
'Id': 'string',
'Value': {
'BooleanValue': True|False,
'DoubleValue': 123.0,
'EmptyValue': {}
,
'StringValue': 'string'
}
},
]
},
'EndAssociatedTasksAction': {}
,
'SubmitAutoEvaluationAction': {
'EvaluationFormId': 'string'
}
},
],
PublishStatus='DRAFT'|'PUBLISHED',
ClientToken='string'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
A unique name for the rule.
dict
[REQUIRED]
The event source to trigger the rule.
EventSourceName (string) -- [REQUIRED]
The name of the event source.
IntegrationAssociationId (string) --
The identifier for the integration association.
string
[REQUIRED]
The conditions of the rule.
list
[REQUIRED]
A list of actions to be run when the rule is triggered.
(dict) --
Information about the action to be performed when a rule is triggered.
ActionType (string) -- [REQUIRED]
The type of action that creates a rule.
TaskAction (dict) --
Information about the task action. This field is required if TriggerEventSource is one of the following values: OnZendeskTicketCreate | OnZendeskTicketStatusUpdate | OnSalesforceCaseCreate
Name (string) -- [REQUIRED]
The name. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
Description (string) --
The description. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
ContactFlowId (string) -- [REQUIRED]
The identifier of the flow.
References (dict) --
Information about the reference when the referenceType is URL. Otherwise, null. (Supports variable injection in the Value field.)
(string) --
(dict) --
Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.
Value (string) --
A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).
Type (string) -- [REQUIRED]
The type of the reference. DATE must be of type Epoch timestamp.
Status (string) --
Arn (string) --
StatusReason (string) --
EventBridgeAction (dict) --
Information about the EventBridge action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnContactEvaluationSubmit | OnMetricDataUpdate
Name (string) -- [REQUIRED]
The name.
AssignContactCategoryAction (dict) --
Information about the contact category action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnZendeskTicketCreate | OnZendeskTicketStatusUpdate | OnSalesforceCaseCreate
SendNotificationAction (dict) --
Information about the send notification action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnContactEvaluationSubmit | OnMetricDataUpdate
DeliveryMethod (string) -- [REQUIRED]
Notification delivery method.
Subject (string) --
The subject of the email if the delivery method is EMAIL. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
Content (string) -- [REQUIRED]
Notification content. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
ContentType (string) -- [REQUIRED]
Content type format.
Recipient (dict) -- [REQUIRED]
Notification recipient.
UserTags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }. Amazon Connect users with the specified tags will be notified.
(string) --
(string) --
UserIds (list) --
A list of user IDs.
(string) --
CreateCaseAction (dict) --
Information about the create case action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnPostChatAnalysisAvailable.
Fields (list) -- [REQUIRED]
An array of objects with Field ID and Value data.
(dict) --
Object for case field values.
Id (string) -- [REQUIRED]
Unique identifier of a field.
Value (dict) -- [REQUIRED]
Union of potential field value types.
BooleanValue (boolean) --
A Boolean number value type.
DoubleValue (float) --
A Double number value type.
EmptyValue (dict) --
An empty value.
StringValue (string) --
String value type.
TemplateId (string) -- [REQUIRED]
A unique identifier of a template.
UpdateCaseAction (dict) --
Information about the update case action.
Supported only for TriggerEventSource values: OnCaseCreate | OnCaseUpdate.
Fields (list) -- [REQUIRED]
An array of objects with Field ID and Value data.
(dict) --
Object for case field values.
Id (string) -- [REQUIRED]
Unique identifier of a field.
Value (dict) -- [REQUIRED]
Union of potential field value types.
BooleanValue (boolean) --
A Boolean number value type.
DoubleValue (float) --
A Double number value type.
EmptyValue (dict) --
An empty value.
StringValue (string) --
String value type.
EndAssociatedTasksAction (dict) --
Information about the end associated tasks action.
Supported only for TriggerEventSource values: OnCaseUpdate.
SubmitAutoEvaluationAction (dict) --
Information about the submit automated evaluation action.
EvaluationFormId (string) -- [REQUIRED]
The identifier of the auto-evaluation enabled form.
string
[REQUIRED]
The publish status of the rule.
string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.
This field is autopopulated if not provided.
dict
Response Syntax
{
'RuleArn': 'string',
'RuleId': 'string'
}
Response Structure
(dict) --
RuleArn (string) --
The Amazon Resource Name (ARN) of the rule.
RuleId (string) --
A unique identifier for the rule.
{'Fields': {'Type': {'EXPIRY_DURATION', 'SELF_ASSIGN'}},
'SelfAssignFlowId': 'string'}
Creates a new task template in the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.create_task_template(
InstanceId='string',
Name='string',
Description='string',
ContactFlowId='string',
SelfAssignFlowId='string',
Constraints={
'RequiredFields': [
{
'Id': {
'Name': 'string'
}
},
],
'ReadOnlyFields': [
{
'Id': {
'Name': 'string'
}
},
],
'InvisibleFields': [
{
'Id': {
'Name': 'string'
}
},
]
},
Defaults={
'DefaultFieldValues': [
{
'Id': {
'Name': 'string'
},
'DefaultValue': 'string'
},
]
},
Status='ACTIVE'|'INACTIVE',
Fields=[
{
'Id': {
'Name': 'string'
},
'Description': 'string',
'Type': 'NAME'|'DESCRIPTION'|'SCHEDULED_TIME'|'QUICK_CONNECT'|'URL'|'NUMBER'|'TEXT'|'TEXT_AREA'|'DATE_TIME'|'BOOLEAN'|'SINGLE_SELECT'|'EMAIL'|'SELF_ASSIGN'|'EXPIRY_DURATION',
'SingleSelectOptions': [
'string',
]
},
],
ClientToken='string'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The name of the task template.
string
The description of the task template.
string
The identifier of the flow that runs by default when a task is created by referencing this template.
string
dict
Constraints that are applicable to the fields listed.
RequiredFields (list) --
Lists the fields that are required to be filled by agents.
(dict) --
Information about a required field.
Id (dict) --
The unique identifier for the field.
Name (string) --
The name of the task template field.
ReadOnlyFields (list) --
Lists the fields that are read-only to agents, and cannot be edited.
(dict) --
Indicates a field that is read-only to an agent.
Id (dict) --
Identifier of the read-only field.
Name (string) --
The name of the task template field.
InvisibleFields (list) --
Lists the fields that are invisible to agents.
(dict) --
A field that is invisible to an agent.
Id (dict) --
Identifier of the invisible field.
Name (string) --
The name of the task template field.
dict
The default values for fields when a task is created by referencing this template.
DefaultFieldValues (list) --
Default value for the field.
(dict) --
Describes a default field and its corresponding value.
Id (dict) --
Identifier of a field.
Name (string) --
The name of the task template field.
DefaultValue (string) --
Default value for the field.
string
Marks a template as ACTIVE or INACTIVE for a task to refer to it. Tasks can only be created from ACTIVE templates. If a template is marked as INACTIVE, then a task that refers to this template cannot be created.
list
[REQUIRED]
Fields that are part of the template.
(dict) --
Describes a single task template field.
Id (dict) -- [REQUIRED]
The unique identifier for the field.
Name (string) --
The name of the task template field.
Description (string) --
The description of the field.
Type (string) --
Indicates the type of field.
SingleSelectOptions (list) --
A list of options for a single select field.
(string) --
string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.
This field is autopopulated if not provided.
dict
Response Syntax
{
'Id': 'string',
'Arn': 'string'
}
Response Structure
(dict) --
Id (string) --
The identifier of the task template resource.
Arn (string) --
The Amazon Resource Name (ARN) for the task template resource.
{'Contact': {'AdditionalEmailRecipients': {'CcList': [{'Address': 'string',
'DisplayName': 'string'}],
'ToList': [{'Address': 'string',
'DisplayName': 'string'}]},
'Channel': {'EMAIL'},
'ContactAssociationId': 'string',
'CustomerEndpoint': {'Address': 'string',
'DisplayName': 'string',
'Type': 'TELEPHONE_NUMBER | VOIP | '
'CONTACT_FLOW | '
'CONNECT_PHONENUMBER_ARN | '
'EMAIL_ADDRESS'},
'InitiationMethod': {'WEBRTC_API', 'AGENT_REPLY', 'FLOW'},
'SystemEndpoint': {'Address': 'string',
'DisplayName': 'string',
'Type': 'TELEPHONE_NUMBER | VOIP | '
'CONTACT_FLOW | '
'CONNECT_PHONENUMBER_ARN | '
'EMAIL_ADDRESS'}}}
This API is in preview release for Amazon Connect and is subject to change.
Describes the specified contact.
See also: AWS API Documentation
Request Syntax
client.describe_contact(
InstanceId='string',
ContactId='string'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the contact.
dict
Response Syntax
{
'Contact': {
'Arn': 'string',
'Id': 'string',
'InitialContactId': 'string',
'PreviousContactId': 'string',
'ContactAssociationId': 'string',
'InitiationMethod': 'INBOUND'|'OUTBOUND'|'TRANSFER'|'QUEUE_TRANSFER'|'CALLBACK'|'API'|'DISCONNECT'|'MONITOR'|'EXTERNAL_OUTBOUND'|'WEBRTC_API'|'AGENT_REPLY'|'FLOW',
'Name': 'string',
'Description': 'string',
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL',
'QueueInfo': {
'Id': 'string',
'EnqueueTimestamp': datetime(2015, 1, 1)
},
'AgentInfo': {
'Id': 'string',
'ConnectedToAgentTimestamp': datetime(2015, 1, 1),
'AgentPauseDurationInSeconds': 123,
'HierarchyGroups': {
'Level1': {
'Arn': 'string'
},
'Level2': {
'Arn': 'string'
},
'Level3': {
'Arn': 'string'
},
'Level4': {
'Arn': 'string'
},
'Level5': {
'Arn': 'string'
}
},
'DeviceInfo': {
'PlatformName': 'string',
'PlatformVersion': 'string',
'OperatingSystem': 'string'
},
'Capabilities': {
'Video': 'SEND',
'ScreenShare': 'SEND'
}
},
'InitiationTimestamp': datetime(2015, 1, 1),
'DisconnectTimestamp': datetime(2015, 1, 1),
'LastUpdateTimestamp': datetime(2015, 1, 1),
'LastPausedTimestamp': datetime(2015, 1, 1),
'LastResumedTimestamp': datetime(2015, 1, 1),
'TotalPauseCount': 123,
'TotalPauseDurationInSeconds': 123,
'ScheduledTimestamp': datetime(2015, 1, 1),
'RelatedContactId': 'string',
'WisdomInfo': {
'SessionArn': 'string'
},
'CustomerEndpoint': {
'Type': 'TELEPHONE_NUMBER'|'VOIP'|'CONTACT_FLOW'|'CONNECT_PHONENUMBER_ARN'|'EMAIL_ADDRESS',
'Address': 'string',
'DisplayName': 'string'
},
'SystemEndpoint': {
'Type': 'TELEPHONE_NUMBER'|'VOIP'|'CONTACT_FLOW'|'CONNECT_PHONENUMBER_ARN'|'EMAIL_ADDRESS',
'Address': 'string',
'DisplayName': 'string'
},
'QueueTimeAdjustmentSeconds': 123,
'QueuePriority': 123,
'Tags': {
'string': 'string'
},
'ConnectedToSystemTimestamp': datetime(2015, 1, 1),
'RoutingCriteria': {
'Steps': [
{
'Expiry': {
'DurationInSeconds': 123,
'ExpiryTimestamp': datetime(2015, 1, 1)
},
'Expression': {
'AttributeCondition': {
'Name': 'string',
'Value': 'string',
'ProficiencyLevel': ...,
'MatchCriteria': {
'AgentsCriteria': {
'AgentIds': [
'string',
]
}
},
'ComparisonOperator': 'string'
},
'AndExpression': [
{'... recursive ...'},
],
'OrExpression': [
{'... recursive ...'},
]
},
'Status': 'ACTIVE'|'INACTIVE'|'JOINED'|'EXPIRED'
},
],
'ActivationTimestamp': datetime(2015, 1, 1),
'Index': 123
},
'Customer': {
'DeviceInfo': {
'PlatformName': 'string',
'PlatformVersion': 'string',
'OperatingSystem': 'string'
},
'Capabilities': {
'Video': 'SEND',
'ScreenShare': 'SEND'
}
},
'Campaign': {
'CampaignId': 'string'
},
'AnsweringMachineDetectionStatus': 'ANSWERED'|'UNDETECTED'|'ERROR'|'HUMAN_ANSWERED'|'SIT_TONE_DETECTED'|'SIT_TONE_BUSY'|'SIT_TONE_INVALID_NUMBER'|'FAX_MACHINE_DETECTED'|'VOICEMAIL_BEEP'|'VOICEMAIL_NO_BEEP'|'AMD_UNRESOLVED'|'AMD_UNANSWERED'|'AMD_ERROR'|'AMD_NOT_APPLICABLE',
'CustomerVoiceActivity': {
'GreetingStartTimestamp': datetime(2015, 1, 1),
'GreetingEndTimestamp': datetime(2015, 1, 1)
},
'QualityMetrics': {
'Agent': {
'Audio': {
'QualityScore': ...,
'PotentialQualityIssues': [
'string',
]
}
},
'Customer': {
'Audio': {
'QualityScore': ...,
'PotentialQualityIssues': [
'string',
]
}
}
},
'DisconnectDetails': {
'PotentialDisconnectIssue': 'string'
},
'AdditionalEmailRecipients': {
'ToList': [
{
'Address': 'string',
'DisplayName': 'string'
},
],
'CcList': [
{
'Address': 'string',
'DisplayName': 'string'
},
]
},
'SegmentAttributes': {
'string': {
'ValueString': 'string'
}
}
}
}
Response Structure
(dict) --
Contact (dict) --
Information about the contact.
Arn (string) --
The Amazon Resource Name (ARN) for the contact.
Id (string) --
The identifier for the contact.
InitialContactId (string) --
If this contact is related to other contacts, this is the ID of the initial contact.
PreviousContactId (string) --
If this contact is not the first contact, this is the ID of the previous contact.
ContactAssociationId (string) --
InitiationMethod (string) --
Indicates how the contact was initiated.
Name (string) --
The name of the contact.
Description (string) --
The description of the contact.
Channel (string) --
How the contact reached your contact center.
QueueInfo (dict) --
If this contact was queued, this contains information about the queue.
Id (string) --
The unique identifier for the queue.
EnqueueTimestamp (datetime) --
The timestamp when the contact was added to the queue.
AgentInfo (dict) --
Information about the agent who accepted the contact.
Id (string) --
The identifier of the agent who accepted the contact.
ConnectedToAgentTimestamp (datetime) --
The timestamp when the contact was connected to the agent.
AgentPauseDurationInSeconds (integer) --
Agent pause duration for a contact in seconds.
HierarchyGroups (dict) --
The agent hierarchy groups for the agent.
Level1 (dict) --
The group at level one of the agent hierarchy.
Arn (string) --
The Amazon Resource Name (ARN) of the group.
Level2 (dict) --
The group at level two of the agent hierarchy.
Arn (string) --
The Amazon Resource Name (ARN) of the group.
Level3 (dict) --
The group at level three of the agent hierarchy.
Arn (string) --
The Amazon Resource Name (ARN) of the group.
Level4 (dict) --
The group at level four of the agent hierarchy.
Arn (string) --
The Amazon Resource Name (ARN) of the group.
Level5 (dict) --
The group at level five of the agent hierarchy.
Arn (string) --
The Amazon Resource Name (ARN) of the group.
DeviceInfo (dict) --
Information regarding Agent’s device.
PlatformName (string) --
Name of the platform that the participant used for the call.
PlatformVersion (string) --
Version of the platform that the participant used for the call.
OperatingSystem (string) --
Operating system that the participant used for the call.
Capabilities (dict) --
The configuration for the allowed video and screen sharing capabilities for participants present over the call. For more information, see Set up in-app, web, video calling, and screen sharing capabilities in the Amazon Connect Administrator Guide.
Video (string) --
The configuration having the video and screen sharing capabilities for participants over the call.
ScreenShare (string) --
The screen sharing capability that is enabled for the participant. SEND indicates the participant can share their screen.
InitiationTimestamp (datetime) --
The date and time this contact was initiated, in UTC time. For INBOUND, this is when the contact arrived. For OUTBOUND, this is when the agent began dialing. For CALLBACK, this is when the callback contact was created. For TRANSFER and QUEUE_TRANSFER, this is when the transfer was initiated. For API, this is when the request arrived. For EXTERNAL_OUTBOUND, this is when the agent started dialing the external participant. For MONITOR, this is when the supervisor started listening to a contact.
DisconnectTimestamp (datetime) --
The timestamp when the customer endpoint disconnected from Amazon Connect.
LastUpdateTimestamp (datetime) --
The timestamp when contact was last updated.
LastPausedTimestamp (datetime) --
The timestamp when the contact was last paused.
LastResumedTimestamp (datetime) --
The timestamp when the contact was last resumed.
TotalPauseCount (integer) --
Total pause count for a contact.
TotalPauseDurationInSeconds (integer) --
Total pause duration for a contact in seconds.
ScheduledTimestamp (datetime) --
The timestamp, in Unix epoch time format, at which to start running the inbound flow.
RelatedContactId (string) --
The contactId that is related to this contact.
WisdomInfo (dict) --
Information about Amazon Connect Wisdom.
SessionArn (string) --
The Amazon Resource Name (ARN) of the Wisdom session.
CustomerEndpoint (dict) --
Type (string) --
Address (string) --
DisplayName (string) --
SystemEndpoint (dict) --
Type (string) --
Address (string) --
DisplayName (string) --
QueueTimeAdjustmentSeconds (integer) --
An integer that represents the queue time adjust to be applied to the contact, in seconds (longer / larger queue time are routed preferentially). Cannot be specified if the QueuePriority is specified. Must be statically defined and a valid integer value.
QueuePriority (integer) --
An integer that represents the queue priority to be applied to the contact (lower priorities are routed preferentially). Cannot be specified if the QueueTimeAdjustmentSeconds is specified. Must be statically defined, must be larger than zero, and a valid integer value. Default Value is 5.
Tags (dict) --
Tags associated with the contact. This contains both Amazon Web Services generated and user-defined tags.
(string) --
(string) --
ConnectedToSystemTimestamp (datetime) --
The timestamp when customer endpoint connected to Amazon Connect.
RoutingCriteria (dict) --
Latest routing criteria on the contact.
Steps (list) --
List of routing steps. When Amazon Connect does not find an available agent meeting the requirements in a step for a given step duration, the routing criteria will move on to the next step sequentially until a join is completed with an agent. When all steps are exhausted, the contact will be offered to any agent in the queue.
(dict) --
Step signifies the criteria to be used for routing to an agent
Expiry (dict) --
An object to specify the expiration of a routing step.
DurationInSeconds (integer) --
The number of seconds to wait before expiring the routing step.
ExpiryTimestamp (datetime) --
The timestamp indicating when the routing step expires.
Expression (dict) --
A tagged union to specify expression for a routing step.
AttributeCondition (dict) --
An object to specify the predefined attribute condition.
Name (string) --
The name of predefined attribute.
Value (string) --
The value of predefined attribute.
ProficiencyLevel (float) --
The proficiency level of the condition.
MatchCriteria (dict) --
An object to define AgentsCriteria.
AgentsCriteria (dict) --
An object to define agentIds.
AgentIds (list) --
An object to specify a list of agents, by user ID.
(string) --
ComparisonOperator (string) --
The operator of the condition.
AndExpression (list) --
List of routing expressions which will be AND-ed together.
(dict) --
A tagged union to specify expression for a routing step.
OrExpression (list) --
List of routing expressions which will be OR-ed together.
(dict) --
A tagged union to specify expression for a routing step.
Status (string) --
Represents status of the Routing step.
ActivationTimestamp (datetime) --
The timestamp indicating when the routing criteria is set to active. A routing criteria is activated when contact is transferred to a queue. ActivationTimestamp will be set on routing criteria for contacts in agent queue even though Routing criteria is never activated for contacts in agent queue.
Index (integer) --
Information about the index of the routing criteria.
Customer (dict) --
Information about the Customer on the contact.
DeviceInfo (dict) --
Information regarding Customer’s device.
PlatformName (string) --
Name of the platform that the participant used for the call.
PlatformVersion (string) --
Version of the platform that the participant used for the call.
OperatingSystem (string) --
Operating system that the participant used for the call.
Capabilities (dict) --
The configuration for the allowed video and screen sharing capabilities for participants present over the call. For more information, see Set up in-app, web, video calling, and screen sharing capabilities in the Amazon Connect Administrator Guide.
Video (string) --
The configuration having the video and screen sharing capabilities for participants over the call.
ScreenShare (string) --
The screen sharing capability that is enabled for the participant. SEND indicates the participant can share their screen.
Campaign (dict) --
Information associated with a campaign.
CampaignId (string) --
A unique identifier for a campaign.
AnsweringMachineDetectionStatus (string) --
Indicates how an outbound campaign call is actually disposed if the contact is connected to Amazon Connect.
CustomerVoiceActivity (dict) --
Information about customer’s voice activity.
GreetingStartTimestamp (datetime) --
Timestamp that measures the beginning of the customer greeting from an outbound voice call.
GreetingEndTimestamp (datetime) --
Timestamp that measures the end of the customer greeting from an outbound voice call.
QualityMetrics (dict) --
Information about the quality of the participant's media connection.
Agent (dict) --
Information about the quality of Agent media connection.
Audio (dict) --
Information about the audio quality of the Agent
QualityScore (float) --
Number measuring the estimated quality of the media connection.
PotentialQualityIssues (list) --
List of potential issues causing degradation of quality on a media connection. If the service did not detect any potential quality issues the list is empty.
Valid values: HighPacketLoss | HighRoundTripTime | HighJitterBuffer
(string) --
Customer (dict) --
Information about the quality of Customer media connection.
Audio (dict) --
Information about the audio quality of the Customer
QualityScore (float) --
Number measuring the estimated quality of the media connection.
PotentialQualityIssues (list) --
List of potential issues causing degradation of quality on a media connection. If the service did not detect any potential quality issues the list is empty.
Valid values: HighPacketLoss | HighRoundTripTime | HighJitterBuffer
(string) --
DisconnectDetails (dict) --
Information about the call disconnect experience.
PotentialDisconnectIssue (string) --
Indicates the potential disconnection issues for a call. This field is not populated if the service does not detect potential issues.
AdditionalEmailRecipients (dict) --
ToList (list) --
(dict) --
Address (string) --
DisplayName (string) --
CcList (list) --
(dict) --
Address (string) --
DisplayName (string) --
SegmentAttributes (dict) --
A set of system defined key-value pairs stored on individual contact segments using an attribute map. The attributes are standard Amazon Connect attributes and can be accessed in flows. Attribute keys can include only alphanumeric, -, and _ characters. This field can be used to show channel subtype. For example, connect:Guide or connect:SMS.
(string) --
(dict) --
A value for a segment attribute. This is structured as a map where the key is valueString and the value is a string.
ValueString (string) --
The value of a segment attribute.
{'ResourceType': {'EMAIL_MESSAGES'}}
This 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.
See also: AWS API Documentation
Request Syntax
client.describe_instance_storage_config(
InstanceId='string',
AssociationId='string',
ResourceType='CHAT_TRANSCRIPTS'|'CALL_RECORDINGS'|'SCHEDULED_REPORTS'|'MEDIA_STREAMS'|'CONTACT_TRACE_RECORDS'|'AGENT_EVENTS'|'REAL_TIME_CONTACT_ANALYSIS_SEGMENTS'|'ATTACHMENTS'|'CONTACT_EVALUATIONS'|'SCREEN_RECORDINGS'|'REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS'|'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS'|'EMAIL_MESSAGES'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The existing association identifier that uniquely identifies the resource type and storage config for the given instance ID.
string
[REQUIRED]
A valid resource type.
dict
Response Syntax
{
'StorageConfig': {
'AssociationId': 'string',
'StorageType': 'S3'|'KINESIS_VIDEO_STREAM'|'KINESIS_STREAM'|'KINESIS_FIREHOSE',
'S3Config': {
'BucketName': 'string',
'BucketPrefix': 'string',
'EncryptionConfig': {
'EncryptionType': 'KMS',
'KeyId': 'string'
}
},
'KinesisVideoStreamConfig': {
'Prefix': 'string',
'RetentionPeriodHours': 123,
'EncryptionConfig': {
'EncryptionType': 'KMS',
'KeyId': 'string'
}
},
'KinesisStreamConfig': {
'StreamArn': 'string'
},
'KinesisFirehoseConfig': {
'FirehoseArn': 'string'
}
}
}
Response Structure
(dict) --
StorageConfig (dict) --
A valid storage type.
AssociationId (string) --
The existing association identifier that uniquely identifies the resource type and storage config for the given instance ID.
StorageType (string) --
A valid storage type.
S3Config (dict) --
The S3 bucket configuration.
BucketName (string) --
The S3 bucket name.
BucketPrefix (string) --
The S3 bucket prefix.
EncryptionConfig (dict) --
The Amazon S3 encryption configuration.
EncryptionType (string) --
The type of encryption.
KeyId (string) --
The full ARN of the encryption key.
KinesisVideoStreamConfig (dict) --
The configuration of the Kinesis video stream.
Prefix (string) --
The prefix of the video stream.
RetentionPeriodHours (integer) --
The number of hours data is retained in the stream. Kinesis Video Streams retains the data in a data store that is associated with the stream.
The default value is 0, indicating that the stream does not persist data.
EncryptionConfig (dict) --
The encryption configuration.
EncryptionType (string) --
The type of encryption.
KeyId (string) --
The full ARN of the encryption key.
KinesisStreamConfig (dict) --
The configuration of the Kinesis data stream.
StreamArn (string) --
The Amazon Resource Name (ARN) of the data stream.
KinesisFirehoseConfig (dict) --
The configuration of the Kinesis Firehose delivery stream.
FirehoseArn (string) --
The Amazon Resource Name (ARN) of the delivery stream.
{'Queue': {'OutboundEmailConfig': {'OutboundEmailAddressId': 'string'}}}
This API is in preview release for Amazon Connect and is subject to change.
Describes the specified queue.
See also: AWS API Documentation
Request Syntax
client.describe_queue(
InstanceId='string',
QueueId='string'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier for the queue.
dict
Response Syntax
{
'Queue': {
'Name': 'string',
'QueueArn': 'string',
'QueueId': 'string',
'Description': 'string',
'OutboundCallerConfig': {
'OutboundCallerIdName': 'string',
'OutboundCallerIdNumberId': 'string',
'OutboundFlowId': 'string'
},
'OutboundEmailConfig': {
'OutboundEmailAddressId': 'string'
},
'HoursOfOperationId': 'string',
'MaxContacts': 123,
'Status': 'ENABLED'|'DISABLED',
'Tags': {
'string': 'string'
},
'LastModifiedTime': datetime(2015, 1, 1),
'LastModifiedRegion': 'string'
}
}
Response Structure
(dict) --
Queue (dict) --
The name of the queue.
Name (string) --
The name of the queue.
QueueArn (string) --
The Amazon Resource Name (ARN) for the queue.
QueueId (string) --
The identifier for the queue.
Description (string) --
The description of the queue.
OutboundCallerConfig (dict) --
The outbound caller ID name, number, and outbound whisper flow.
OutboundCallerIdName (string) --
The caller ID name.
OutboundCallerIdNumberId (string) --
The caller ID number.
OutboundFlowId (string) --
The outbound whisper flow to be used during an outbound call.
OutboundEmailConfig (dict) --
OutboundEmailAddressId (string) --
HoursOfOperationId (string) --
The identifier for the hours of operation.
MaxContacts (integer) --
The maximum number of contacts that can be in the queue before it is considered full.
Status (string) --
The status of the queue.
Tags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
LastModifiedTime (datetime) --
The timestamp when this resource was last modified.
LastModifiedRegion (string) --
The Amazon Web Services Region where this resource was last modified.
{'RoutingProfile': {'MediaConcurrencies': {'Channel': {'EMAIL'}}}}
Describes the specified routing profile.
See also: AWS API Documentation
Request Syntax
client.describe_routing_profile(
InstanceId='string',
RoutingProfileId='string'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the routing profile.
dict
Response Syntax
{
'RoutingProfile': {
'InstanceId': 'string',
'Name': 'string',
'RoutingProfileArn': 'string',
'RoutingProfileId': 'string',
'Description': 'string',
'MediaConcurrencies': [
{
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL',
'Concurrency': 123,
'CrossChannelBehavior': {
'BehaviorType': 'ROUTE_CURRENT_CHANNEL_ONLY'|'ROUTE_ANY_CHANNEL'
}
},
],
'DefaultOutboundQueueId': 'string',
'Tags': {
'string': 'string'
},
'NumberOfAssociatedQueues': 123,
'NumberOfAssociatedUsers': 123,
'AgentAvailabilityTimer': 'TIME_SINCE_LAST_ACTIVITY'|'TIME_SINCE_LAST_INBOUND',
'LastModifiedTime': datetime(2015, 1, 1),
'LastModifiedRegion': 'string',
'IsDefault': True|False,
'AssociatedQueueIds': [
'string',
]
}
}
Response Structure
(dict) --
RoutingProfile (dict) --
The routing profile.
InstanceId (string) --
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
Name (string) --
The name of the routing profile.
RoutingProfileArn (string) --
The Amazon Resource Name (ARN) of the routing profile.
RoutingProfileId (string) --
The identifier of the routing profile.
Description (string) --
The description of the routing profile.
MediaConcurrencies (list) --
The channels agents can handle in the Contact Control Panel (CCP) for this routing profile.
(dict) --
Contains information about which channels are supported, and how many contacts an agent can have on a channel simultaneously.
Channel (string) --
The channels that agents can handle in the Contact Control Panel (CCP).
Concurrency (integer) --
The number of contacts an agent can have on a channel simultaneously.
Valid Range for VOICE: Minimum value of 1. Maximum value of 1.
Valid Range for CHAT: Minimum value of 1. Maximum value of 10.
Valid Range for TASK: Minimum value of 1. Maximum value of 10.
CrossChannelBehavior (dict) --
Defines the cross-channel routing behavior for each channel that is enabled for this Routing Profile. For example, this allows you to offer an agent a different contact from another channel when they are currently working with a contact from a Voice channel.
BehaviorType (string) --
Specifies the other channels that can be routed to an agent handling their current channel.
DefaultOutboundQueueId (string) --
The identifier of the default outbound queue for this routing profile.
Tags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
NumberOfAssociatedQueues (integer) --
The number of associated queues in routing profile.
NumberOfAssociatedUsers (integer) --
The number of associated users in routing profile.
AgentAvailabilityTimer (string) --
Whether agents with this routing profile will have their routing order calculated based on time since their last inbound contact or longest idle time.
LastModifiedTime (datetime) --
The timestamp when this resource was last modified.
LastModifiedRegion (string) --
The Amazon Web Services Region where this resource was last modified.
IsDefault (boolean) --
Whether this a default routing profile.
AssociatedQueueIds (list) --
The IDs of the associated queue.
(string) --
{'Rule': {'Actions': {'TaskAction': {'References': {'Arn': 'string',
'Status': 'AVAILABLE | '
'DELETED | '
'APPROVED | '
'REJECTED | '
'PROCESSING | '
'FAILED',
'StatusReason': 'string',
'Type': {'CONTACT_ANALYSIS',
'EMAIL_MESSAGE'}}}}}}
Describes a rule for the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.describe_rule(
InstanceId='string',
RuleId='string'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
A unique identifier for the rule.
dict
Response Syntax
{
'Rule': {
'Name': 'string',
'RuleId': 'string',
'RuleArn': 'string',
'TriggerEventSource': {
'EventSourceName': 'OnPostCallAnalysisAvailable'|'OnRealTimeCallAnalysisAvailable'|'OnRealTimeChatAnalysisAvailable'|'OnPostChatAnalysisAvailable'|'OnZendeskTicketCreate'|'OnZendeskTicketStatusUpdate'|'OnSalesforceCaseCreate'|'OnContactEvaluationSubmit'|'OnMetricDataUpdate'|'OnCaseCreate'|'OnCaseUpdate',
'IntegrationAssociationId': 'string'
},
'Function': 'string',
'Actions': [
{
'ActionType': 'CREATE_TASK'|'ASSIGN_CONTACT_CATEGORY'|'GENERATE_EVENTBRIDGE_EVENT'|'SEND_NOTIFICATION'|'CREATE_CASE'|'UPDATE_CASE'|'END_ASSOCIATED_TASKS'|'SUBMIT_AUTO_EVALUATION',
'TaskAction': {
'Name': 'string',
'Description': 'string',
'ContactFlowId': 'string',
'References': {
'string': {
'Value': 'string',
'Type': 'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string',
'StatusReason': 'string'
}
}
},
'EventBridgeAction': {
'Name': 'string'
},
'AssignContactCategoryAction': {},
'SendNotificationAction': {
'DeliveryMethod': 'EMAIL',
'Subject': 'string',
'Content': 'string',
'ContentType': 'PLAIN_TEXT',
'Recipient': {
'UserTags': {
'string': 'string'
},
'UserIds': [
'string',
]
}
},
'CreateCaseAction': {
'Fields': [
{
'Id': 'string',
'Value': {
'BooleanValue': True|False,
'DoubleValue': 123.0,
'EmptyValue': {},
'StringValue': 'string'
}
},
],
'TemplateId': 'string'
},
'UpdateCaseAction': {
'Fields': [
{
'Id': 'string',
'Value': {
'BooleanValue': True|False,
'DoubleValue': 123.0,
'EmptyValue': {},
'StringValue': 'string'
}
},
]
},
'EndAssociatedTasksAction': {},
'SubmitAutoEvaluationAction': {
'EvaluationFormId': 'string'
}
},
],
'PublishStatus': 'DRAFT'|'PUBLISHED',
'CreatedTime': datetime(2015, 1, 1),
'LastUpdatedTime': datetime(2015, 1, 1),
'LastUpdatedBy': 'string',
'Tags': {
'string': 'string'
}
}
}
Response Structure
(dict) --
Rule (dict) --
Information about the rule.
Name (string) --
The name of the rule.
RuleId (string) --
A unique identifier for the rule.
RuleArn (string) --
The Amazon Resource Name (ARN) of the rule.
TriggerEventSource (dict) --
The event source to trigger the rule.
EventSourceName (string) --
The name of the event source.
IntegrationAssociationId (string) --
The identifier for the integration association.
Function (string) --
The conditions of the rule.
Actions (list) --
A list of actions to be run when the rule is triggered.
(dict) --
Information about the action to be performed when a rule is triggered.
ActionType (string) --
The type of action that creates a rule.
TaskAction (dict) --
Information about the task action. This field is required if TriggerEventSource is one of the following values: OnZendeskTicketCreate | OnZendeskTicketStatusUpdate | OnSalesforceCaseCreate
Name (string) --
The name. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
Description (string) --
The description. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
ContactFlowId (string) --
The identifier of the flow.
References (dict) --
Information about the reference when the referenceType is URL. Otherwise, null. (Supports variable injection in the Value field.)
(string) --
(dict) --
Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.
Value (string) --
A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).
Type (string) --
The type of the reference. DATE must be of type Epoch timestamp.
Status (string) --
Arn (string) --
StatusReason (string) --
EventBridgeAction (dict) --
Information about the EventBridge action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnContactEvaluationSubmit | OnMetricDataUpdate
Name (string) --
The name.
AssignContactCategoryAction (dict) --
Information about the contact category action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnZendeskTicketCreate | OnZendeskTicketStatusUpdate | OnSalesforceCaseCreate
SendNotificationAction (dict) --
Information about the send notification action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnContactEvaluationSubmit | OnMetricDataUpdate
DeliveryMethod (string) --
Notification delivery method.
Subject (string) --
The subject of the email if the delivery method is EMAIL. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
Content (string) --
Notification content. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
ContentType (string) --
Content type format.
Recipient (dict) --
Notification recipient.
UserTags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }. Amazon Connect users with the specified tags will be notified.
(string) --
(string) --
UserIds (list) --
A list of user IDs.
(string) --
CreateCaseAction (dict) --
Information about the create case action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnPostChatAnalysisAvailable.
Fields (list) --
An array of objects with Field ID and Value data.
(dict) --
Object for case field values.
Id (string) --
Unique identifier of a field.
Value (dict) --
Union of potential field value types.
BooleanValue (boolean) --
A Boolean number value type.
DoubleValue (float) --
A Double number value type.
EmptyValue (dict) --
An empty value.
StringValue (string) --
String value type.
TemplateId (string) --
A unique identifier of a template.
UpdateCaseAction (dict) --
Information about the update case action.
Supported only for TriggerEventSource values: OnCaseCreate | OnCaseUpdate.
Fields (list) --
An array of objects with Field ID and Value data.
(dict) --
Object for case field values.
Id (string) --
Unique identifier of a field.
Value (dict) --
Union of potential field value types.
BooleanValue (boolean) --
A Boolean number value type.
DoubleValue (float) --
A Double number value type.
EmptyValue (dict) --
An empty value.
StringValue (string) --
String value type.
EndAssociatedTasksAction (dict) --
Information about the end associated tasks action.
Supported only for TriggerEventSource values: OnCaseUpdate.
SubmitAutoEvaluationAction (dict) --
Information about the submit automated evaluation action.
EvaluationFormId (string) --
The identifier of the auto-evaluation enabled form.
PublishStatus (string) --
The publish status of the rule.
CreatedTime (datetime) --
The timestamp for when the rule was created.
LastUpdatedTime (datetime) --
The timestamp for the when the rule was last updated.
LastUpdatedBy (string) --
The Amazon Resource Name (ARN) of the user who last updated the rule.
Tags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
{'ResourceType': {'OUTBOUND_EMAIL', 'INBOUND_EMAIL'}}
Disassociates a connect resource from a flow.
See also: AWS API Documentation
Request Syntax
client.disassociate_flow(
InstanceId='string',
ResourceId='string',
ResourceType='SMS_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the resource.
string
[REQUIRED]
A valid resource type.
dict
Response Syntax
{}
Response Structure
(dict) --
{'ResourceType': {'EMAIL_MESSAGES'}}
This 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.
See also: AWS API Documentation
Request Syntax
client.disassociate_instance_storage_config(
InstanceId='string',
AssociationId='string',
ResourceType='CHAT_TRANSCRIPTS'|'CALL_RECORDINGS'|'SCHEDULED_REPORTS'|'MEDIA_STREAMS'|'CONTACT_TRACE_RECORDS'|'AGENT_EVENTS'|'REAL_TIME_CONTACT_ANALYSIS_SEGMENTS'|'ATTACHMENTS'|'CONTACT_EVALUATIONS'|'SCREEN_RECORDINGS'|'REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS'|'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS'|'EMAIL_MESSAGES'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The existing association identifier that uniquely identifies the resource type and storage config for the given instance ID.
string
[REQUIRED]
A valid resource type.
None
{'QueueReferences': {'Channel': {'EMAIL'}}}
Disassociates a set of queues from a routing profile.
See also: AWS API Documentation
Request Syntax
client.disassociate_routing_profile_queues(
InstanceId='string',
RoutingProfileId='string',
QueueReferences=[
{
'QueueId': 'string',
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL'
},
]
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the routing profile.
list
[REQUIRED]
The queues to disassociate from this routing profile.
(dict) --
Contains the channel and queue identifier for a routing profile.
QueueId (string) -- [REQUIRED]
The identifier for the queue.
Channel (string) -- [REQUIRED]
The channels agents can handle in the Contact Control Panel (CCP) for this routing profile.
None
{'FileUseCaseType': {'EMAIL_MESSAGE'}}
Provides a pre-signed URL for download of an approved attached file. This API also returns metadata about the attached file. It will only return a downloadURL if the status of the attached file is APPROVED.
See also: AWS API Documentation
Request Syntax
client.get_attached_file(
InstanceId='string',
FileId='string',
UrlExpiryInSeconds=123,
AssociatedResourceArn='string'
)
string
[REQUIRED]
The unique identifier of the Connect instance.
string
[REQUIRED]
The unique identifier of the attached file resource.
integer
Optional override for the expiry of the pre-signed S3 URL in seconds. The default value is 300.
string
[REQUIRED]
The resource to which the attached file is (being) uploaded to. Cases are the only current supported resource.
dict
Response Syntax
{
'FileArn': 'string',
'FileId': 'string',
'CreationTime': 'string',
'FileStatus': 'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'FileName': 'string',
'FileSizeInBytes': 123,
'AssociatedResourceArn': 'string',
'FileUseCaseType': 'EMAIL_MESSAGE'|'ATTACHMENT',
'CreatedBy': {
'ConnectUserArn': 'string',
'AWSIdentityArn': 'string'
},
'DownloadUrlMetadata': {
'Url': 'string',
'UrlExpiry': 'string'
},
'Tags': {
'string': 'string'
}
}
Response Structure
(dict) -- Response from GetAttachedFile API.
FileArn (string) --
The unique identifier of the attached file resource (ARN).
FileId (string) --
The unique identifier of the attached file resource.
CreationTime (string) --
The time of Creation of the file resource as an ISO timestamp. It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2024-05-03T02:41:28.172Z.
FileStatus (string) --
The current status of the attached file.
FileName (string) --
A case-sensitive name of the attached file being uploaded.
FileSizeInBytes (integer) --
The size of the attached file in bytes.
AssociatedResourceArn (string) --
The resource to which the attached file is (being) uploaded to. Cases are the only current supported resource.
FileUseCaseType (string) --
The use case for the file.
CreatedBy (dict) --
Represents the identity that created the file.
ConnectUserArn (string) --
An agent ARN representing a connect user.
AWSIdentityArn (string) --
STS or IAM ARN representing the identity of API Caller. SDK users cannot populate this and this value is calculated automatically if ConnectUserArn is not provided.
DownloadUrlMetadata (dict) --
URL and expiry to be used when downloading the attached file.
Url (string) --
A pre-signed URL that should be used to download the attached file.
UrlExpiry (string) --
The expiration time of the URL in ISO timestamp. It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.
Tags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
{'Filters': {'Channels': {'EMAIL'}}}
Response {'MetricResults': {'Dimensions': {'Channel': {'EMAIL'}}}}
Gets 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.
See also: AWS API Documentation
Request Syntax
client.get_current_metric_data(
InstanceId='string',
Filters={
'Queues': [
'string',
],
'Channels': [
'VOICE'|'CHAT'|'TASK'|'EMAIL',
],
'RoutingProfiles': [
'string',
],
'RoutingStepExpressions': [
'string',
]
},
Groupings=[
'QUEUE'|'CHANNEL'|'ROUTING_PROFILE'|'ROUTING_STEP_EXPRESSION',
],
CurrentMetrics=[
{
'Name': 'AGENTS_ONLINE'|'AGENTS_AVAILABLE'|'AGENTS_ON_CALL'|'AGENTS_NON_PRODUCTIVE'|'AGENTS_AFTER_CONTACT_WORK'|'AGENTS_ERROR'|'AGENTS_STAFFED'|'CONTACTS_IN_QUEUE'|'OLDEST_CONTACT_AGE'|'CONTACTS_SCHEDULED'|'AGENTS_ON_CONTACT'|'SLOTS_ACTIVE'|'SLOTS_AVAILABLE',
'Unit': 'SECONDS'|'COUNT'|'PERCENT'
},
],
NextToken='string',
MaxResults=123,
SortCriteria=[
{
'SortByMetric': 'AGENTS_ONLINE'|'AGENTS_AVAILABLE'|'AGENTS_ON_CALL'|'AGENTS_NON_PRODUCTIVE'|'AGENTS_AFTER_CONTACT_WORK'|'AGENTS_ERROR'|'AGENTS_STAFFED'|'CONTACTS_IN_QUEUE'|'OLDEST_CONTACT_AGE'|'CONTACTS_SCHEDULED'|'AGENTS_ON_CONTACT'|'SLOTS_ACTIVE'|'SLOTS_AVAILABLE',
'SortOrder': 'ASCENDING'|'DESCENDING'
},
]
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
dict
[REQUIRED]
The filters to apply to returned metrics. You can filter up to the following limits:
Queues: 100
Routing profiles: 100
Channels: 3 (VOICE, CHAT, and TASK channels are supported.)
RoutingStepExpressions: 50
Metric data is retrieved only for the resources associated with the queues or routing profiles, and by any channels included in the filter. (You cannot filter by both queue AND routing profile.) You can include both resource IDs and resource ARNs in the same request.
When using the RoutingStepExpression filter, you need to pass exactly one QueueId. The filter is also case sensitive so when using the RoutingStepExpression filter, grouping by ROUTING_STEP_EXPRESSION is required.
Currently tagging is only supported on the resources that are passed in the filter.
Queues (list) --
The queues to use to filter the metrics. You should specify at least one queue, and can specify up to 100 queues per request. The GetCurrentMetricsData API in particular requires a queue when you include a Filter in your request.
(string) --
Channels (list) --
The channel to use to filter the metrics.
(string) --
RoutingProfiles (list) --
A list of up to 100 routing profile IDs or ARNs.
(string) --
RoutingStepExpressions (list) --
A list of expressions as a filter, in which an expression is an object of a step in a routing criteria.
(string) --
list
The grouping applied to the metrics returned. For example, when grouped by QUEUE, the metrics returned apply to each queue rather than aggregated for all queues.
If you group by CHANNEL, you should include a Channels filter. VOICE, CHAT, and TASK channels are supported.
If you group by ROUTING_PROFILE, you must include either a queue or routing profile filter. In addition, a routing profile filter is required for metrics CONTACTS_SCHEDULED, CONTACTS_IN_QUEUE, and OLDEST_CONTACT_AGE.
If no Grouping is included in the request, a summary of metrics is returned.
When using the RoutingStepExpression filter, group by ROUTING_STEP_EXPRESSION is required.
(string) --
list
[REQUIRED]
The metrics to retrieve. Specify the name and unit for each metric. The following metrics are available. For a description of all the metrics, see Real-time Metrics Definitions in the Amazon Connect Administrator Guide.
AGENTS_AFTER_CONTACT_WORK
Unit: COUNT
Name in real-time metrics report: ACW
AGENTS_AVAILABLE
Unit: COUNT
Name in real-time metrics report: Available
AGENTS_ERROR
Unit: COUNT
Name in real-time metrics report: Error
AGENTS_NON_PRODUCTIVE
Unit: COUNT
Name in real-time metrics report: NPT (Non-Productive Time)
AGENTS_ON_CALL
Unit: COUNT
Name in real-time metrics report: On contact
AGENTS_ON_CONTACT
Unit: COUNT
Name in real-time metrics report: On contact
AGENTS_ONLINE
Unit: COUNT
Name in real-time metrics report: Online
AGENTS_STAFFED
Unit: COUNT
Name in real-time metrics report: Staffed
CONTACTS_IN_QUEUE
Unit: COUNT
Name in real-time metrics report: In queue
CONTACTS_SCHEDULED
Unit: COUNT
Name in real-time metrics report: Scheduled
OLDEST_CONTACT_AGE
Unit: SECONDS
When you use groupings, Unit says SECONDS and the Value is returned in SECONDS.
When you do not use groupings, Unit says SECONDS but the Value is returned in MILLISECONDS. For example, if you get a response like this:
``{ "Metric": { "Name": "OLDEST_CONTACT_AGE", "Unit": "SECONDS" }, "Value": 24113.0 ``}
The actual OLDEST_CONTACT_AGE is 24 seconds.
When the filter RoutingStepExpression is used, this metric is still calculated from enqueue time. For example, if a contact that has been queued under <Expression 1> for 10 seconds has expired and <Expression 2> becomes active, then OLDEST_CONTACT_AGE for this queue will be counted starting from 10, not 0.
Name in real-time metrics report: Oldest
SLOTS_ACTIVE
Unit: COUNT
Name in real-time metrics report: Active
SLOTS_AVAILABLE
Unit: COUNT
Name in real-time metrics report: Availability
(dict) --
Contains information about a real-time metric. For a description of each metric, see Real-time Metrics Definitions in the Amazon Connect Administrator Guide.
Name (string) --
The name of the metric.
Unit (string) --
The unit for the metric.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
The token expires after 5 minutes from the time it is created. Subsequent requests that use the token must use the same request parameters as the request that generated the token.
integer
The maximum number of results to return per page.
list
The way to sort the resulting response based on metrics. You can enter one sort criteria. By default resources are sorted based on AGENTS_ONLINE, DESCENDING. The metric collection is sorted based on the input metrics.
Note the following:
Sorting on SLOTS_ACTIVE and SLOTS_AVAILABLE is not supported.
(dict) --
The way to sort the resulting response based on metrics. By default resources are sorted based on AGENTS_ONLINE, DESCENDING. The metric collection is sorted based on the input metrics.
SortByMetric (string) --
The current metric names.
SortOrder (string) --
The way to sort.
dict
Response Syntax
{
'NextToken': 'string',
'MetricResults': [
{
'Dimensions': {
'Queue': {
'Id': 'string',
'Arn': 'string'
},
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL',
'RoutingProfile': {
'Id': 'string',
'Arn': 'string'
},
'RoutingStepExpression': 'string'
},
'Collections': [
{
'Metric': {
'Name': 'AGENTS_ONLINE'|'AGENTS_AVAILABLE'|'AGENTS_ON_CALL'|'AGENTS_NON_PRODUCTIVE'|'AGENTS_AFTER_CONTACT_WORK'|'AGENTS_ERROR'|'AGENTS_STAFFED'|'CONTACTS_IN_QUEUE'|'OLDEST_CONTACT_AGE'|'CONTACTS_SCHEDULED'|'AGENTS_ON_CONTACT'|'SLOTS_ACTIVE'|'SLOTS_AVAILABLE',
'Unit': 'SECONDS'|'COUNT'|'PERCENT'
},
'Value': 123.0
},
]
},
],
'DataSnapshotTime': datetime(2015, 1, 1),
'ApproximateTotalCount': 123
}
Response Structure
(dict) --
NextToken (string) --
If there are additional results, this is the token for the next set of results.
The token expires after 5 minutes from the time it is created. Subsequent requests that use the token must use the same request parameters as the request that generated the token.
MetricResults (list) --
Information about the real-time metrics.
(dict) --
Contains information about a set of real-time metrics.
Dimensions (dict) --
The dimensions for the metrics.
Queue (dict) --
Information about the queue for which metrics are returned.
Id (string) --
The identifier of the queue.
Arn (string) --
The Amazon Resource Name (ARN) of the queue.
Channel (string) --
The channel used for grouping and filters.
RoutingProfile (dict) --
Information about the routing profile assigned to the user.
Id (string) --
The identifier of the routing profile.
Arn (string) --
The Amazon Resource Name (ARN) of the routing profile.
RoutingStepExpression (string) --
The expression of a step in a routing criteria.
Collections (list) --
The set of metrics.
(dict) --
Contains the data for a real-time metric.
Metric (dict) --
Information about the metric.
Name (string) --
The name of the metric.
Unit (string) --
The unit for the metric.
Value (float) --
The value of the metric.
DataSnapshotTime (datetime) --
The time at which the metrics were retrieved and cached for pagination.
ApproximateTotalCount (integer) --
The total count of the result, regardless of the current page size.
{'UserDataList': {'Contacts': {'Channel': {'EMAIL'},
'InitiationMethod': {'AGENT_REPLY',
'FLOW',
'WEBRTC_API'}}}}
Gets the real-time active user data from the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.get_current_user_data(
InstanceId='string',
Filters={
'Queues': [
'string',
],
'ContactFilter': {
'ContactStates': [
'INCOMING'|'PENDING'|'CONNECTING'|'CONNECTED'|'CONNECTED_ONHOLD'|'MISSED'|'ERROR'|'ENDED'|'REJECTED',
]
},
'RoutingProfiles': [
'string',
],
'Agents': [
'string',
],
'UserHierarchyGroups': [
'string',
]
},
NextToken='string',
MaxResults=123
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
dict
[REQUIRED]
The filters to apply to returned user data. You can filter up to the following limits:
Queues: 100
Routing profiles: 100
Agents: 100
Contact states: 9
User hierarchy groups: 1
The user data is retrieved for only the specified values/resources in the filter. A maximum of one filter can be passed from queues, routing profiles, agents, and user hierarchy groups.
Currently tagging is only supported on the resources that are passed in the filter.
Queues (list) --
A list of up to 100 queues or ARNs.
(string) --
ContactFilter (dict) --
A filter for the user data based on the contact information that is associated to the user. It contains a list of contact states.
ContactStates (list) --
A list of up to 9 contact states.
(string) --
RoutingProfiles (list) --
A list of up to 100 routing profile IDs or ARNs.
(string) --
Agents (list) --
A list of up to 100 agent IDs or ARNs.
(string) --
UserHierarchyGroups (list) --
A UserHierarchyGroup ID or ARN.
(string) --
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
integer
The maximum number of results to return per page.
dict
Response Syntax
{
'NextToken': 'string',
'UserDataList': [
{
'User': {
'Id': 'string',
'Arn': 'string'
},
'RoutingProfile': {
'Id': 'string',
'Arn': 'string'
},
'HierarchyPath': {
'LevelOne': {
'Id': 'string',
'Arn': 'string'
},
'LevelTwo': {
'Id': 'string',
'Arn': 'string'
},
'LevelThree': {
'Id': 'string',
'Arn': 'string'
},
'LevelFour': {
'Id': 'string',
'Arn': 'string'
},
'LevelFive': {
'Id': 'string',
'Arn': 'string'
}
},
'Status': {
'StatusStartTimestamp': datetime(2015, 1, 1),
'StatusArn': 'string',
'StatusName': 'string'
},
'AvailableSlotsByChannel': {
'string': 123
},
'MaxSlotsByChannel': {
'string': 123
},
'ActiveSlotsByChannel': {
'string': 123
},
'Contacts': [
{
'ContactId': 'string',
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL',
'InitiationMethod': 'INBOUND'|'OUTBOUND'|'TRANSFER'|'QUEUE_TRANSFER'|'CALLBACK'|'API'|'DISCONNECT'|'MONITOR'|'EXTERNAL_OUTBOUND'|'WEBRTC_API'|'AGENT_REPLY'|'FLOW',
'AgentContactState': 'INCOMING'|'PENDING'|'CONNECTING'|'CONNECTED'|'CONNECTED_ONHOLD'|'MISSED'|'ERROR'|'ENDED'|'REJECTED',
'StateStartTimestamp': datetime(2015, 1, 1),
'ConnectedToAgentTimestamp': datetime(2015, 1, 1),
'Queue': {
'Id': 'string',
'Arn': 'string'
}
},
],
'NextStatus': 'string'
},
],
'ApproximateTotalCount': 123
}
Response Structure
(dict) --
NextToken (string) --
If there are additional results, this is the token for the next set of results.
UserDataList (list) --
A list of the user data that is returned.
(dict) --
Data for a user.
User (dict) --
Information about the user for the data that is returned. It contains the resourceId and ARN of the user.
Id (string) --
The unique identifier for the user.
Arn (string) --
The Amazon Resource Name (ARN) for the user.
RoutingProfile (dict) --
Information about the routing profile that is assigned to the user.
Id (string) --
The identifier of the routing profile.
Arn (string) --
The Amazon Resource Name (ARN) of the routing profile.
HierarchyPath (dict) --
Contains information about the levels of a hierarchy group assigned to a user.
LevelOne (dict) --
Information about level one.
Id (string) --
The unique identifier for the hierarchy group.
Arn (string) --
The Amazon Resource Name (ARN) for the hierarchy group.
LevelTwo (dict) --
Information about level two.
Id (string) --
The unique identifier for the hierarchy group.
Arn (string) --
The Amazon Resource Name (ARN) for the hierarchy group.
LevelThree (dict) --
Information about level three.
Id (string) --
The unique identifier for the hierarchy group.
Arn (string) --
The Amazon Resource Name (ARN) for the hierarchy group.
LevelFour (dict) --
Information about level four.
Id (string) --
The unique identifier for the hierarchy group.
Arn (string) --
The Amazon Resource Name (ARN) for the hierarchy group.
LevelFive (dict) --
Information about level five.
Id (string) --
The unique identifier for the hierarchy group.
Arn (string) --
The Amazon Resource Name (ARN) for the hierarchy group.
Status (dict) --
The status of the agent that they manually set in their Contact Control Panel (CCP), or that the supervisor manually changes in the real-time metrics report.
StatusStartTimestamp (datetime) --
The start timestamp of the agent's status.
StatusArn (string) --
The Amazon Resource Name (ARN) of the agent's status.
StatusName (string) --
The name of the agent status.
AvailableSlotsByChannel (dict) --
A map of available slots by channel. The key is a channel name. The value is an integer: the available number of slots.
(string) --
(integer) --
MaxSlotsByChannel (dict) --
A map of maximum slots by channel. The key is a channel name. The value is an integer: the maximum number of slots. This is calculated from MediaConcurrency of the RoutingProfile assigned to the agent.
(string) --
(integer) --
ActiveSlotsByChannel (dict) --
A map of active slots by channel. The key is a channel name. The value is an integer: the number of active slots.
(string) --
(integer) --
Contacts (list) --
A list of contact reference information.
(dict) --
Information about the contact associated to the user.
ContactId (string) --
The identifier of the contact in this instance of Amazon Connect.
Channel (string) --
The channel of the contact.
InitiationMethod (string) --
How the contact was initiated.
AgentContactState (string) --
The state of the contact.
StateStartTimestamp (datetime) --
The epoch timestamp when the contact state started.
ConnectedToAgentTimestamp (datetime) --
The time at which the contact was connected to an agent.
Queue (dict) --
Contains information about a queue resource for which metrics are returned.
Id (string) --
The identifier of the queue.
Arn (string) --
The Amazon Resource Name (ARN) of the queue.
NextStatus (string) --
The Next status of the agent.
ApproximateTotalCount (integer) --
The total count of the result, regardless of the current page size.
{'ResourceType': {'OUTBOUND_EMAIL', 'INBOUND_EMAIL'}}
Retrieves the flow associated for a given resource.
See also: AWS API Documentation
Request Syntax
client.get_flow_association(
InstanceId='string',
ResourceId='string',
ResourceType='SMS_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the resource.
string
[REQUIRED]
A valid resource type.
dict
Response Syntax
{
'ResourceId': 'string',
'FlowId': 'string',
'ResourceType': 'SMS_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'
}
Response Structure
(dict) --
ResourceId (string) --
The identifier of the resource.
FlowId (string) --
The identifier of the flow.
ResourceType (string) --
A valid resource type.
{'Filters': {'Channels': {'EMAIL'}}}
Response {'MetricResults': {'Dimensions': {'Channel': {'EMAIL'}}}}
Gets 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.
See also: AWS API Documentation
Request Syntax
client.get_metric_data(
InstanceId='string',
StartTime=datetime(2015, 1, 1),
EndTime=datetime(2015, 1, 1),
Filters={
'Queues': [
'string',
],
'Channels': [
'VOICE'|'CHAT'|'TASK'|'EMAIL',
],
'RoutingProfiles': [
'string',
],
'RoutingStepExpressions': [
'string',
]
},
Groupings=[
'QUEUE'|'CHANNEL'|'ROUTING_PROFILE'|'ROUTING_STEP_EXPRESSION',
],
HistoricalMetrics=[
{
'Name': 'CONTACTS_QUEUED'|'CONTACTS_HANDLED'|'CONTACTS_ABANDONED'|'CONTACTS_CONSULTED'|'CONTACTS_AGENT_HUNG_UP_FIRST'|'CONTACTS_HANDLED_INCOMING'|'CONTACTS_HANDLED_OUTBOUND'|'CONTACTS_HOLD_ABANDONS'|'CONTACTS_TRANSFERRED_IN'|'CONTACTS_TRANSFERRED_OUT'|'CONTACTS_TRANSFERRED_IN_FROM_QUEUE'|'CONTACTS_TRANSFERRED_OUT_FROM_QUEUE'|'CONTACTS_MISSED'|'CALLBACK_CONTACTS_HANDLED'|'API_CONTACTS_HANDLED'|'OCCUPANCY'|'HANDLE_TIME'|'AFTER_CONTACT_WORK_TIME'|'QUEUED_TIME'|'ABANDON_TIME'|'QUEUE_ANSWER_TIME'|'HOLD_TIME'|'INTERACTION_TIME'|'INTERACTION_AND_HOLD_TIME'|'SERVICE_LEVEL',
'Threshold': {
'Comparison': 'LT',
'ThresholdValue': 123.0
},
'Statistic': 'SUM'|'MAX'|'AVG',
'Unit': 'SECONDS'|'COUNT'|'PERCENT'
},
],
NextToken='string',
MaxResults=123
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
datetime
[REQUIRED]
The timestamp, in UNIX Epoch time format, at which to start the reporting interval for the retrieval of historical metrics data. The time must be specified using a multiple of 5 minutes, such as 10:05, 10:10, 10:15.
The start time cannot be earlier than 24 hours before the time of the request. Historical metrics are available only for 24 hours.
datetime
[REQUIRED]
The timestamp, in UNIX Epoch time format, at which to end the reporting interval for the retrieval of historical metrics data. The time must be specified using an interval of 5 minutes, such as 11:00, 11:05, 11:10, and must be later than the start time timestamp.
The time range between the start and end time must be less than 24 hours.
dict
[REQUIRED]
The queues, up to 100, or channels, to use to filter the metrics returned. Metric data is retrieved only for the resources associated with the queues or channels included in the filter. You can include both queue IDs and queue ARNs in the same request. VOICE, CHAT, and TASK channels are supported.
RoutingStepExpression is not a valid filter for GetMetricData and we recommend switching to GetMetricDataV2 for more up-to-date features.
Queues (list) --
The queues to use to filter the metrics. You should specify at least one queue, and can specify up to 100 queues per request. The GetCurrentMetricsData API in particular requires a queue when you include a Filter in your request.
(string) --
Channels (list) --
The channel to use to filter the metrics.
(string) --
RoutingProfiles (list) --
A list of up to 100 routing profile IDs or ARNs.
(string) --
RoutingStepExpressions (list) --
A list of expressions as a filter, in which an expression is an object of a step in a routing criteria.
(string) --
list
The grouping applied to the metrics returned. For example, when results are grouped by queue, the metrics returned are grouped by queue. The values returned apply to the metrics for each queue rather than aggregated for all queues.
If no grouping is specified, a summary of metrics for all queues is returned.
RoutingStepExpression is not a valid filter for GetMetricData and we recommend switching to GetMetricDataV2 for more up-to-date features.
(string) --
list
[REQUIRED]
The metrics to retrieve. Specify the name, unit, and statistic for each metric. The following historical metrics are available. For a description of each metric, see Historical Metrics Definitions in the Amazon Connect Administrator Guide.
Unit: SECONDS
Statistic: AVG
AFTER_CONTACT_WORK_TIME
Unit: SECONDS
Statistic: AVG
API_CONTACTS_HANDLED
Unit: COUNT
Statistic: SUM
CALLBACK_CONTACTS_HANDLED
Unit: COUNT
Statistic: SUM
CONTACTS_ABANDONED
Unit: COUNT
Statistic: SUM
CONTACTS_AGENT_HUNG_UP_FIRST
Unit: COUNT
Statistic: SUM
CONTACTS_CONSULTED
Unit: COUNT
Statistic: SUM
CONTACTS_HANDLED
Unit: COUNT
Statistic: SUM
CONTACTS_HANDLED_INCOMING
Unit: COUNT
Statistic: SUM
CONTACTS_HANDLED_OUTBOUND
Unit: COUNT
Statistic: SUM
CONTACTS_HOLD_ABANDONS
Unit: COUNT
Statistic: SUM
CONTACTS_MISSED
Unit: COUNT
Statistic: SUM
CONTACTS_QUEUED
Unit: COUNT
Statistic: SUM
CONTACTS_TRANSFERRED_IN
Unit: COUNT
Statistic: SUM
CONTACTS_TRANSFERRED_IN_FROM_QUEUE
Unit: COUNT
Statistic: SUM
CONTACTS_TRANSFERRED_OUT
Unit: COUNT
Statistic: SUM
CONTACTS_TRANSFERRED_OUT_FROM_QUEUE
Unit: COUNT
Statistic: SUM
HANDLE_TIME
Unit: SECONDS
Statistic: AVG
HOLD_TIME
Unit: SECONDS
Statistic: AVG
INTERACTION_AND_HOLD_TIME
Unit: SECONDS
Statistic: AVG
INTERACTION_TIME
Unit: SECONDS
Statistic: AVG
OCCUPANCY
Unit: PERCENT
Statistic: AVG
QUEUE_ANSWER_TIME
Unit: SECONDS
Statistic: AVG
QUEUED_TIME
Unit: SECONDS
Statistic: MAX
SERVICE_LEVEL
You can include up to 20 SERVICE_LEVEL metrics in a request.
Unit: PERCENT
Statistic: AVG
Threshold: For ThresholdValue, enter any whole number from 1 to 604800 (inclusive), in seconds. For Comparison, you must enter LT (for "Less than").
(dict) --
Contains information about a historical metric. For a description of each metric, see Historical Metrics Definitions in the Amazon Connect Administrator Guide.
Name (string) --
The name of the metric.
Threshold (dict) --
The threshold for the metric, used with service level metrics.
Comparison (string) --
The type of comparison. Only "less than" (LT) comparisons are supported.
ThresholdValue (float) --
The threshold value to compare.
Statistic (string) --
The statistic for the metric.
Unit (string) --
The unit for the metric.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
integer
The maximum number of results to return per page.
dict
Response Syntax
{
'NextToken': 'string',
'MetricResults': [
{
'Dimensions': {
'Queue': {
'Id': 'string',
'Arn': 'string'
},
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL',
'RoutingProfile': {
'Id': 'string',
'Arn': 'string'
},
'RoutingStepExpression': 'string'
},
'Collections': [
{
'Metric': {
'Name': 'CONTACTS_QUEUED'|'CONTACTS_HANDLED'|'CONTACTS_ABANDONED'|'CONTACTS_CONSULTED'|'CONTACTS_AGENT_HUNG_UP_FIRST'|'CONTACTS_HANDLED_INCOMING'|'CONTACTS_HANDLED_OUTBOUND'|'CONTACTS_HOLD_ABANDONS'|'CONTACTS_TRANSFERRED_IN'|'CONTACTS_TRANSFERRED_OUT'|'CONTACTS_TRANSFERRED_IN_FROM_QUEUE'|'CONTACTS_TRANSFERRED_OUT_FROM_QUEUE'|'CONTACTS_MISSED'|'CALLBACK_CONTACTS_HANDLED'|'API_CONTACTS_HANDLED'|'OCCUPANCY'|'HANDLE_TIME'|'AFTER_CONTACT_WORK_TIME'|'QUEUED_TIME'|'ABANDON_TIME'|'QUEUE_ANSWER_TIME'|'HOLD_TIME'|'INTERACTION_TIME'|'INTERACTION_AND_HOLD_TIME'|'SERVICE_LEVEL',
'Threshold': {
'Comparison': 'LT',
'ThresholdValue': 123.0
},
'Statistic': 'SUM'|'MAX'|'AVG',
'Unit': 'SECONDS'|'COUNT'|'PERCENT'
},
'Value': 123.0
},
]
},
]
}
Response Structure
(dict) --
NextToken (string) --
If there are additional results, this is the token for the next set of results.
The token expires after 5 minutes from the time it is created. Subsequent requests that use the token must use the same request parameters as the request that generated the token.
MetricResults (list) --
Information about the historical metrics.
If no grouping is specified, a summary of metric data is returned.
(dict) --
Contains information about the historical metrics retrieved.
Dimensions (dict) --
The dimension for the metrics.
Queue (dict) --
Information about the queue for which metrics are returned.
Id (string) --
The identifier of the queue.
Arn (string) --
The Amazon Resource Name (ARN) of the queue.
Channel (string) --
The channel used for grouping and filters.
RoutingProfile (dict) --
Information about the routing profile assigned to the user.
Id (string) --
The identifier of the routing profile.
Arn (string) --
The Amazon Resource Name (ARN) of the routing profile.
RoutingStepExpression (string) --
The expression of a step in a routing criteria.
Collections (list) --
The set of metrics.
(dict) --
Contains the data for a historical metric.
Metric (dict) --
Information about the metric.
Name (string) --
The name of the metric.
Threshold (dict) --
The threshold for the metric, used with service level metrics.
Comparison (string) --
The type of comparison. Only "less than" (LT) comparisons are supported.
ThresholdValue (float) --
The threshold value to compare.
Statistic (string) --
The statistic for the metric.
Unit (string) --
The unit for the metric.
Value (float) --
The value of the metric.
{'Fields': {'Type': {'EXPIRY_DURATION', 'SELF_ASSIGN'}},
'SelfAssignFlowId': 'string'}
Gets details about a specific task template in the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.get_task_template(
InstanceId='string',
TaskTemplateId='string',
SnapshotVersion='string'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
A unique identifier for the task template.
string
The system generated version of a task template that is associated with a task, when the task is created.
dict
Response Syntax
{
'InstanceId': 'string',
'Id': 'string',
'Arn': 'string',
'Name': 'string',
'Description': 'string',
'ContactFlowId': 'string',
'SelfAssignFlowId': 'string',
'Constraints': {
'RequiredFields': [
{
'Id': {
'Name': 'string'
}
},
],
'ReadOnlyFields': [
{
'Id': {
'Name': 'string'
}
},
],
'InvisibleFields': [
{
'Id': {
'Name': 'string'
}
},
]
},
'Defaults': {
'DefaultFieldValues': [
{
'Id': {
'Name': 'string'
},
'DefaultValue': 'string'
},
]
},
'Fields': [
{
'Id': {
'Name': 'string'
},
'Description': 'string',
'Type': 'NAME'|'DESCRIPTION'|'SCHEDULED_TIME'|'QUICK_CONNECT'|'URL'|'NUMBER'|'TEXT'|'TEXT_AREA'|'DATE_TIME'|'BOOLEAN'|'SINGLE_SELECT'|'EMAIL'|'SELF_ASSIGN'|'EXPIRY_DURATION',
'SingleSelectOptions': [
'string',
]
},
],
'Status': 'ACTIVE'|'INACTIVE',
'LastModifiedTime': datetime(2015, 1, 1),
'CreatedTime': datetime(2015, 1, 1),
'Tags': {
'string': 'string'
}
}
Response Structure
(dict) --
InstanceId (string) --
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
Id (string) --
A unique identifier for the task template.
Arn (string) --
The Amazon Resource Name (ARN).
Name (string) --
The name of the task template.
Description (string) --
The description of the task template.
ContactFlowId (string) --
The identifier of the flow that runs by default when a task is created by referencing this template.
SelfAssignFlowId (string) --
Constraints (dict) --
Constraints that are applicable to the fields listed.
RequiredFields (list) --
Lists the fields that are required to be filled by agents.
(dict) --
Information about a required field.
Id (dict) --
The unique identifier for the field.
Name (string) --
The name of the task template field.
ReadOnlyFields (list) --
Lists the fields that are read-only to agents, and cannot be edited.
(dict) --
Indicates a field that is read-only to an agent.
Id (dict) --
Identifier of the read-only field.
Name (string) --
The name of the task template field.
InvisibleFields (list) --
Lists the fields that are invisible to agents.
(dict) --
A field that is invisible to an agent.
Id (dict) --
Identifier of the invisible field.
Name (string) --
The name of the task template field.
Defaults (dict) --
The default values for fields when a task is created by referencing this template.
DefaultFieldValues (list) --
Default value for the field.
(dict) --
Describes a default field and its corresponding value.
Id (dict) --
Identifier of a field.
Name (string) --
The name of the task template field.
DefaultValue (string) --
Default value for the field.
Fields (list) --
Fields that are part of the template.
(dict) --
Describes a single task template field.
Id (dict) --
The unique identifier for the field.
Name (string) --
The name of the task template field.
Description (string) --
The description of the field.
Type (string) --
Indicates the type of field.
SingleSelectOptions (list) --
A list of options for a single select field.
(string) --
Status (string) --
Marks a template as ACTIVE or INACTIVE for a task to refer to it. Tasks can only be created from ACTIVE templates. If a template is marked as INACTIVE, then a task that refers to this template cannot be created.
LastModifiedTime (datetime) --
The timestamp when the task template was last modified.
CreatedTime (datetime) --
The timestamp when the task template was created.
Tags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
{'ReferenceTypes': {'EMAIL_MESSAGE', 'CONTACT_ANALYSIS'}}
Response {'ReferenceSummaryList': {'Attachment': {'Arn': 'string',
'Status': {'AVAILABLE',
'DELETED',
'FAILED',
'PROCESSING'}},
'EmailMessage': {'Arn': 'string', 'Name': 'string'}}}
This API is in preview release for Amazon Connect and is subject to change.
For the specified referenceTypes, returns a list of references associated with the contact. References are links to documents that are related to a contact, such as emails, attachments, or URLs.
See also: AWS API Documentation
Request Syntax
client.list_contact_references(
InstanceId='string',
ContactId='string',
ReferenceTypes=[
'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
],
NextToken='string'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the initial contact.
list
[REQUIRED]
The type of reference.
(string) --
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
dict
Response Syntax
{
'ReferenceSummaryList': [
{
'Url': {
'Name': 'string',
'Value': 'string'
},
'Attachment': {
'Name': 'string',
'Value': 'string',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string'
},
'EmailMessage': {
'Name': 'string',
'Arn': 'string'
},
'String': {
'Name': 'string',
'Value': 'string'
},
'Number': {
'Name': 'string',
'Value': 'string'
},
'Date': {
'Name': 'string',
'Value': 'string'
},
'Email': {
'Name': 'string',
'Value': 'string'
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
ReferenceSummaryList (list) --
Information about the flows.
(dict) --
Contains summary information about a reference. ReferenceSummary contains only one non null field between the URL and attachment based on the reference type.
Url (dict) --
Information about the reference when the referenceType is URL. Otherwise, null.
Name (string) --
Identifier of the URL reference.
Value (string) --
A valid URL.
Attachment (dict) --
Information about the reference when the referenceType is ATTACHMENT. Otherwise, null.
Name (string) --
Identifier of the attachment reference.
Value (string) --
The location path of the attachment reference.
Status (string) --
Status of the attachment reference type.
Arn (string) --
EmailMessage (dict) --
Name (string) --
Arn (string) --
String (dict) --
Information about a reference when the referenceType is STRING. Otherwise, null.
Name (string) --
Identifier of the string reference.
Value (string) --
A valid string.
Number (dict) --
Information about a reference when the referenceType is NUMBER. Otherwise, null.
Name (string) --
Identifier of the number reference.
Value (string) --
A valid number.
Date (dict) --
Information about a reference when the referenceType is DATE. Otherwise, null.
Name (string) --
Identifier of the date reference.
Value (string) --
A valid date.
Email (dict) --
Information about a reference when the referenceType is EMAIL. Otherwise, null.
Name (string) --
Identifier of the email reference.
Value (string) --
A valid email address.
NextToken (string) --
If there are additional results, this is the token for the next set of results.
{'ResourceType': {'OUTBOUND_EMAIL', 'INBOUND_EMAIL'}}
Response {'FlowAssociationSummaryList': {'ResourceType': {'INBOUND_EMAIL',
'OUTBOUND_EMAIL'}}}
List the flow association based on the filters.
See also: AWS API Documentation
Request Syntax
client.list_flow_associations(
InstanceId='string',
ResourceType='VOICE_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL',
NextToken='string',
MaxResults=123
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
A valid resource type.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
integer
The maximum number of results to return per page.
dict
Response Syntax
{
'FlowAssociationSummaryList': [
{
'ResourceId': 'string',
'FlowId': 'string',
'ResourceType': 'VOICE_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
FlowAssociationSummaryList (list) --
Summary of flow associations.
(dict) --
Information about flow associations.
ResourceId (string) --
The identifier of the resource.
FlowId (string) --
The identifier of the flow.
ResourceType (string) --
The type of resource association.
NextToken (string) --
If there are additional results, this is the token for the next set of results.
{'ResourceType': {'EMAIL_MESSAGES'}}
This 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.
See also: AWS API Documentation
Request Syntax
client.list_instance_storage_configs(
InstanceId='string',
ResourceType='CHAT_TRANSCRIPTS'|'CALL_RECORDINGS'|'SCHEDULED_REPORTS'|'MEDIA_STREAMS'|'CONTACT_TRACE_RECORDS'|'AGENT_EVENTS'|'REAL_TIME_CONTACT_ANALYSIS_SEGMENTS'|'ATTACHMENTS'|'CONTACT_EVALUATIONS'|'SCREEN_RECORDINGS'|'REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS'|'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS'|'EMAIL_MESSAGES',
NextToken='string',
MaxResults=123
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
A valid resource type.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
integer
The maximum number of results to return per page.
dict
Response Syntax
{
'StorageConfigs': [
{
'AssociationId': 'string',
'StorageType': 'S3'|'KINESIS_VIDEO_STREAM'|'KINESIS_STREAM'|'KINESIS_FIREHOSE',
'S3Config': {
'BucketName': 'string',
'BucketPrefix': 'string',
'EncryptionConfig': {
'EncryptionType': 'KMS',
'KeyId': 'string'
}
},
'KinesisVideoStreamConfig': {
'Prefix': 'string',
'RetentionPeriodHours': 123,
'EncryptionConfig': {
'EncryptionType': 'KMS',
'KeyId': 'string'
}
},
'KinesisStreamConfig': {
'StreamArn': 'string'
},
'KinesisFirehoseConfig': {
'FirehoseArn': 'string'
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
StorageConfigs (list) --
A valid storage type.
(dict) --
The storage configuration for the instance.
AssociationId (string) --
The existing association identifier that uniquely identifies the resource type and storage config for the given instance ID.
StorageType (string) --
A valid storage type.
S3Config (dict) --
The S3 bucket configuration.
BucketName (string) --
The S3 bucket name.
BucketPrefix (string) --
The S3 bucket prefix.
EncryptionConfig (dict) --
The Amazon S3 encryption configuration.
EncryptionType (string) --
The type of encryption.
KeyId (string) --
The full ARN of the encryption key.
KinesisVideoStreamConfig (dict) --
The configuration of the Kinesis video stream.
Prefix (string) --
The prefix of the video stream.
RetentionPeriodHours (integer) --
The number of hours data is retained in the stream. Kinesis Video Streams retains the data in a data store that is associated with the stream.
The default value is 0, indicating that the stream does not persist data.
EncryptionConfig (dict) --
The encryption configuration.
EncryptionType (string) --
The type of encryption.
KeyId (string) --
The full ARN of the encryption key.
KinesisStreamConfig (dict) --
The configuration of the Kinesis data stream.
StreamArn (string) --
The Amazon Resource Name (ARN) of the data stream.
KinesisFirehoseConfig (dict) --
The configuration of the Kinesis Firehose delivery stream.
FirehoseArn (string) --
The Amazon Resource Name (ARN) of the delivery stream.
NextToken (string) --
If there are additional results, this is the token for the next set of results.
{'IntegrationType': {'SES_IDENTITY'}}
Response {'IntegrationAssociationSummaryList': {'IntegrationType': {'SES_IDENTITY'}}}
Provides summary information about the Amazon Web Services resource associations for the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.list_integration_associations(
InstanceId='string',
IntegrationType='EVENT'|'VOICE_ID'|'PINPOINT_APP'|'WISDOM_ASSISTANT'|'WISDOM_KNOWLEDGE_BASE'|'WISDOM_QUICK_RESPONSES'|'Q_MESSAGE_TEMPLATES'|'CASES_DOMAIN'|'APPLICATION'|'FILE_SCANNER'|'SES_IDENTITY',
NextToken='string',
MaxResults=123,
IntegrationArn='string'
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
The integration type.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
integer
The maximum number of results to return per page.
string
The Amazon Resource Name (ARN) of the integration.
dict
Response Syntax
{
'IntegrationAssociationSummaryList': [
{
'IntegrationAssociationId': 'string',
'IntegrationAssociationArn': 'string',
'InstanceId': 'string',
'IntegrationType': 'EVENT'|'VOICE_ID'|'PINPOINT_APP'|'WISDOM_ASSISTANT'|'WISDOM_KNOWLEDGE_BASE'|'WISDOM_QUICK_RESPONSES'|'Q_MESSAGE_TEMPLATES'|'CASES_DOMAIN'|'APPLICATION'|'FILE_SCANNER'|'SES_IDENTITY',
'IntegrationArn': 'string',
'SourceApplicationUrl': 'string',
'SourceApplicationName': 'string',
'SourceType': 'SALESFORCE'|'ZENDESK'|'CASES'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
IntegrationAssociationSummaryList (list) --
The associations.
(dict) --
Contains summary information about the associated AppIntegrations.
IntegrationAssociationId (string) --
The identifier for the AppIntegration association.
IntegrationAssociationArn (string) --
The Amazon Resource Name (ARN) for the AppIntegration association.
InstanceId (string) --
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
IntegrationType (string) --
The integration type.
IntegrationArn (string) --
The Amazon Resource Name (ARN) for the AppIntegration.
SourceApplicationUrl (string) --
The URL for the external application.
SourceApplicationName (string) --
The user-provided, friendly name for the external application.
SourceType (string) --
The name of the source.
NextToken (string) --
If there are additional results, this is the token for the next set of results.
{'RoutingProfileQueueConfigSummaryList': {'Channel': {'EMAIL'}}}
Lists the queues associated with a routing profile.
See also: AWS API Documentation
Request Syntax
client.list_routing_profile_queues(
InstanceId='string',
RoutingProfileId='string',
NextToken='string',
MaxResults=123
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the routing profile.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
integer
The maximum number of results to return per page. The default MaxResult size is 100.
dict
Response Syntax
{
'NextToken': 'string',
'RoutingProfileQueueConfigSummaryList': [
{
'QueueId': 'string',
'QueueArn': 'string',
'QueueName': 'string',
'Priority': 123,
'Delay': 123,
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL'
},
],
'LastModifiedTime': datetime(2015, 1, 1),
'LastModifiedRegion': 'string'
}
Response Structure
(dict) --
NextToken (string) --
If there are additional results, this is the token for the next set of results.
RoutingProfileQueueConfigSummaryList (list) --
Information about the routing profiles.
(dict) --
Contains summary information about a routing profile queue.
QueueId (string) --
The identifier for the queue.
QueueArn (string) --
The Amazon Resource Name (ARN) of the queue.
QueueName (string) --
The name of the queue.
Priority (integer) --
The order in which contacts are to be handled for the queue. For more information, see Queues: priority and delay.
Delay (integer) --
The delay, in seconds, that a contact should be in the queue before they are routed to an available agent. For more information, see Queues: priority and delay in the Amazon Connect Administrator Guide.
Channel (string) --
The channels this queue supports.
LastModifiedTime (datetime) --
The timestamp when this resource was last modified.
LastModifiedRegion (string) --
The Amazon Web Services Region where this resource was last modified.
{'SearchCriteria': {'Channels': {'EMAIL'},
'InitiationMethods': {'WEBRTC_API', 'AGENT_REPLY', 'FLOW'},
'SearchableSegmentAttributes': {'Criteria': [{'Key': 'string',
'Values': ['string']}],
'MatchType': 'MATCH_ALL | '
'MATCH_ANY'}}}
Response {'Contacts': {'Channel': {'EMAIL'},
'InitiationMethod': {'WEBRTC_API', 'AGENT_REPLY', 'FLOW'},
'SegmentAttributes': {'string': {'ValueString': 'string'}}}}
Searches contacts in an Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.search_contacts(
InstanceId='string',
TimeRange={
'Type': 'INITIATION_TIMESTAMP'|'SCHEDULED_TIMESTAMP'|'CONNECTED_TO_AGENT_TIMESTAMP'|'DISCONNECT_TIMESTAMP',
'StartTime': datetime(2015, 1, 1),
'EndTime': datetime(2015, 1, 1)
},
SearchCriteria={
'AgentIds': [
'string',
],
'AgentHierarchyGroups': {
'L1Ids': [
'string',
],
'L2Ids': [
'string',
],
'L3Ids': [
'string',
],
'L4Ids': [
'string',
],
'L5Ids': [
'string',
]
},
'Channels': [
'VOICE'|'CHAT'|'TASK'|'EMAIL',
],
'ContactAnalysis': {
'Transcript': {
'Criteria': [
{
'ParticipantRole': 'AGENT'|'CUSTOMER'|'SYSTEM'|'CUSTOM_BOT'|'SUPERVISOR',
'SearchText': [
'string',
],
'MatchType': 'MATCH_ALL'|'MATCH_ANY'
},
],
'MatchType': 'MATCH_ALL'|'MATCH_ANY'
}
},
'InitiationMethods': [
'INBOUND'|'OUTBOUND'|'TRANSFER'|'QUEUE_TRANSFER'|'CALLBACK'|'API'|'DISCONNECT'|'MONITOR'|'EXTERNAL_OUTBOUND'|'WEBRTC_API'|'AGENT_REPLY'|'FLOW',
],
'QueueIds': [
'string',
],
'SearchableContactAttributes': {
'Criteria': [
{
'Key': 'string',
'Values': [
'string',
]
},
],
'MatchType': 'MATCH_ALL'|'MATCH_ANY'
},
'SearchableSegmentAttributes': {
'Criteria': [
{
'Key': 'string',
'Values': [
'string',
]
},
],
'MatchType': 'MATCH_ALL'|'MATCH_ANY'
}
},
MaxResults=123,
NextToken='string',
Sort={
'FieldName': 'INITIATION_TIMESTAMP'|'SCHEDULED_TIMESTAMP'|'CONNECTED_TO_AGENT_TIMESTAMP'|'DISCONNECT_TIMESTAMP'|'INITIATION_METHOD'|'CHANNEL',
'Order': 'ASCENDING'|'DESCENDING'
}
)
string
[REQUIRED]
The identifier of Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
dict
[REQUIRED]
Time range that you want to search results.
Type (string) -- [REQUIRED]
The type of timestamp to search.
StartTime (datetime) -- [REQUIRED]
The start time of the time range.
EndTime (datetime) -- [REQUIRED]
The end time of the time range.
dict
The search criteria to be used to return contacts.
AgentIds (list) --
The identifiers of agents who handled the contacts.
(string) --
AgentHierarchyGroups (dict) --
The agent hierarchy groups of the agent at the time of handling the contact.
L1Ids (list) --
The identifiers for level 1 hierarchy groups.
(string) --
L2Ids (list) --
The identifiers for level 2 hierarchy groups.
(string) --
L3Ids (list) --
The identifiers for level 3 hierarchy groups.
(string) --
L4Ids (list) --
The identifiers for level 4 hierarchy groups.
(string) --
L5Ids (list) --
The identifiers for level 5 hierarchy groups.
(string) --
Channels (list) --
The list of channels associated with contacts.
(string) --
ContactAnalysis (dict) --
Search criteria based on analysis outputs from Amazon Connect Contact Lens.
Transcript (dict) --
Search criteria based on transcript analyzed by Amazon Connect Contact Lens.
Criteria (list) -- [REQUIRED]
The list of search criteria based on Contact Lens conversational analytics transcript.
(dict) --
A structure that defines search criteria base on words or phrases, participants in the Contact Lens conversational analytics transcript.
ParticipantRole (string) -- [REQUIRED]
The participant role in a transcript
SearchText (list) -- [REQUIRED]
The words or phrases used to search within a transcript.
(string) --
MatchType (string) -- [REQUIRED]
The match type combining search criteria using multiple search texts in a transcript criteria.
MatchType (string) --
The match type combining search criteria using multiple transcript criteria.
InitiationMethods (list) --
The list of initiation methods associated with contacts.
(string) --
QueueIds (list) --
The list of queue IDs associated with contacts.
(string) --
SearchableContactAttributes (dict) --
The search criteria based on user-defined contact attributes that have been configured for contact search. For more information, see Search by custom contact attributes in the Amazon Connect Administrator Guide.
Criteria (list) -- [REQUIRED]
The list of criteria based on user-defined contact attributes that are configured for contact search.
(dict) --
The search criteria based on user-defned contact attribute key and values to search on.
Key (string) -- [REQUIRED]
The key containing a searchable user-defined contact attribute.
Values (list) -- [REQUIRED]
The list of values to search for within a user-defined contact attribute.
(string) --
MatchType (string) --
The match type combining search criteria using multiple searchable contact attributes.
SearchableSegmentAttributes (dict) --
Criteria (list) -- [REQUIRED]
(dict) --
Key (string) -- [REQUIRED]
Values (list) -- [REQUIRED]
(string) --
MatchType (string) --
integer
The maximum number of results to return per page.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
dict
Specifies a field to sort by and a sort order.
FieldName (string) -- [REQUIRED]
The name of the field on which to sort.
Order (string) -- [REQUIRED]
An ascending or descending sort.
dict
Response Syntax
{
'Contacts': [
{
'Arn': 'string',
'Id': 'string',
'InitialContactId': 'string',
'PreviousContactId': 'string',
'InitiationMethod': 'INBOUND'|'OUTBOUND'|'TRANSFER'|'QUEUE_TRANSFER'|'CALLBACK'|'API'|'DISCONNECT'|'MONITOR'|'EXTERNAL_OUTBOUND'|'WEBRTC_API'|'AGENT_REPLY'|'FLOW',
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL',
'QueueInfo': {
'Id': 'string',
'EnqueueTimestamp': datetime(2015, 1, 1)
},
'AgentInfo': {
'Id': 'string',
'ConnectedToAgentTimestamp': datetime(2015, 1, 1)
},
'InitiationTimestamp': datetime(2015, 1, 1),
'DisconnectTimestamp': datetime(2015, 1, 1),
'ScheduledTimestamp': datetime(2015, 1, 1),
'SegmentAttributes': {
'string': {
'ValueString': 'string'
}
}
},
],
'NextToken': 'string',
'TotalCount': 123
}
Response Structure
(dict) --
Contacts (list) --
Information about the contacts.
(dict) --
Information of returned contact.
Arn (string) --
The Amazon Resource Name (ARN) of the contact.
Id (string) --
The identifier of the contact summary.
InitialContactId (string) --
If this contact is related to other contacts, this is the ID of the initial contact.
PreviousContactId (string) --
If this contact is not the first contact, this is the ID of the previous contact.
InitiationMethod (string) --
Indicates how the contact was initiated.
Channel (string) --
How the contact reached your contact center.
QueueInfo (dict) --
If this contact was queued, this contains information about the queue.
Id (string) --
The unique identifier for the queue.
EnqueueTimestamp (datetime) --
The timestamp when the contact was added to the queue.
AgentInfo (dict) --
Information about the agent who accepted the contact.
Id (string) --
The identifier of the agent who accepted the contact.
ConnectedToAgentTimestamp (datetime) --
The timestamp when the contact was connected to the agent.
InitiationTimestamp (datetime) --
The date and time this contact was initiated, in UTC time. For INBOUND, this is when the contact arrived. For OUTBOUND, this is when the agent began dialing. For CALLBACK, this is when the callback contact was created. For TRANSFER and QUEUE_TRANSFER, this is when the transfer was initiated. For API, this is when the request arrived. For EXTERNAL_OUTBOUND, this is when the agent started dialing the external participant. For MONITOR, this is when the supervisor started listening to a contact.
DisconnectTimestamp (datetime) --
The timestamp when the customer endpoint disconnected from Amazon Connect.
ScheduledTimestamp (datetime) --
The timestamp, in Unix epoch time format, at which to start running the inbound flow.
SegmentAttributes (dict) --
(string) --
(dict) --
ValueString (string) --
NextToken (string) --
If there are additional results, this is the token for the next set of results.
TotalCount (integer) --
The total number of contacts which matched your search query.
{'Queues': {'OutboundEmailConfig': {'OutboundEmailAddressId': 'string'}}}
Searches queues in an Amazon Connect instance, with optional filtering.
See also: AWS API Documentation
Request Syntax
client.search_queues(
InstanceId='string',
NextToken='string',
MaxResults=123,
SearchFilter={
'TagFilter': {
'OrConditions': [
[
{
'TagKey': 'string',
'TagValue': 'string'
},
],
],
'AndConditions': [
{
'TagKey': 'string',
'TagValue': 'string'
},
],
'TagCondition': {
'TagKey': 'string',
'TagValue': 'string'
}
}
},
SearchCriteria={
'OrConditions': [
{'... recursive ...'},
],
'AndConditions': [
{'... recursive ...'},
],
'StringCondition': {
'FieldName': 'string',
'Value': 'string',
'ComparisonType': 'STARTS_WITH'|'CONTAINS'|'EXACT'
},
'QueueTypeCondition': 'STANDARD'
}
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
integer
The maximum number of results to return per page.
dict
Filters to be applied to search results.
TagFilter (dict) --
An object that can be used to specify Tag conditions inside the SearchFilter. This accepts an OR of AND (List of List) input where:
Top level list specifies conditions that need to be applied with OR operator
Inner list specifies conditions that need to be applied with AND operator.
OrConditions (list) --
A list of conditions which would be applied together with an OR condition.
(list) --
(dict) --
A leaf node condition which can be used to specify a tag condition, for example, HAVE BPO = 123.
TagKey (string) --
The tag key in the tag condition.
TagValue (string) --
The tag value in the tag condition.
AndConditions (list) --
A list of conditions which would be applied together with an AND condition.
(dict) --
A leaf node condition which can be used to specify a tag condition, for example, HAVE BPO = 123.
TagKey (string) --
The tag key in the tag condition.
TagValue (string) --
The tag value in the tag condition.
TagCondition (dict) --
A leaf node condition which can be used to specify a tag condition.
TagKey (string) --
The tag key in the tag condition.
TagValue (string) --
The tag value in the tag condition.
dict
The search criteria to be used to return queues.
OrConditions (list) --
A list of conditions which would be applied together with an OR condition.
(dict) --
The search criteria to be used to return queues.
AndConditions (list) --
A list of conditions which would be applied together with an AND condition.
(dict) --
The search criteria to be used to return queues.
StringCondition (dict) --
A leaf node condition which can be used to specify a string condition.
FieldName (string) --
The name of the field in the string condition.
Value (string) --
The value of the string.
ComparisonType (string) --
The type of comparison to be made when evaluating the string condition.
QueueTypeCondition (string) --
The type of queue.
dict
Response Syntax
{
'Queues': [
{
'Name': 'string',
'QueueArn': 'string',
'QueueId': 'string',
'Description': 'string',
'OutboundCallerConfig': {
'OutboundCallerIdName': 'string',
'OutboundCallerIdNumberId': 'string',
'OutboundFlowId': 'string'
},
'OutboundEmailConfig': {
'OutboundEmailAddressId': 'string'
},
'HoursOfOperationId': 'string',
'MaxContacts': 123,
'Status': 'ENABLED'|'DISABLED',
'Tags': {
'string': 'string'
},
'LastModifiedTime': datetime(2015, 1, 1),
'LastModifiedRegion': 'string'
},
],
'NextToken': 'string',
'ApproximateTotalCount': 123
}
Response Structure
(dict) --
Queues (list) --
Information about the queues.
(dict) --
Contains information about a queue.
Name (string) --
The name of the queue.
QueueArn (string) --
The Amazon Resource Name (ARN) for the queue.
QueueId (string) --
The identifier for the queue.
Description (string) --
The description of the queue.
OutboundCallerConfig (dict) --
The outbound caller ID name, number, and outbound whisper flow.
OutboundCallerIdName (string) --
The caller ID name.
OutboundCallerIdNumberId (string) --
The caller ID number.
OutboundFlowId (string) --
The outbound whisper flow to be used during an outbound call.
OutboundEmailConfig (dict) --
OutboundEmailAddressId (string) --
HoursOfOperationId (string) --
The identifier for the hours of operation.
MaxContacts (integer) --
The maximum number of contacts that can be in the queue before it is considered full.
Status (string) --
The status of the queue.
Tags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
LastModifiedTime (datetime) --
The timestamp when this resource was last modified.
LastModifiedRegion (string) --
The Amazon Web Services Region where this resource was last modified.
NextToken (string) --
If there are additional results, this is the token for the next set of results.
ApproximateTotalCount (integer) --
The total number of queues which matched your search query.
{'RoutingProfiles': {'MediaConcurrencies': {'Channel': {'EMAIL'}}}}
Searches routing profiles in an Amazon Connect instance, with optional filtering.
See also: AWS API Documentation
Request Syntax
client.search_routing_profiles(
InstanceId='string',
NextToken='string',
MaxResults=123,
SearchFilter={
'TagFilter': {
'OrConditions': [
[
{
'TagKey': 'string',
'TagValue': 'string'
},
],
],
'AndConditions': [
{
'TagKey': 'string',
'TagValue': 'string'
},
],
'TagCondition': {
'TagKey': 'string',
'TagValue': 'string'
}
}
},
SearchCriteria={
'OrConditions': [
{'... recursive ...'},
],
'AndConditions': [
{'... recursive ...'},
],
'StringCondition': {
'FieldName': 'string',
'Value': 'string',
'ComparisonType': 'STARTS_WITH'|'CONTAINS'|'EXACT'
}
}
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
integer
The maximum number of results to return per page.
dict
Filters to be applied to search results.
TagFilter (dict) --
An object that can be used to specify Tag conditions inside the SearchFilter. This accepts an OR of AND (List of List) input where:
Top level list specifies conditions that need to be applied with OR operator
Inner list specifies conditions that need to be applied with AND operator.
OrConditions (list) --
A list of conditions which would be applied together with an OR condition.
(list) --
(dict) --
A leaf node condition which can be used to specify a tag condition, for example, HAVE BPO = 123.
TagKey (string) --
The tag key in the tag condition.
TagValue (string) --
The tag value in the tag condition.
AndConditions (list) --
A list of conditions which would be applied together with an AND condition.
(dict) --
A leaf node condition which can be used to specify a tag condition, for example, HAVE BPO = 123.
TagKey (string) --
The tag key in the tag condition.
TagValue (string) --
The tag value in the tag condition.
TagCondition (dict) --
A leaf node condition which can be used to specify a tag condition.
TagKey (string) --
The tag key in the tag condition.
TagValue (string) --
The tag value in the tag condition.
dict
The search criteria to be used to return routing profiles.
OrConditions (list) --
A list of conditions which would be applied together with an OR condition.
(dict) --
The search criteria to be used to return routing profiles.
AndConditions (list) --
A list of conditions which would be applied together with an AND condition.
(dict) --
The search criteria to be used to return routing profiles.
StringCondition (dict) --
A leaf node condition which can be used to specify a string condition.
FieldName (string) --
The name of the field in the string condition.
Value (string) --
The value of the string.
ComparisonType (string) --
The type of comparison to be made when evaluating the string condition.
dict
Response Syntax
{
'RoutingProfiles': [
{
'InstanceId': 'string',
'Name': 'string',
'RoutingProfileArn': 'string',
'RoutingProfileId': 'string',
'Description': 'string',
'MediaConcurrencies': [
{
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL',
'Concurrency': 123,
'CrossChannelBehavior': {
'BehaviorType': 'ROUTE_CURRENT_CHANNEL_ONLY'|'ROUTE_ANY_CHANNEL'
}
},
],
'DefaultOutboundQueueId': 'string',
'Tags': {
'string': 'string'
},
'NumberOfAssociatedQueues': 123,
'NumberOfAssociatedUsers': 123,
'AgentAvailabilityTimer': 'TIME_SINCE_LAST_ACTIVITY'|'TIME_SINCE_LAST_INBOUND',
'LastModifiedTime': datetime(2015, 1, 1),
'LastModifiedRegion': 'string',
'IsDefault': True|False,
'AssociatedQueueIds': [
'string',
]
},
],
'NextToken': 'string',
'ApproximateTotalCount': 123
}
Response Structure
(dict) --
RoutingProfiles (list) --
Information about the routing profiles.
(dict) --
Contains information about a routing profile.
InstanceId (string) --
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
Name (string) --
The name of the routing profile.
RoutingProfileArn (string) --
The Amazon Resource Name (ARN) of the routing profile.
RoutingProfileId (string) --
The identifier of the routing profile.
Description (string) --
The description of the routing profile.
MediaConcurrencies (list) --
The channels agents can handle in the Contact Control Panel (CCP) for this routing profile.
(dict) --
Contains information about which channels are supported, and how many contacts an agent can have on a channel simultaneously.
Channel (string) --
The channels that agents can handle in the Contact Control Panel (CCP).
Concurrency (integer) --
The number of contacts an agent can have on a channel simultaneously.
Valid Range for VOICE: Minimum value of 1. Maximum value of 1.
Valid Range for CHAT: Minimum value of 1. Maximum value of 10.
Valid Range for TASK: Minimum value of 1. Maximum value of 10.
CrossChannelBehavior (dict) --
Defines the cross-channel routing behavior for each channel that is enabled for this Routing Profile. For example, this allows you to offer an agent a different contact from another channel when they are currently working with a contact from a Voice channel.
BehaviorType (string) --
Specifies the other channels that can be routed to an agent handling their current channel.
DefaultOutboundQueueId (string) --
The identifier of the default outbound queue for this routing profile.
Tags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
NumberOfAssociatedQueues (integer) --
The number of associated queues in routing profile.
NumberOfAssociatedUsers (integer) --
The number of associated users in routing profile.
AgentAvailabilityTimer (string) --
Whether agents with this routing profile will have their routing order calculated based on time since their last inbound contact or longest idle time.
LastModifiedTime (datetime) --
The timestamp when this resource was last modified.
LastModifiedRegion (string) --
The Amazon Web Services Region where this resource was last modified.
IsDefault (boolean) --
Whether this a default routing profile.
AssociatedQueueIds (list) --
The IDs of the associated queue.
(string) --
NextToken (string) --
If there are additional results, this is the token for the next set of results.
ApproximateTotalCount (integer) --
The total number of routing profiles which matched your search query.
{'FileUseCaseType': {'EMAIL_MESSAGE'}}
Provides a pre-signed Amazon S3 URL in response for uploading your content.
See also: AWS API Documentation
Request Syntax
client.start_attached_file_upload(
ClientToken='string',
InstanceId='string',
FileName='string',
FileSizeInBytes=123,
UrlExpiryInSeconds=123,
FileUseCaseType='EMAIL_MESSAGE'|'ATTACHMENT',
AssociatedResourceArn='string',
CreatedBy={
'ConnectUserArn': 'string',
'AWSIdentityArn': 'string'
},
Tags={
'string': 'string'
}
)
string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.
This field is autopopulated if not provided.
string
[REQUIRED]
The unique identifier of the Amazon Connect instance.
string
[REQUIRED]
A case-sensitive name of the attached file being uploaded.
integer
[REQUIRED]
The size of the attached file in bytes.
integer
Optional override for the expiry of the pre-signed S3 URL in seconds. The default value is 300.
string
[REQUIRED]
The use case for the file.
string
[REQUIRED]
The resource to which the attached file is (being) uploaded to. Cases are the only current supported resource.
dict
Represents the identity that created the file.
ConnectUserArn (string) --
An agent ARN representing a connect user.
AWSIdentityArn (string) --
STS or IAM ARN representing the identity of API Caller. SDK users cannot populate this and this value is calculated automatically if ConnectUserArn is not provided.
dict
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.
(string) --
(string) --
dict
Response Syntax
{
'FileArn': 'string',
'FileId': 'string',
'CreationTime': 'string',
'FileStatus': 'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'CreatedBy': {
'ConnectUserArn': 'string',
'AWSIdentityArn': 'string'
},
'UploadUrlMetadata': {
'Url': 'string',
'UrlExpiry': 'string',
'HeadersToInclude': {
'string': 'string'
}
}
}
Response Structure
(dict) -- Response from StartAttachedFileUpload API.
FileArn (string) --
The unique identifier of the attached file resource (ARN).
FileId (string) --
The unique identifier of the attached file resource.
CreationTime (string) --
The time of Creation of the file resource as an ISO timestamp. It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2024-05-03T02:41:28.172Z.
FileStatus (string) --
The current status of the attached file.
CreatedBy (dict) --
Represents the identity that created the file.
ConnectUserArn (string) --
An agent ARN representing a connect user.
AWSIdentityArn (string) --
STS or IAM ARN representing the identity of API Caller. SDK users cannot populate this and this value is calculated automatically if ConnectUserArn is not provided.
UploadUrlMetadata (dict) --
Information to be used while uploading the attached file.
Url (string) --
A pre-signed S3 URL that should be used for uploading the attached file.
UrlExpiry (string) --
The expiration time of the URL in ISO timestamp. It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.
HeadersToInclude (dict) --
A map of headers that should be provided when uploading the attached file.
(string) --
(string) --
{'DestinationEndpoint': {'Type': {'EMAIL_ADDRESS'}},
'SourceEndpoint': {'Type': {'EMAIL_ADDRESS'}}}
Initiates a new outbound SMS contact to a customer. Response of this API provides the ContactId of the outbound SMS contact created.
SourceEndpoint only supports Endpoints with CONNECT_PHONENUMBER_ARN as Type and DestinationEndpoint only supports Endpoints with TELEPHONE_NUMBER as Type. ContactFlowId initiates the flow to manage the new SMS contact created.
This API can be used to initiate outbound SMS contacts for an agent or it can also deflect an ongoing contact to an outbound SMS contact by using the StartOutboundChatContact Flow Action.
For more information about using SMS in Amazon Connect, see the following topics in the Amazon Connect Administrator Guide:
See also: AWS API Documentation
Request Syntax
client.start_outbound_chat_contact(
SourceEndpoint={
'Type': 'TELEPHONE_NUMBER'|'VOIP'|'CONTACT_FLOW'|'CONNECT_PHONENUMBER_ARN'|'EMAIL_ADDRESS',
'Address': 'string'
},
DestinationEndpoint={
'Type': 'TELEPHONE_NUMBER'|'VOIP'|'CONTACT_FLOW'|'CONNECT_PHONENUMBER_ARN'|'EMAIL_ADDRESS',
'Address': 'string'
},
InstanceId='string',
SegmentAttributes={
'string': {
'ValueString': 'string'
}
},
Attributes={
'string': 'string'
},
ContactFlowId='string',
ChatDurationInMinutes=123,
ParticipantDetails={
'DisplayName': 'string'
},
InitialSystemMessage={
'ContentType': 'string',
'Content': 'string'
},
RelatedContactId='string',
SupportedMessagingContentTypes=[
'string',
],
ClientToken='string'
)
dict
[REQUIRED]
Information about the endpoint.
Type (string) --
Type of the endpoint.
Address (string) --
Address of the endpoint.
dict
[REQUIRED]
Information about the endpoint.
Type (string) --
Type of the endpoint.
Address (string) --
Address of the endpoint.
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
dict
[REQUIRED]
A set of system defined key-value pairs stored on individual contact segments using an attribute map. The attributes are standard Amazon Connect attributes. They can be accessed in flows.
Attribute keys can include only alphanumeric, -, and _.
This field can be used to show channel subtype, such as connect:Guide and connect:SMS.
(string) --
(dict) --
A value for a segment attribute. This is structured as a map where the key is valueString and the value is a string.
ValueString (string) --
The value of a segment attribute.
dict
A custom key-value pair using an attribute map. The attributes are standard Amazon Connect attributes, and can be accessed in flows just like any other contact attributes.
(string) --
(string) --
string
[REQUIRED]
The identifier of the flow for the call. To see the ContactFlowId in the Amazon Connect console user interface, on the navigation menu go to Routing, Contact Flows. Choose the flow. On the flow page, under the name of the flow, choose Show additional flow information. The ContactFlowId is the last part of the ARN, shown here in bold:
arn:aws:connect:us-west-2:xxxxxxxxxxxx:instance/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/contact-flow/123ec456-a007-89c0-1234-xxxxxxxxxxxx
integer
The total duration of the newly started chat session. If not specified, the chat session duration defaults to 25 hour. The minimum configurable time is 60 minutes. The maximum configurable time is 10,080 minutes (7 days).
dict
The customer's details.
DisplayName (string) -- [REQUIRED]
Display name of the participant.
dict
A chat message.
ContentType (string) -- [REQUIRED]
The type of the content. Supported types are text/plain, text/markdown, application/json, and application/vnd.amazonaws.connect.message.interactive.response.
Content (string) -- [REQUIRED]
The content of the chat message.
For text/plain and text/markdown, the Length Constraints are Minimum of 1, Maximum of 1024.
For application/json, the Length Constraints are Minimum of 1, Maximum of 12000.
For application/vnd.amazonaws.connect.message.interactive.response, the Length Constraints are Minimum of 1, Maximum of 12288.
string
The unique identifier for an Amazon Connect contact. This identifier is related to the contact starting.
list
The supported chat message content types. Supported types are:
text/plain
text/markdown
application/json, application/vnd.amazonaws.connect.message.interactive
application/vnd.amazonaws.connect.message.interactive.response
Content types must always contain text/plain. You can then put any other supported type in the list. For example, all the following lists are valid because they contain text/plain:
[text/plain, text/markdown, application/json]
[text/markdown, text/plain]
[text/plain, application/json, application/vnd.amazonaws.connect.message.interactive.response]
(string) --
string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the AWS SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs. The token is valid for 7 days after creation. If a contact is already started, the contact ID is returned.
This field is autopopulated if not provided.
dict
Response Syntax
{
'ContactId': 'string'
}
Response Structure
(dict) --
ContactId (string) --
The identifier of this contact within the Amazon Connect instance.
{'References': {'Arn': 'string',
'Status': 'AVAILABLE | DELETED | APPROVED | REJECTED | '
'PROCESSING | FAILED',
'StatusReason': 'string',
'Type': {'EMAIL_MESSAGE', 'CONTACT_ANALYSIS'}}}
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.
See also: AWS API Documentation
Request Syntax
client.start_outbound_voice_contact(
Name='string',
Description='string',
References={
'string': {
'Value': 'string',
'Type': 'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string',
'StatusReason': 'string'
}
},
RelatedContactId='string',
DestinationPhoneNumber='string',
ContactFlowId='string',
InstanceId='string',
ClientToken='string',
SourcePhoneNumber='string',
QueueId='string',
Attributes={
'string': 'string'
},
AnswerMachineDetectionConfig={
'EnableAnswerMachineDetection': True|False,
'AwaitAnswerMachinePrompt': True|False
},
CampaignId='string',
TrafficType='GENERAL'|'CAMPAIGN'
)
string
The name of a voice contact that is shown to an agent in the Contact Control Panel (CCP).
string
A description of the voice contact that is shown to an agent in the Contact Control Panel (CCP).
dict
A formatted URL that is shown to an agent in the Contact Control Panel (CCP). Contacts can have the following reference types at the time of creation: URL | NUMBER | STRING | DATE | EMAIL. ATTACHMENT is not a supported reference type during voice contact creation.
(string) --
(dict) --
Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.
Value (string) --
A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).
Type (string) -- [REQUIRED]
The type of the reference. DATE must be of type Epoch timestamp.
Status (string) --
Arn (string) --
StatusReason (string) --
string
The contactId that is related to this contact. Linking voice, task, or chat by using RelatedContactID copies over contact attributes from the related contact to the new contact. All updates to user-defined attributes in the new contact are limited to the individual contact ID. There are no limits to the number of contacts that can be linked by using RelatedContactId.
string
[REQUIRED]
The phone number of the customer, in E.164 format.
string
[REQUIRED]
The identifier of the flow for the outbound call. To see the ContactFlowId in the Amazon Connect admin website, on the navigation menu go to Routing, Contact Flows. Choose the flow. On the flow page, under the name of the flow, choose Show additional flow information. The ContactFlowId is the last part of the ARN, shown here in bold:
arn:aws:connect:us-west-2:xxxxxxxxxxxx:instance/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/contact-flow/846ec553-a005-41c0-8341-xxxxxxxxxxxx
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs. The token is valid for 7 days after creation. If a contact is already started, the contact ID is returned.
This field is autopopulated if not provided.
string
The phone number associated with the Amazon Connect instance, in E.164 format. If you do not specify a source phone number, you must specify a queue.
string
The queue for the call. If you specify a queue, the phone displayed for caller ID is the phone number specified in the queue. If you do not specify a queue, the queue defined in the flow is used. If you do not specify a queue, you must specify a source phone number.
dict
A custom key-value pair using an attribute map. The attributes are standard Amazon Connect attributes, and can be accessed in flows just like any other contact attributes.
There can be up to 32,768 UTF-8 bytes across all key-value pairs per contact. Attribute keys can include only alphanumeric, dash, and underscore characters.
(string) --
(string) --
dict
Configuration of the answering machine detection for this outbound call.
EnableAnswerMachineDetection (boolean) --
The flag to indicate if answer machine detection analysis needs to be performed for a voice call. If set to true, TrafficType must be set as CAMPAIGN.
AwaitAnswerMachinePrompt (boolean) --
Wait for the answering machine prompt.
string
The campaign identifier of the outbound communication.
string
Denotes the class of traffic. Calls with different traffic types are handled differently by Amazon Connect. The default value is GENERAL. Use CAMPAIGN if EnableAnswerMachineDetection is set to true. For all other cases, use GENERAL.
dict
Response Syntax
{
'ContactId': 'string'
}
Response Structure
(dict) --
ContactId (string) --
The identifier of this contact within the Amazon Connect instance.
{'References': {'Arn': 'string',
'Status': 'AVAILABLE | DELETED | APPROVED | REJECTED | '
'PROCESSING | FAILED',
'StatusReason': 'string',
'Type': {'EMAIL_MESSAGE', 'CONTACT_ANALYSIS'}},
'SegmentAttributes': {'string': {'ValueString': 'string'}}}
Initiates a flow to start a new task contact. For more information about task contacts, see Concepts: Tasks in Amazon Connect in the Amazon Connect Administrator Guide.
When using PreviousContactId and RelatedContactId input parameters, note the following:
PreviousContactId
Any updates to user-defined task contact attributes on any contact linked through the same PreviousContactId will affect every contact in the chain.
There can be a maximum of 12 linked task contacts in a chain. That is, 12 task contacts can be created that share the same PreviousContactId.
RelatedContactId
Copies contact attributes from the related task contact to the new contact.
Any update on attributes in a new task contact does not update attributes on previous contact.
There’s no limit on the number of task contacts that can be created that use the same RelatedContactId.
In addition, when calling StartTaskContact include only one of these parameters: ContactFlowID, QuickConnectID, or TaskTemplateID. Only one parameter is required as long as the task template has a flow configured to run it. If more than one parameter is specified, or only the TaskTemplateID is specified but it does not have a flow configured, the request returns an error because Amazon Connect cannot identify the unique flow to run when the task is created.
A ServiceQuotaExceededException occurs when the number of open tasks exceeds the active tasks quota or there are already 12 tasks referencing the same PreviousContactId. For more information about service quotas for task contacts, see Amazon Connect service quotas in the Amazon Connect Administrator Guide.
See also: AWS API Documentation
Request Syntax
client.start_task_contact(
InstanceId='string',
PreviousContactId='string',
ContactFlowId='string',
Attributes={
'string': 'string'
},
Name='string',
References={
'string': {
'Value': 'string',
'Type': 'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string',
'StatusReason': 'string'
}
},
Description='string',
ClientToken='string',
ScheduledTime=datetime(2015, 1, 1),
TaskTemplateId='string',
QuickConnectId='string',
RelatedContactId='string',
SegmentAttributes={
'string': {
'ValueString': 'string'
}
}
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
The identifier of the previous chat, voice, or task contact. Any updates to user-defined attributes to task contacts linked using the same PreviousContactID will affect every contact in the chain. There can be a maximum of 12 linked task contacts in a chain.
string
The identifier of the flow for initiating the tasks. To see the ContactFlowId in the Amazon Connect admin website, on the navigation menu go to Routing, Contact Flows. Choose the flow. On the flow page, under the name of the flow, choose Show additional flow information. The ContactFlowId is the last part of the ARN, shown here in bold:
arn:aws:connect:us-west-2:xxxxxxxxxxxx:instance/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/contact-flow/846ec553-a005-41c0-8341-xxxxxxxxxxxx
dict
A custom key-value pair using an attribute map. The attributes are standard Amazon Connect attributes, and can be accessed in flows just like any other contact attributes.
There can be up to 32,768 UTF-8 bytes across all key-value pairs per contact. Attribute keys can include only alphanumeric, dash, and underscore characters.
(string) --
(string) --
string
[REQUIRED]
The name of a task that is shown to an agent in the Contact Control Panel (CCP).
dict
A formatted URL that is shown to an agent in the Contact Control Panel (CCP). Tasks can have the following reference types at the time of creation: URL | NUMBER | STRING | DATE | EMAIL. ATTACHMENT is not a supported reference type during task creation.
(string) --
(dict) --
Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.
Value (string) --
A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).
Type (string) -- [REQUIRED]
The type of the reference. DATE must be of type Epoch timestamp.
Status (string) --
Arn (string) --
StatusReason (string) --
string
A description of the task that is shown to an agent in the Contact Control Panel (CCP).
string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.
This field is autopopulated if not provided.
datetime
The timestamp, in Unix Epoch seconds format, at which to start running the inbound flow. The scheduled time cannot be in the past. It must be within up to 6 days in future.
string
A unique identifier for the task template. For more information about task templates, see Create task templates in the Amazon Connect Administrator Guide.
string
The identifier for the quick connect. Tasks that are created by using QuickConnectId will use the flow that is defined on agent or queue quick connect. For more information about quick connects, see Create quick connects.
string
The contactId that is related to this contact. Linking tasks together by using RelatedContactID copies over contact attributes from the related task contact to the new task contact. All updates to user-defined attributes in the new task contact are limited to the individual contact ID, unlike what happens when tasks are linked by using PreviousContactID. There are no limits to the number of contacts that can be linked by using RelatedContactId.
dict
(string) --
(dict) --
A value for a segment attribute. This is structured as a map where the key is valueString and the value is a string.
ValueString (string) --
The value of a segment attribute.
dict
Response Syntax
{
'ContactId': 'string'
}
Response Structure
(dict) --
ContactId (string) --
The identifier of this contact within the Amazon Connect instance.
{'References': {'Arn': 'string',
'Status': 'AVAILABLE | DELETED | APPROVED | REJECTED | '
'PROCESSING | FAILED',
'StatusReason': 'string',
'Type': {'EMAIL_MESSAGE', 'CONTACT_ANALYSIS'}}}
Places an inbound in-app, web, or video call to a contact, and then initiates the flow. It performs the actions in the flow that are specified (in ContactFlowId) and present in the Amazon Connect instance (specified as InstanceId).
See also: AWS API Documentation
Request Syntax
client.start_web_rtc_contact(
Attributes={
'string': 'string'
},
ClientToken='string',
ContactFlowId='string',
InstanceId='string',
AllowedCapabilities={
'Customer': {
'Video': 'SEND',
'ScreenShare': 'SEND'
},
'Agent': {
'Video': 'SEND',
'ScreenShare': 'SEND'
}
},
ParticipantDetails={
'DisplayName': 'string'
},
RelatedContactId='string',
References={
'string': {
'Value': 'string',
'Type': 'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string',
'StatusReason': 'string'
}
},
Description='string'
)
dict
A custom key-value pair using an attribute map. The attributes are standard Amazon Connect attributes, and can be accessed in flows just like any other contact attributes.
There can be up to 32,768 UTF-8 bytes across all key-value pairs per contact. Attribute keys can include only alphanumeric, -, and _ characters.
(string) --
(string) --
string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.
The token is valid for 7 days after creation. If a contact is already started, the contact ID is returned.
This field is autopopulated if not provided.
string
[REQUIRED]
The identifier of the flow for the call. To see the ContactFlowId in the Amazon Connect admin website, on the navigation menu go to Routing, Flows. Choose the flow. On the flow page, under the name of the flow, choose Show additional flow information. The ContactFlowId is the last part of the ARN, shown here in bold:
arn:aws:connect:us-west-2:xxxxxxxxxxxx:instance/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/contact-flow/846ec553-a005-41c0-8341-xxxxxxxxxxxx
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
dict
Information about the video sharing capabilities of the participants (customer, agent).
Customer (dict) --
Information about the customer's video sharing capabilities.
Video (string) --
The configuration having the video and screen sharing capabilities for participants over the call.
ScreenShare (string) --
The screen sharing capability that is enabled for the participant. SEND indicates the participant can share their screen.
Agent (dict) --
Information about the agent's video sharing capabilities.
Video (string) --
The configuration having the video and screen sharing capabilities for participants over the call.
ScreenShare (string) --
The screen sharing capability that is enabled for the participant. SEND indicates the participant can share their screen.
dict
[REQUIRED]
The customer's details.
DisplayName (string) -- [REQUIRED]
Display name of the participant.
string
The unique identifier for an Amazon Connect contact. This identifier is related to the contact starting.
dict
A formatted URL that is shown to an agent in the Contact Control Panel (CCP). Tasks can have the following reference types at the time of creation: URL | NUMBER | STRING | DATE | EMAIL. ATTACHMENT is not a supported reference type during task creation.
(string) --
(dict) --
Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.
Value (string) --
A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).
Type (string) -- [REQUIRED]
The type of the reference. DATE must be of type Epoch timestamp.
Status (string) --
Arn (string) --
StatusReason (string) --
string
A description of the task that is shown to an agent in the Contact Control Panel (CCP).
dict
Response Syntax
{
'ConnectionData': {
'Attendee': {
'AttendeeId': 'string',
'JoinToken': 'string'
},
'Meeting': {
'MediaRegion': 'string',
'MediaPlacement': {
'AudioHostUrl': 'string',
'AudioFallbackUrl': 'string',
'SignalingUrl': 'string',
'TurnControlUrl': 'string',
'EventIngestionUrl': 'string'
},
'MeetingFeatures': {
'Audio': {
'EchoReduction': 'AVAILABLE'|'UNAVAILABLE'
}
},
'MeetingId': 'string'
}
},
'ContactId': 'string',
'ParticipantId': 'string',
'ParticipantToken': 'string'
}
Response Structure
(dict) --
ConnectionData (dict) --
Information required for the client application (mobile application or website) to connect to the call.
Attendee (dict) --
The attendee information, including attendee ID and join token.
AttendeeId (string) --
The Amazon Chime SDK attendee ID.
JoinToken (string) --
The join token used by the Amazon Chime SDK attendee.
Meeting (dict) --
A meeting created using the Amazon Chime SDK.
MediaRegion (string) --
The Amazon Web Services Region in which you create the meeting.
MediaPlacement (dict) --
The media placement for the meeting.
AudioHostUrl (string) --
The audio host URL.
AudioFallbackUrl (string) --
The audio fallback URL.
SignalingUrl (string) --
The signaling URL.
TurnControlUrl (string) --
The turn control URL.
EventIngestionUrl (string) --
The event ingestion URL to which you send client meeting events.
MeetingFeatures (dict) --
The configuration settings of the features available to a meeting.
Audio (dict) --
The configuration settings for the audio features available to a meeting.
EchoReduction (string) --
Makes echo reduction available to clients who connect to the meeting.
MeetingId (string) --
The Amazon Chime SDK meeting ID.
ContactId (string) --
The identifier of the contact in this instance of Amazon Connect.
ParticipantId (string) --
The identifier for a contact participant. The ParticipantId for a contact participant is the same throughout the contact lifecycle.
ParticipantToken (string) --
The token used by the contact participant to call the CreateParticipantConnection API. The participant token is valid for the lifetime of a contact participant.
{'References': {'Arn': 'string',
'Status': 'AVAILABLE | DELETED | APPROVED | REJECTED | '
'PROCESSING | FAILED',
'StatusReason': 'string',
'Type': {'EMAIL_MESSAGE', 'CONTACT_ANALYSIS'}},
'SegmentAttributes': {'string': {'ValueString': 'string'}}}
This 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.
See also: AWS API Documentation
Request Syntax
client.update_contact(
InstanceId='string',
ContactId='string',
Name='string',
Description='string',
References={
'string': {
'Value': 'string',
'Type': 'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string',
'StatusReason': 'string'
}
},
SegmentAttributes={
'string': {
'ValueString': 'string'
}
}
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the contact. This is the identifier of the contact associated with the first interaction with your contact center.
string
The name of the contact.
string
The description of the contact.
dict
Well-formed data on contact, shown to agents on Contact Control Panel (CCP).
(string) --
(dict) --
Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.
Value (string) --
A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).
Type (string) -- [REQUIRED]
The type of the reference. DATE must be of type Epoch timestamp.
Status (string) --
Arn (string) --
StatusReason (string) --
dict
(string) --
(dict) --
A value for a segment attribute. This is structured as a map where the key is valueString and the value is a string.
ValueString (string) --
The value of a segment attribute.
dict
Response Syntax
{}
Response Structure
(dict) --
{'ResourceType': {'EMAIL_MESSAGES'}}
This 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.
See also: AWS API Documentation
Request Syntax
client.update_instance_storage_config(
InstanceId='string',
AssociationId='string',
ResourceType='CHAT_TRANSCRIPTS'|'CALL_RECORDINGS'|'SCHEDULED_REPORTS'|'MEDIA_STREAMS'|'CONTACT_TRACE_RECORDS'|'AGENT_EVENTS'|'REAL_TIME_CONTACT_ANALYSIS_SEGMENTS'|'ATTACHMENTS'|'CONTACT_EVALUATIONS'|'SCREEN_RECORDINGS'|'REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS'|'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS'|'EMAIL_MESSAGES',
StorageConfig={
'AssociationId': 'string',
'StorageType': 'S3'|'KINESIS_VIDEO_STREAM'|'KINESIS_STREAM'|'KINESIS_FIREHOSE',
'S3Config': {
'BucketName': 'string',
'BucketPrefix': 'string',
'EncryptionConfig': {
'EncryptionType': 'KMS',
'KeyId': 'string'
}
},
'KinesisVideoStreamConfig': {
'Prefix': 'string',
'RetentionPeriodHours': 123,
'EncryptionConfig': {
'EncryptionType': 'KMS',
'KeyId': 'string'
}
},
'KinesisStreamConfig': {
'StreamArn': 'string'
},
'KinesisFirehoseConfig': {
'FirehoseArn': 'string'
}
}
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The existing association identifier that uniquely identifies the resource type and storage config for the given instance ID.
string
[REQUIRED]
A valid resource type.
dict
[REQUIRED]
The storage configuration for the instance.
AssociationId (string) --
The existing association identifier that uniquely identifies the resource type and storage config for the given instance ID.
StorageType (string) -- [REQUIRED]
A valid storage type.
S3Config (dict) --
The S3 bucket configuration.
BucketName (string) -- [REQUIRED]
The S3 bucket name.
BucketPrefix (string) -- [REQUIRED]
The S3 bucket prefix.
EncryptionConfig (dict) --
The Amazon S3 encryption configuration.
EncryptionType (string) -- [REQUIRED]
The type of encryption.
KeyId (string) -- [REQUIRED]
The full ARN of the encryption key.
KinesisVideoStreamConfig (dict) --
The configuration of the Kinesis video stream.
Prefix (string) -- [REQUIRED]
The prefix of the video stream.
RetentionPeriodHours (integer) -- [REQUIRED]
The number of hours data is retained in the stream. Kinesis Video Streams retains the data in a data store that is associated with the stream.
The default value is 0, indicating that the stream does not persist data.
EncryptionConfig (dict) -- [REQUIRED]
The encryption configuration.
EncryptionType (string) -- [REQUIRED]
The type of encryption.
KeyId (string) -- [REQUIRED]
The full ARN of the encryption key.
KinesisStreamConfig (dict) --
The configuration of the Kinesis data stream.
StreamArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the data stream.
KinesisFirehoseConfig (dict) --
The configuration of the Kinesis Firehose delivery stream.
FirehoseArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the delivery stream.
None
{'MediaConcurrencies': {'Channel': {'EMAIL'}}}
Updates the channels that agents can handle in the Contact Control Panel (CCP) for a routing profile.
See also: AWS API Documentation
Request Syntax
client.update_routing_profile_concurrency(
InstanceId='string',
RoutingProfileId='string',
MediaConcurrencies=[
{
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL',
'Concurrency': 123,
'CrossChannelBehavior': {
'BehaviorType': 'ROUTE_CURRENT_CHANNEL_ONLY'|'ROUTE_ANY_CHANNEL'
}
},
]
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the routing profile.
list
[REQUIRED]
The channels that agents can handle in the Contact Control Panel (CCP).
(dict) --
Contains information about which channels are supported, and how many contacts an agent can have on a channel simultaneously.
Channel (string) -- [REQUIRED]
The channels that agents can handle in the Contact Control Panel (CCP).
Concurrency (integer) -- [REQUIRED]
The number of contacts an agent can have on a channel simultaneously.
Valid Range for VOICE: Minimum value of 1. Maximum value of 1.
Valid Range for CHAT: Minimum value of 1. Maximum value of 10.
Valid Range for TASK: Minimum value of 1. Maximum value of 10.
CrossChannelBehavior (dict) --
Defines the cross-channel routing behavior for each channel that is enabled for this Routing Profile. For example, this allows you to offer an agent a different contact from another channel when they are currently working with a contact from a Voice channel.
BehaviorType (string) -- [REQUIRED]
Specifies the other channels that can be routed to an agent handling their current channel.
None
{'QueueConfigs': {'QueueReference': {'Channel': {'EMAIL'}}}}
Updates the properties associated with a set of queues for a routing profile.
See also: AWS API Documentation
Request Syntax
client.update_routing_profile_queues(
InstanceId='string',
RoutingProfileId='string',
QueueConfigs=[
{
'QueueReference': {
'QueueId': 'string',
'Channel': 'VOICE'|'CHAT'|'TASK'|'EMAIL'
},
'Priority': 123,
'Delay': 123
},
]
)
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The identifier of the routing profile.
list
[REQUIRED]
The queues to be updated for this routing profile. Queues must first be associated to the routing profile. You can do this using AssociateRoutingProfileQueues.
(dict) --
Contains information about the queue and channel for which priority and delay can be set.
QueueReference (dict) -- [REQUIRED]
Contains information about a queue resource.
QueueId (string) -- [REQUIRED]
The identifier for the queue.
Channel (string) -- [REQUIRED]
The channels agents can handle in the Contact Control Panel (CCP) for this routing profile.
Priority (integer) -- [REQUIRED]
The order in which contacts are to be handled for the queue. For more information, see Queues: priority and delay.
Delay (integer) -- [REQUIRED]
The delay, in seconds, a contact should be in the queue before they are routed to an available agent. For more information, see Queues: priority and delay in the Amazon Connect Administrator Guide.
None
{'Actions': {'TaskAction': {'References': {'Arn': 'string',
'Status': 'AVAILABLE | DELETED | '
'APPROVED | REJECTED | '
'PROCESSING | FAILED',
'StatusReason': 'string',
'Type': {'CONTACT_ANALYSIS',
'EMAIL_MESSAGE'}}}}}
Updates a rule for the specified Amazon Connect instance.
Use the Rules Function language to code conditions for the rule.
See also: AWS API Documentation
Request Syntax
client.update_rule(
RuleId='string',
InstanceId='string',
Name='string',
Function='string',
Actions=[
{
'ActionType': 'CREATE_TASK'|'ASSIGN_CONTACT_CATEGORY'|'GENERATE_EVENTBRIDGE_EVENT'|'SEND_NOTIFICATION'|'CREATE_CASE'|'UPDATE_CASE'|'END_ASSOCIATED_TASKS'|'SUBMIT_AUTO_EVALUATION',
'TaskAction': {
'Name': 'string',
'Description': 'string',
'ContactFlowId': 'string',
'References': {
'string': {
'Value': 'string',
'Type': 'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
'Arn': 'string',
'StatusReason': 'string'
}
}
},
'EventBridgeAction': {
'Name': 'string'
},
'AssignContactCategoryAction': {}
,
'SendNotificationAction': {
'DeliveryMethod': 'EMAIL',
'Subject': 'string',
'Content': 'string',
'ContentType': 'PLAIN_TEXT',
'Recipient': {
'UserTags': {
'string': 'string'
},
'UserIds': [
'string',
]
}
},
'CreateCaseAction': {
'Fields': [
{
'Id': 'string',
'Value': {
'BooleanValue': True|False,
'DoubleValue': 123.0,
'EmptyValue': {}
,
'StringValue': 'string'
}
},
],
'TemplateId': 'string'
},
'UpdateCaseAction': {
'Fields': [
{
'Id': 'string',
'Value': {
'BooleanValue': True|False,
'DoubleValue': 123.0,
'EmptyValue': {}
,
'StringValue': 'string'
}
},
]
},
'EndAssociatedTasksAction': {}
,
'SubmitAutoEvaluationAction': {
'EvaluationFormId': 'string'
}
},
],
PublishStatus='DRAFT'|'PUBLISHED'
)
string
[REQUIRED]
A unique identifier for the rule.
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
[REQUIRED]
The name of the rule. You can change the name only if TriggerEventSource is one of the following values: OnZendeskTicketCreate | OnZendeskTicketStatusUpdate | OnSalesforceCaseCreate
string
[REQUIRED]
The conditions of the rule.
list
[REQUIRED]
A list of actions to be run when the rule is triggered.
(dict) --
Information about the action to be performed when a rule is triggered.
ActionType (string) -- [REQUIRED]
The type of action that creates a rule.
TaskAction (dict) --
Information about the task action. This field is required if TriggerEventSource is one of the following values: OnZendeskTicketCreate | OnZendeskTicketStatusUpdate | OnSalesforceCaseCreate
Name (string) -- [REQUIRED]
The name. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
Description (string) --
The description. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
ContactFlowId (string) -- [REQUIRED]
The identifier of the flow.
References (dict) --
Information about the reference when the referenceType is URL. Otherwise, null. (Supports variable injection in the Value field.)
(string) --
(dict) --
Well-formed data on a contact, used by agents to complete a contact request. You can have up to 4,096 UTF-8 bytes across all references for a contact.
Value (string) --
A valid value for the reference. For example, for a URL reference, a formatted URL that is displayed to an agent in the Contact Control Panel (CCP).
Type (string) -- [REQUIRED]
The type of the reference. DATE must be of type Epoch timestamp.
Status (string) --
Arn (string) --
StatusReason (string) --
EventBridgeAction (dict) --
Information about the EventBridge action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnContactEvaluationSubmit | OnMetricDataUpdate
Name (string) -- [REQUIRED]
The name.
AssignContactCategoryAction (dict) --
Information about the contact category action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnZendeskTicketCreate | OnZendeskTicketStatusUpdate | OnSalesforceCaseCreate
SendNotificationAction (dict) --
Information about the send notification action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnRealTimeCallAnalysisAvailable | OnRealTimeChatAnalysisAvailable | OnPostChatAnalysisAvailable | OnContactEvaluationSubmit | OnMetricDataUpdate
DeliveryMethod (string) -- [REQUIRED]
Notification delivery method.
Subject (string) --
The subject of the email if the delivery method is EMAIL. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
Content (string) -- [REQUIRED]
Notification content. Supports variable injection. For more information, see JSONPath reference in the Amazon Connect Administrators Guide.
ContentType (string) -- [REQUIRED]
Content type format.
Recipient (dict) -- [REQUIRED]
Notification recipient.
UserTags (dict) --
The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }. Amazon Connect users with the specified tags will be notified.
(string) --
(string) --
UserIds (list) --
A list of user IDs.
(string) --
CreateCaseAction (dict) --
Information about the create case action.
Supported only for TriggerEventSource values: OnPostCallAnalysisAvailable | OnPostChatAnalysisAvailable.
Fields (list) -- [REQUIRED]
An array of objects with Field ID and Value data.
(dict) --
Object for case field values.
Id (string) -- [REQUIRED]
Unique identifier of a field.
Value (dict) -- [REQUIRED]
Union of potential field value types.
BooleanValue (boolean) --
A Boolean number value type.
DoubleValue (float) --
A Double number value type.
EmptyValue (dict) --
An empty value.
StringValue (string) --
String value type.
TemplateId (string) -- [REQUIRED]
A unique identifier of a template.
UpdateCaseAction (dict) --
Information about the update case action.
Supported only for TriggerEventSource values: OnCaseCreate | OnCaseUpdate.
Fields (list) -- [REQUIRED]
An array of objects with Field ID and Value data.
(dict) --
Object for case field values.
Id (string) -- [REQUIRED]
Unique identifier of a field.
Value (dict) -- [REQUIRED]
Union of potential field value types.
BooleanValue (boolean) --
A Boolean number value type.
DoubleValue (float) --
A Double number value type.
EmptyValue (dict) --
An empty value.
StringValue (string) --
String value type.
EndAssociatedTasksAction (dict) --
Information about the end associated tasks action.
Supported only for TriggerEventSource values: OnCaseUpdate.
SubmitAutoEvaluationAction (dict) --
Information about the submit automated evaluation action.
EvaluationFormId (string) -- [REQUIRED]
The identifier of the auto-evaluation enabled form.
string
[REQUIRED]
The publish status of the rule.
None
{'Fields': {'Type': {'EXPIRY_DURATION', 'SELF_ASSIGN'}},
'SelfAssignFlowId': 'string'}
Updates 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.
See also: AWS API Documentation
Request Syntax
client.update_task_template(
TaskTemplateId='string',
InstanceId='string',
Name='string',
Description='string',
ContactFlowId='string',
SelfAssignFlowId='string',
Constraints={
'RequiredFields': [
{
'Id': {
'Name': 'string'
}
},
],
'ReadOnlyFields': [
{
'Id': {
'Name': 'string'
}
},
],
'InvisibleFields': [
{
'Id': {
'Name': 'string'
}
},
]
},
Defaults={
'DefaultFieldValues': [
{
'Id': {
'Name': 'string'
},
'DefaultValue': 'string'
},
]
},
Status='ACTIVE'|'INACTIVE',
Fields=[
{
'Id': {
'Name': 'string'
},
'Description': 'string',
'Type': 'NAME'|'DESCRIPTION'|'SCHEDULED_TIME'|'QUICK_CONNECT'|'URL'|'NUMBER'|'TEXT'|'TEXT_AREA'|'DATE_TIME'|'BOOLEAN'|'SINGLE_SELECT'|'EMAIL'|'SELF_ASSIGN'|'EXPIRY_DURATION',
'SingleSelectOptions': [
'string',
]
},
]
)
string
[REQUIRED]
A unique identifier for the task template.
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
string
The name of the task template.
string
The description of the task template.
string
The identifier of the flow that runs by default when a task is created by referencing this template.
string
dict
Constraints that are applicable to the fields listed.
RequiredFields (list) --
Lists the fields that are required to be filled by agents.
(dict) --
Information about a required field.
Id (dict) --
The unique identifier for the field.
Name (string) --
The name of the task template field.
ReadOnlyFields (list) --
Lists the fields that are read-only to agents, and cannot be edited.
(dict) --
Indicates a field that is read-only to an agent.
Id (dict) --
Identifier of the read-only field.
Name (string) --
The name of the task template field.
InvisibleFields (list) --
Lists the fields that are invisible to agents.
(dict) --
A field that is invisible to an agent.
Id (dict) --
Identifier of the invisible field.
Name (string) --
The name of the task template field.
dict
The default values for fields when a task is created by referencing this template.
DefaultFieldValues (list) --
Default value for the field.
(dict) --
Describes a default field and its corresponding value.
Id (dict) --
Identifier of a field.
Name (string) --
The name of the task template field.
DefaultValue (string) --
Default value for the field.
string
Marks a template as ACTIVE or INACTIVE for a task to refer to it. Tasks can only be created from ACTIVE templates. If a template is marked as INACTIVE, then a task that refers to this template cannot be created.
list
Fields that are part of the template.
(dict) --
Describes a single task template field.
Id (dict) -- [REQUIRED]
The unique identifier for the field.
Name (string) --
The name of the task template field.
Description (string) --
The description of the field.
Type (string) --
Indicates the type of field.
SingleSelectOptions (list) --
A list of options for a single select field.
(string) --
dict
Response Syntax
{
'InstanceId': 'string',
'Id': 'string',
'Arn': 'string',
'Name': 'string',
'Description': 'string',
'ContactFlowId': 'string',
'SelfAssignFlowId': 'string',
'Constraints': {
'RequiredFields': [
{
'Id': {
'Name': 'string'
}
},
],
'ReadOnlyFields': [
{
'Id': {
'Name': 'string'
}
},
],
'InvisibleFields': [
{
'Id': {
'Name': 'string'
}
},
]
},
'Defaults': {
'DefaultFieldValues': [
{
'Id': {
'Name': 'string'
},
'DefaultValue': 'string'
},
]
},
'Fields': [
{
'Id': {
'Name': 'string'
},
'Description': 'string',
'Type': 'NAME'|'DESCRIPTION'|'SCHEDULED_TIME'|'QUICK_CONNECT'|'URL'|'NUMBER'|'TEXT'|'TEXT_AREA'|'DATE_TIME'|'BOOLEAN'|'SINGLE_SELECT'|'EMAIL'|'SELF_ASSIGN'|'EXPIRY_DURATION',
'SingleSelectOptions': [
'string',
]
},
],
'Status': 'ACTIVE'|'INACTIVE',
'LastModifiedTime': datetime(2015, 1, 1),
'CreatedTime': datetime(2015, 1, 1)
}
Response Structure
(dict) --
InstanceId (string) --
The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.
Id (string) --
The identifier of the task template resource.
Arn (string) --
The Amazon Resource Name (ARN) for the task template resource.
Name (string) --
The name of the task template.
Description (string) --
The description of the task template.
ContactFlowId (string) --
The identifier of the flow that runs by default when a task is created by referencing this template.
SelfAssignFlowId (string) --
Constraints (dict) --
Constraints that are applicable to the fields listed.
RequiredFields (list) --
Lists the fields that are required to be filled by agents.
(dict) --
Information about a required field.
Id (dict) --
The unique identifier for the field.
Name (string) --
The name of the task template field.
ReadOnlyFields (list) --
Lists the fields that are read-only to agents, and cannot be edited.
(dict) --
Indicates a field that is read-only to an agent.
Id (dict) --
Identifier of the read-only field.
Name (string) --
The name of the task template field.
InvisibleFields (list) --
Lists the fields that are invisible to agents.
(dict) --
A field that is invisible to an agent.
Id (dict) --
Identifier of the invisible field.
Name (string) --
The name of the task template field.
Defaults (dict) --
The default values for fields when a task is created by referencing this template.
DefaultFieldValues (list) --
Default value for the field.
(dict) --
Describes a default field and its corresponding value.
Id (dict) --
Identifier of a field.
Name (string) --
The name of the task template field.
DefaultValue (string) --
Default value for the field.
Fields (list) --
Fields that are part of the template.
(dict) --
Describes a single task template field.
Id (dict) --
The unique identifier for the field.
Name (string) --
The name of the task template field.
Description (string) --
The description of the field.
Type (string) --
Indicates the type of field.
SingleSelectOptions (list) --
A list of options for a single select field.
(string) --
Status (string) --
Marks a template as ACTIVE or INACTIVE for a task to refer to it. Tasks can only be created from ACTIVE templates. If a template is marked as INACTIVE, then a task that refers to this template cannot be created.
LastModifiedTime (datetime) --
The timestamp when the task template was last modified.
CreatedTime (datetime) --
The timestamp when the task template was created.