2022/12/22 - Amazon Connect Service - 1 new api methods
Changes Amazon Connect Chat introduces the Idle Participant/Autodisconnect feature, which allows users to set timeouts relating to the activity of chat participants, using the new UpdateParticipantRoleConfig API.
Updates timeouts for when human chat participants are to be considered idle, and when agents are automatically disconnected from a chat due to idleness. You can set four timers:
Customer idle timeout
Customer auto-disconnect timeout
Agent idle timeout
Agent auto-disconnect timeout
For more information about how chat timeouts work, see Set up chat timeouts for human participants .
See also: AWS API Documentation
Request Syntax
client.update_participant_role_config( InstanceId='string', ContactId='string', ChannelConfiguration={ 'Chat': { 'ParticipantTimerConfigList': [ { 'ParticipantRole': 'CUSTOMER'|'AGENT', 'TimerType': 'IDLE'|'DISCONNECT_NONCUSTOMER', 'TimerValue': { 'ParticipantTimerAction': 'Unset', 'ParticipantTimerDurationInMinutes': 123 } }, ] } } )
string
[REQUIRED]
The identifier of the Amazon Connect instance. You can find the instanceId in the ARN of the instance.
string
[REQUIRED]
The identifier of the contact in this instance of Amazon Connect.
dict
[REQUIRED]
The Amazon Connect channel you want to configure.
Chat (dict) --
Configuration information for the chat participant role.
ParticipantTimerConfigList (list) -- [REQUIRED]
A list of participant timers. You can specify any unique combination of role and timer type. Duplicate entries error out the request with a 400.
(dict) --
Configuration information for the timer. After the timer configuration is set, it persists for the duration of the chat. It persists across new contacts in the chain, for example, transfer contacts.
For more information about how chat timeouts work, see Set up chat timeouts for human participants .
ParticipantRole (string) -- [REQUIRED]
The role of the participant in the chat conversation.
TimerType (string) -- [REQUIRED]
The type of timer. IDLE indicates the timer applies for considering a human chat participant as idle. DISCONNECT_NONCUSTOMER indicates the timer applies to automatically disconnecting a chat participant due to idleness.
TimerValue (dict) -- [REQUIRED]
The value of the timer. Either the timer action (Unset to delete the timer), or the duration of the timer in minutes. Only one value can be set.
ParticipantTimerAction (string) --
The timer action. Currently only one value is allowed: Unset . It deletes a timer.
ParticipantTimerDurationInMinutes (integer) --
The duration of a timer, in minutes.
dict
Response Syntax
{}
Response Structure
(dict) --