2024/12/02 - Amazon Connect Service - 12 updated api methods
Changes Adds support for WhatsApp Business messaging, IVR call recording, enabling Contact Lens for existing on-premise contact centers and telephony platforms, and enabling telephony and IVR migration to Amazon Connect independent of their contact center agents.
{'ResourceType': {'ANALYTICS_CONNECTOR', 'WHATSAPP_MESSAGING_PHONE_NUMBER'}}
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'|'ANALYTICS_CONNECTOR'|'WHATSAPP_MESSAGING_PHONE_NUMBER' )
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.
Amazon Web Services End User Messaging SMS phone number ARN when using SMS_PHONE_NUMBER
Amazon Web Services End User Messaging Social phone number ARN when using WHATSAPP_MESSAGING_PHONE_NUMBER
string
[REQUIRED]
The identifier of the flow.
string
[REQUIRED]
A valid resource type.
dict
Response Syntax
{}
Response Structure
(dict) --
{'ResourceType': {'ANALYTICS_CONNECTOR', 'WHATSAPP_MESSAGING_PHONE_NUMBER'}}Response
{'FlowAssociationSummaryList': {'ResourceType': {'ANALYTICS_CONNECTOR', 'WHATSAPP_MESSAGING_PHONE_NUMBER'}}}
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='WHATSAPP_MESSAGING_PHONE_NUMBER'|'VOICE_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'|'ANALYTICS_CONNECTOR' )
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.
Amazon Web Services End User Messaging SMS phone number ARN when using SMS_PHONE_NUMBER
Amazon Web Services End User Messaging Social phone number ARN when using WHATSAPP_MESSAGING_PHONE_NUMBER
(string) --
string
The type of resource association.
dict
Response Syntax
{ 'FlowAssociationSummaryList': [ { 'ResourceId': 'string', 'FlowId': 'string', 'ResourceType': 'WHATSAPP_MESSAGING_PHONE_NUMBER'|'VOICE_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'|'ANALYTICS_CONNECTOR' }, ] }
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.
{'IntegrationType': {'ANALYTICS_CONNECTOR', 'CALL_TRANSFER_CONNECTOR'}}
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'|'ANALYTICS_CONNECTOR'|'CALL_TRANSFER_CONNECTOR', 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.
{'ResourceType': {'ANALYTICS_CONNECTOR', 'WHATSAPP_MESSAGING_PHONE_NUMBER'}}
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'|'ANALYTICS_CONNECTOR'|'WHATSAPP_MESSAGING_PHONE_NUMBER' )
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.
Amazon Web Services End User Messaging SMS phone number ARN when using SMS_PHONE_NUMBER
Amazon Web Services End User Messaging Social phone number ARN when using WHATSAPP_MESSAGING_PHONE_NUMBER
string
[REQUIRED]
A valid resource type.
dict
Response Syntax
{}
Response Structure
(dict) --
{'ResourceType': {'ANALYTICS_CONNECTOR', 'WHATSAPP_MESSAGING_PHONE_NUMBER'}}
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'|'ANALYTICS_CONNECTOR'|'WHATSAPP_MESSAGING_PHONE_NUMBER' )
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.
Amazon Web Services End User Messaging SMS phone number ARN when using SMS_PHONE_NUMBER
Amazon Web Services End User Messaging Social phone number ARN when using WHATSAPP_MESSAGING_PHONE_NUMBER
string
[REQUIRED]
A valid resource type.
dict
Response Syntax
{ 'ResourceId': 'string', 'FlowId': 'string', 'ResourceType': 'SMS_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'|'ANALYTICS_CONNECTOR'|'WHATSAPP_MESSAGING_PHONE_NUMBER' }
Response Structure
(dict) --
ResourceId (string) --
The identifier of the resource.
FlowId (string) --
The identifier of the flow.
ResourceType (string) --
A valid resource type.
{'ResourceType': {'ANALYTICS_CONNECTOR', 'WHATSAPP_MESSAGING_PHONE_NUMBER'}}Response
{'FlowAssociationSummaryList': {'ResourceType': {'ANALYTICS_CONNECTOR', 'WHATSAPP_MESSAGING_PHONE_NUMBER'}}}
List the flow association based on the filters.
See also: AWS API Documentation
Request Syntax
client.list_flow_associations( InstanceId='string', ResourceType='WHATSAPP_MESSAGING_PHONE_NUMBER'|'VOICE_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'|'ANALYTICS_CONNECTOR', 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': 'WHATSAPP_MESSAGING_PHONE_NUMBER'|'VOICE_PHONE_NUMBER'|'INBOUND_EMAIL'|'OUTBOUND_EMAIL'|'ANALYTICS_CONNECTOR' }, ], '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.
{'IntegrationType': {'ANALYTICS_CONNECTOR', 'CALL_TRANSFER_CONNECTOR'}}Response
{'IntegrationAssociationSummaryList': {'IntegrationType': {'ANALYTICS_CONNECTOR', 'CALL_TRANSFER_CONNECTOR'}}}
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'|'ANALYTICS_CONNECTOR'|'CALL_TRANSFER_CONNECTOR', 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'|'ANALYTICS_CONNECTOR'|'CALL_TRANSFER_CONNECTOR', '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.
{'ContactRecordingType': 'AGENT | IVR | SCREEN'}
When a contact is being recorded, and the recording has been suspended using SuspendContactRecording, this API resumes recording whatever recording is selected in the flow configuration: call, screen, or both. If only call recording or only screen recording is enabled, then it would resume.
Voice and screen recordings are supported.
See also: AWS API Documentation
Request Syntax
client.resume_contact_recording( InstanceId='string', ContactId='string', InitialContactId='string', ContactRecordingType='AGENT'|'IVR'|'SCREEN' )
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.
string
[REQUIRED]
The identifier of the contact. This is the identifier of the contact associated with the first interaction with the contact center.
string
The type of recording being operated on.
dict
Response Syntax
{}
Response Structure
(dict) --
{'VoiceRecordingConfiguration': {'IvrRecordingTrack': 'ALL'}}
Starts recording the contact:
If the API is called before the agent joins the call, recording starts when the agent joins the call.
If the API is called after the agent joins the call, recording starts at the time of the API call.
StartContactRecording is a one-time action. For example, if you use StopContactRecording to stop recording an ongoing call, you can't use StartContactRecording to restart it. For scenarios where the recording has started and you want to suspend and resume it, such as when collecting sensitive information (for example, a credit card number), use SuspendContactRecording and ResumeContactRecording.
You can use this API to override the recording behavior configured in the Set recording behavior block.
Only voice recordings are supported at this time.
See also: AWS API Documentation
Request Syntax
client.start_contact_recording( InstanceId='string', ContactId='string', InitialContactId='string', VoiceRecordingConfiguration={ 'VoiceRecordingTrack': 'FROM_AGENT'|'TO_AGENT'|'ALL', 'IvrRecordingTrack': 'ALL' } )
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.
string
[REQUIRED]
The identifier of the contact. This is the identifier of the contact associated with the first interaction with the contact center.
dict
[REQUIRED]
The person being recorded.
VoiceRecordingTrack (string) --
Identifies which track is being recorded.
IvrRecordingTrack (string) --
Identifies which IVR track is being recorded.
dict
Response Syntax
{}
Response Structure
(dict) --
{'ContactRecordingType': 'AGENT | IVR | SCREEN'}
Stops recording a call when a contact is being recorded. StopContactRecording is a one-time action. If you use StopContactRecording to stop recording an ongoing call, you can't use StartContactRecording to restart it. For scenarios where the recording has started and you want to suspend it for sensitive information (for example, to collect a credit card number), and then restart it, use SuspendContactRecording and ResumeContactRecording.
Only voice recordings are supported at this time.
See also: AWS API Documentation
Request Syntax
client.stop_contact_recording( InstanceId='string', ContactId='string', InitialContactId='string', ContactRecordingType='AGENT'|'IVR'|'SCREEN' )
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.
string
[REQUIRED]
The identifier of the contact. This is the identifier of the contact associated with the first interaction with the contact center.
string
The type of recording being operated on.
dict
Response Syntax
{}
Response Structure
(dict) --
{'ContactRecordingType': 'AGENT | IVR | SCREEN'}
When a contact is being recorded, this API suspends recording whatever is selected in the flow configuration: call, screen, or both. If only call recording or only screen recording is enabled, then it would be suspended. For example, you might suspend the screen recording while collecting sensitive information, such as a credit card number. Then use ResumeContactRecording to restart recording the screen.
The period of time that the recording is suspended is filled with silence in the final recording.
Voice and screen recordings are supported.
See also: AWS API Documentation
Request Syntax
client.suspend_contact_recording( InstanceId='string', ContactId='string', InitialContactId='string', ContactRecordingType='AGENT'|'IVR'|'SCREEN' )
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.
string
[REQUIRED]
The identifier of the contact. This is the identifier of the contact associated with the first interaction with the contact center.
string
The type of recording being operated on.
dict
Response Syntax
{}
Response Structure
(dict) --
{'CustomerEndpoint': {'Address': 'string', 'Type': 'TELEPHONE_NUMBER | VOIP | CONTACT_FLOW | ' 'CONNECT_PHONENUMBER_ARN | EMAIL_ADDRESS'}, 'QueueInfo': {'Id': 'string'}, 'SystemEndpoint': {'Address': 'string', 'Type': 'TELEPHONE_NUMBER | VOIP | CONTACT_FLOW | ' 'CONNECT_PHONENUMBER_ARN | EMAIL_ADDRESS'}, 'UserInfo': {'UserId': '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', 'ValueMap': { 'string': {'... recursive ...'} }, 'ValueInteger': 123 } }, QueueInfo={ 'Id': 'string' }, UserInfo={ 'UserId': 'string' }, CustomerEndpoint={ 'Type': 'TELEPHONE_NUMBER'|'VOIP'|'CONTACT_FLOW'|'CONNECT_PHONENUMBER_ARN'|'EMAIL_ADDRESS', 'Address': 'string' }, SystemEndpoint={ 'Type': 'TELEPHONE_NUMBER'|'VOIP'|'CONTACT_FLOW'|'CONNECT_PHONENUMBER_ARN'|'EMAIL_ADDRESS', 'Address': '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) --
Status of the attachment reference type.
Arn (string) --
The Amazon Resource Name (ARN) of the reference
StatusReason (string) --
Relevant details why the reference was not successfully created.
dict
A set of system defined key-value pairs stored on individual contact segments (unique contact ID) 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.
Currently Contact Expiry is the only segment attribute which can be updated by using the UpdateContact API.
(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.
ValueMap (dict) --
The value of a segment attribute.
(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.
ValueInteger (integer) --
The value of a segment attribute.
dict
Information about the queue associated with a contact. This parameter can only be updated for external audio contacts. It is used when you integrate third-party systems with Contact Lens for analytics. For more information, see Amazon Connect Contact Lens integration in the Amazon Connect Administrator Guide.
Id (string) --
The identifier of the queue.
dict
Information about the agent associated with a contact. This parameter can only be updated for external audio contacts. It is used when you integrate third-party systems with Contact Lens for analytics. For more information, see Amazon Connect Contact Lens integration in the Amazon Connect Administrator Guide.
UserId (string) --
The user identifier for the contact.
dict
The endpoint of the customer for which the contact was initiated. For external audio contacts, this is usually the end customer's phone number. This value can only be updated for external audio contacts. For more information, see Amazon Connect Contact Lens integration in the Amazon Connect Administrator Guide.
Type (string) --
Type of the endpoint.
Address (string) --
Address of the endpoint.
dict
External system endpoint for the contact was initiated. For external audio contacts, this is the phone number of the external system such as the contact center. This value can only be updated for external audio contacts. For more information, see Amazon Connect Contact Lens integration in the Amazon Connect Administrator Guide.
Type (string) --
Type of the endpoint.
Address (string) --
Address of the endpoint.
dict
Response Syntax
{}
Response Structure
(dict) --