2020/09/16 - Amazon Connect Service - 14 new api methods
Changes This release adds support for contact flows and routing profiles. For details, see the Release Notes in the Amazon Connect Administrator Guide.
Updates the name and description of a routing profile. The request accepts the following data in JSON format. At least Name or Description must be provided.
See also: AWS API Documentation
Request Syntax
client.update_routing_profile_name( InstanceId='string', RoutingProfileId='string', Name='string', Description='string' )
string
[REQUIRED]
The identifier of the Amazon Connect instance.
string
[REQUIRED]
The identifier of the routing profile.
string
The name of the routing profile. Must not be more than 127 characters.
string
The description of the routing profile. Must not be more than 250 characters.
None
Creates a contact flow for the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.create_contact_flow( InstanceId='string', Name='string', Type='CONTACT_FLOW'|'CUSTOMER_QUEUE'|'CUSTOMER_HOLD'|'CUSTOMER_WHISPER'|'AGENT_HOLD'|'AGENT_WHISPER'|'OUTBOUND_WHISPER'|'AGENT_TRANSFER'|'QUEUE_TRANSFER', Description='string', Content='string', Tags={ 'string': 'string' } )
string
[REQUIRED]
The identifier of the Amazon Connect instance.
string
[REQUIRED]
The name of the contact flow.
string
[REQUIRED]
The type of the contact flow. For descriptions of the available types, see Choose a Contact Flow Type in the Amazon Connect Administrator Guide .
string
The description of the contact flow.
string
[REQUIRED]
The content of the contact flow.
dict
One or more tags.
(string) --
(string) --
dict
Response Syntax
{ 'ContactFlowId': 'string', 'ContactFlowArn': 'string' }
Response Structure
(dict) --
ContactFlowId (string) --
The identifier of the contact flow.
ContactFlowArn (string) --
The Amazon Resource Name (ARN) of the contact flow.
Provides information about the prompts for the specified Amazon Connect instance.
See also: AWS API Documentation
Request Syntax
client.list_prompts( InstanceId='string', NextToken='string', MaxResults=123 )
string
[REQUIRED]
The identifier of the Amazon Connect 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
Response Syntax
{ 'PromptSummaryList': [ { 'Id': 'string', 'Arn': 'string', 'Name': 'string' }, ], 'NextToken': 'string' }
Response Structure
(dict) --
PromptSummaryList (list) --
Information about the prompts.
(dict) --
Contains information about the prompt.
Id (string) --
The identifier of the prompt.
Arn (string) --
The Amazon Resource Name (ARN) of the prompt.
Name (string) --
The name of the prompt.
NextToken (string) --
If there are additional results, this is the token for the next set of results.
The name of the contact flow.
See also: AWS API Documentation
Request Syntax
client.update_contact_flow_name( InstanceId='string', ContactFlowId='string', Name='string', Description='string' )
string
[REQUIRED]
The identifier of the Amazon Connect instance.
string
[REQUIRED]
The identifier of the contact flow.
string
The name of the contact flow.
string
The description of the contact flow.
None
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', 'Concurrency': 123 }, ] )
string
[REQUIRED]
The identifier of the Amazon Connect instance.
string
[REQUIRED]
The identifier of the routing profile.
list
[REQUIRED]
The channels 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.
None
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' }, 'Priority': 123, 'Delay': 123 }, ] )
string
[REQUIRED]
The identifier of the Amazon Connect instance.
string
[REQUIRED]
The identifier of the routing profile.
list
[REQUIRED]
The queues to be updated for 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 of 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
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' }, 'Priority': 123, 'Delay': 123 }, ] )
string
[REQUIRED]
The identifier of the Amazon Connect 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 of 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
List 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.
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 maximimum number of results to return per page.
dict
Response Syntax
{ 'NextToken': 'string', 'RoutingProfileQueueConfigSummaryList': [ { 'QueueId': 'string', 'QueueArn': 'string', 'QueueName': 'string', 'Priority': 123, 'Delay': 123, 'Channel': 'VOICE'|'CHAT' }, ] }
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 of 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.
Describes the specified contact flow.
See also: AWS API Documentation
Request Syntax
client.describe_contact_flow( InstanceId='string', ContactFlowId='string' )
string
[REQUIRED]
The identifier of the Amazon Connect instance.
string
[REQUIRED]
The identifier of the contact flow.
dict
Response Syntax
{ 'ContactFlow': { 'Arn': 'string', 'Id': 'string', 'Name': 'string', 'Type': 'CONTACT_FLOW'|'CUSTOMER_QUEUE'|'CUSTOMER_HOLD'|'CUSTOMER_WHISPER'|'AGENT_HOLD'|'AGENT_WHISPER'|'OUTBOUND_WHISPER'|'AGENT_TRANSFER'|'QUEUE_TRANSFER', 'Description': 'string', 'Content': 'string', 'Tags': { 'string': 'string' } } }
Response Structure
(dict) --
ContactFlow (dict) --
Information about the contact flow.
Arn (string) --
The Amazon Resource Name (ARN) of the contact flow.
Id (string) --
The identifier of the contact flow.
Name (string) --
The name of the contact flow.
Type (string) --
The type of the contact flow. For descriptions of the available types, see Choose a Contact Flow Type in the Amazon Connect Administrator Guide .
Description (string) --
The description of the contact flow.
Content (string) --
The content of the contact flow.
Tags (dict) --
One or more tags.
(string) --
(string) --
Updates the specified contact flow.
See also: AWS API Documentation
Request Syntax
client.update_contact_flow_content( InstanceId='string', ContactFlowId='string', Content='string' )
string
[REQUIRED]
The identifier of the Amazon Connect instance.
string
[REQUIRED]
The identifier of the contact flow.
string
[REQUIRED]
The content of the contact flow.
None
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.
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', 'Concurrency': 123 }, ], 'DefaultOutboundQueueId': 'string', 'Tags': { 'string': 'string' } } }
Response Structure
(dict) --
RoutingProfile (dict) --
The routing profile.
InstanceId (string) --
The identifier of the Amazon Connect 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.
DefaultOutboundQueueId (string) --
The identifier of the default outbound queue for this routing profile.
Tags (dict) --
One or more tags.
(string) --
(string) --
Updates the default outbound queue of a routing profile.
See also: AWS API Documentation
Request Syntax
client.update_routing_profile_default_outbound_queue( InstanceId='string', RoutingProfileId='string', DefaultOutboundQueueId='string' )
string
[REQUIRED]
The identifier of the Amazon Connect instance.
string
[REQUIRED]
The identifier of the routing profile.
string
[REQUIRED]
The identifier for the default outbound queue.
None
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' }, ] )
string
[REQUIRED]
The identifier of the Amazon Connect 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 of the queue.
Channel (string) -- [REQUIRED]
The channels agents can handle in the Contact Control Panel (CCP) for this routing profile.
None
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' }, 'Priority': 123, 'Delay': 123 }, ], MediaConcurrencies=[ { 'Channel': 'VOICE'|'CHAT', 'Concurrency': 123 }, ], Tags={ 'string': 'string' } )
string
[REQUIRED]
The identifier of the Amazon Connect 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 only make outbound calls.
(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 of 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 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.
dict
One or more tags.
(string) --
(string) --
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.