AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Initiates a flow to start a new chat for the customer. Response of this API provides a token required to obtain credentials from the CreateParticipantConnection API in the Amazon Connect Participant Service.
When a new chat contact is successfully created, clients must subscribe to the participant’s connection for the created chat within 5 minutes. This is achieved by invoking CreateParticipantConnection with WEBSOCKET and CONNECTION_CREDENTIALS.
A 429 error occurs in the following situations:
API rate limit is exceeded. API TPS throttling returns a TooManyRequests exception.
The quota
for concurrent active chats is exceeded. Active chat throttling returns a LimitExceededException.
If you use the ChatDurationInMinutes parameter and receive a 400 error, your
account may not support the ability to configure custom chat durations. For more information,
contact Amazon Web Services Support.
For more information about chat, see the following topics in the Amazon Connect Administrator Guide:
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginStartChatContact and EndStartChatContact.
Namespace: Amazon.Connect
Assembly: AWSSDK.Connect.dll
Version: 3.x.y.z
public abstract Task<StartChatContactResponse> StartChatContactAsync( StartChatContactRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the StartChatContact service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| InternalServiceException | Request processing failed because of an error or failure with the service. |
| InvalidParameterException | One or more of the specified parameters are not valid. |
| InvalidRequestException | The request is not valid. |
| LimitExceededException | The allowed limit for the resource has been exceeded. |
| ResourceNotFoundException | The specified resource was not found. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer