Interface ConnectParticipantClient

All Superinterfaces:

AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient

@Generated("software.amazon.awssdk:codegen")
@ThreadSafe
public interface ConnectParticipantClient
extends AwsClient

Service client for accessing Amazon Connect Participant. This can be created using the static builder() method.

• Participant Service actions

• Participant Service data types

Amazon Connect is an easy-to-use omnichannel cloud contact center service that enables companies of any size to deliver superior customer service at a lower cost. Amazon Connect communications capabilities make it easy for companies to deliver personalized interactions across communication channels, including chat.

Use the Amazon Connect Participant Service to manage participants (for example, agents, customers, and managers listening in), and to send messages and events within a chat contact. The APIs in the service enable the following: sending chat messages, attachment sharing, managing a participant's connection state and message events, and retrieving chat transcripts.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	SERVICE_METADATA_ID	Value for looking up the service's metadata from the ServiceMetadataProvider.
static final String	SERVICE_NAME

Method Summary

Modifier and Type	Method	Description
static ConnectParticipantClientBuilder	builder()	Create a builder that can be used to configure and create a ConnectParticipantClient.
default CancelParticipantAuthenticationResponse	cancelParticipantAuthentication(Consumer<CancelParticipantAuthenticationRequest.Builder> cancelParticipantAuthenticationRequest)	Cancels the authentication session.
default CancelParticipantAuthenticationResponse	cancelParticipantAuthentication(CancelParticipantAuthenticationRequest cancelParticipantAuthenticationRequest)	Cancels the authentication session.
default CompleteAttachmentUploadResponse	completeAttachmentUpload(Consumer<CompleteAttachmentUploadRequest.Builder> completeAttachmentUploadRequest)	Allows you to confirm that the attachment has been uploaded using the pre-signed URL provided in StartAttachmentUpload API.
default CompleteAttachmentUploadResponse	completeAttachmentUpload(CompleteAttachmentUploadRequest completeAttachmentUploadRequest)	Allows you to confirm that the attachment has been uploaded using the pre-signed URL provided in StartAttachmentUpload API.
static ConnectParticipantClient	create()	Create a ConnectParticipantClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
default CreateParticipantConnectionResponse	createParticipantConnection(Consumer<CreateParticipantConnectionRequest.Builder> createParticipantConnectionRequest)	Creates the participant's connection.
default CreateParticipantConnectionResponse	createParticipantConnection(CreateParticipantConnectionRequest createParticipantConnectionRequest)	Creates the participant's connection.
default DescribeViewResponse	describeView(Consumer<DescribeViewRequest.Builder> describeViewRequest)	Retrieves the view for the specified view token.
default DescribeViewResponse	describeView(DescribeViewRequest describeViewRequest)	Retrieves the view for the specified view token.
default DisconnectParticipantResponse	disconnectParticipant(Consumer<DisconnectParticipantRequest.Builder> disconnectParticipantRequest)	Disconnects a participant.
default DisconnectParticipantResponse	disconnectParticipant(DisconnectParticipantRequest disconnectParticipantRequest)	Disconnects a participant.
default GetAttachmentResponse	getAttachment(Consumer<GetAttachmentRequest.Builder> getAttachmentRequest)	Provides a pre-signed URL for download of a completed attachment.
default GetAttachmentResponse	getAttachment(GetAttachmentRequest getAttachmentRequest)	Provides a pre-signed URL for download of a completed attachment.
default GetAuthenticationUrlResponse	getAuthenticationUrl(Consumer<GetAuthenticationUrlRequest.Builder> getAuthenticationUrlRequest)	Retrieves the AuthenticationUrl for the current authentication session for the AuthenticateCustomer flow block.
default GetAuthenticationUrlResponse	getAuthenticationUrl(GetAuthenticationUrlRequest getAuthenticationUrlRequest)	Retrieves the AuthenticationUrl for the current authentication session for the AuthenticateCustomer flow block.
default GetTranscriptResponse	getTranscript(Consumer<GetTranscriptRequest.Builder> getTranscriptRequest)	Retrieves a transcript of the session, including details about any attachments.
default GetTranscriptResponse	getTranscript(GetTranscriptRequest getTranscriptRequest)	Retrieves a transcript of the session, including details about any attachments.
default GetTranscriptIterable	getTranscriptPaginator(Consumer<GetTranscriptRequest.Builder> getTranscriptRequest)	This is a variant of getTranscript(software.amazon.awssdk.services.connectparticipant.model.GetTranscriptRequest) operation.
default GetTranscriptIterable	getTranscriptPaginator(GetTranscriptRequest getTranscriptRequest)	This is a variant of getTranscript(software.amazon.awssdk.services.connectparticipant.model.GetTranscriptRequest) operation.
default SendEventResponse	sendEvent(Consumer<SendEventRequest.Builder> sendEventRequest)
default SendEventResponse	sendEvent(SendEventRequest sendEventRequest)
default SendMessageResponse	sendMessage(Consumer<SendMessageRequest.Builder> sendMessageRequest)	Sends a message.
default SendMessageResponse	sendMessage(SendMessageRequest sendMessageRequest)	Sends a message.
default ConnectParticipantServiceClientConfiguration	serviceClientConfiguration()	The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
static ServiceMetadata	serviceMetadata()
default StartAttachmentUploadResponse	startAttachmentUpload(Consumer<StartAttachmentUploadRequest.Builder> startAttachmentUploadRequest)	Provides a pre-signed Amazon S3 URL in response for uploading the file directly to S3.
default StartAttachmentUploadResponse	startAttachmentUpload(StartAttachmentUploadRequest startAttachmentUploadRequest)	Provides a pre-signed Amazon S3 URL in response for uploading the file directly to S3.

Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable

close

Methods inherited from interface software.amazon.awssdk.core.SdkClient

serviceName

Field Details

SERVICE_NAME

static final String SERVICE_NAME

See Also:

• Constant Field Values

SERVICE_METADATA_ID

static final String SERVICE_METADATA_ID

Value for looking up the service's metadata from the ServiceMetadataProvider.

See Also:

• Constant Field Values

Method Details

cancelParticipantAuthentication

default CancelParticipantAuthenticationResponse cancelParticipantAuthentication(CancelParticipantAuthenticationRequest cancelParticipantAuthenticationRequest)
                                                                         throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Cancels the authentication session. The opted out branch of the Authenticate Customer flow block will be taken.

The current supported channel is chat. This API is not supported for Apple Messages for Business, WhatsApp, or SMS chats.

Parameters:

cancelParticipantAuthenticationRequest -

Returns:

Result of the CancelParticipantAuthentication operation returned by the service.

See Also:

• AWS API Documentation

cancelParticipantAuthentication

default CancelParticipantAuthenticationResponse cancelParticipantAuthentication(Consumer<CancelParticipantAuthenticationRequest.Builder> cancelParticipantAuthenticationRequest)
                                                                         throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Cancels the authentication session. The opted out branch of the Authenticate Customer flow block will be taken.

The current supported channel is chat. This API is not supported for Apple Messages for Business, WhatsApp, or SMS chats.

This is a convenience which creates an instance of the CancelParticipantAuthenticationRequest.Builder avoiding the need to create one manually via CancelParticipantAuthenticationRequest.builder()

Parameters:

cancelParticipantAuthenticationRequest - A Consumer that will call methods on CancelParticipantAuthenticationRequest.Builder to create a request.

Returns:

Result of the CancelParticipantAuthentication operation returned by the service.

See Also:

• AWS API Documentation

completeAttachmentUpload

default CompleteAttachmentUploadResponse completeAttachmentUpload(CompleteAttachmentUploadRequest completeAttachmentUploadRequest)
                                                           throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
ServiceQuotaExceededException,
ConflictException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Allows you to confirm that the attachment has been uploaded using the pre-signed URL provided in StartAttachmentUpload API. A conflict exception is thrown when an attachment with that identifier is already being uploaded.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

Parameters:

completeAttachmentUploadRequest -

Returns:

Result of the CompleteAttachmentUpload operation returned by the service.

See Also:

• AWS API Documentation

completeAttachmentUpload

default CompleteAttachmentUploadResponse completeAttachmentUpload(Consumer<CompleteAttachmentUploadRequest.Builder> completeAttachmentUploadRequest)
                                                           throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
ServiceQuotaExceededException,
ConflictException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Allows you to confirm that the attachment has been uploaded using the pre-signed URL provided in StartAttachmentUpload API. A conflict exception is thrown when an attachment with that identifier is already being uploaded.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

This is a convenience which creates an instance of the CompleteAttachmentUploadRequest.Builder avoiding the need to create one manually via CompleteAttachmentUploadRequest.builder()

Parameters:

completeAttachmentUploadRequest - A Consumer that will call methods on CompleteAttachmentUploadRequest.Builder to create a request.

Returns:

Result of the CompleteAttachmentUpload operation returned by the service.

See Also:

• AWS API Documentation

createParticipantConnection

default CreateParticipantConnectionResponse createParticipantConnection(CreateParticipantConnectionRequest createParticipantConnectionRequest)
                                                                 throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Creates the participant's connection.

For security recommendations, see Amazon Connect Chat security best practices.

ParticipantToken is used for invoking this API instead of ConnectionToken.

The participant token is valid for the lifetime of the participant – until they are part of a contact.

The response URL for WEBSOCKET Type has a connect expiry timeout of 100s. Clients must manually connect to the returned websocket URL and subscribe to the desired topic.

For chat, you need to publish the following on the established websocket connection:

{"topic":"aws/subscribe","content":{"topics":["aws/chat"]}}

Upon websocket URL expiry, as specified in the response ConnectionExpiry parameter, clients need to call this API again to obtain a new websocket URL and perform the same steps as before.

Message streaming support: This API can also be used together with the StartContactStreaming API to create a participant connection for chat contacts that are not using a websocket. For more information about message streaming, Enable real-time chat message streaming in the Amazon Connect Administrator Guide.

Feature specifications: For information about feature specifications, such as the allowed number of open websocket connections per participant, see Feature specifications in the Amazon Connect Administrator Guide.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

Parameters:

createParticipantConnectionRequest -

Returns:

Result of the CreateParticipantConnection operation returned by the service.

See Also:

• AWS API Documentation

createParticipantConnection

default CreateParticipantConnectionResponse createParticipantConnection(Consumer<CreateParticipantConnectionRequest.Builder> createParticipantConnectionRequest)
                                                                 throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Creates the participant's connection.

For security recommendations, see Amazon Connect Chat security best practices.

ParticipantToken is used for invoking this API instead of ConnectionToken.

The participant token is valid for the lifetime of the participant – until they are part of a contact.

The response URL for WEBSOCKET Type has a connect expiry timeout of 100s. Clients must manually connect to the returned websocket URL and subscribe to the desired topic.

For chat, you need to publish the following on the established websocket connection:

{"topic":"aws/subscribe","content":{"topics":["aws/chat"]}}

Upon websocket URL expiry, as specified in the response ConnectionExpiry parameter, clients need to call this API again to obtain a new websocket URL and perform the same steps as before.

Message streaming support: This API can also be used together with the StartContactStreaming API to create a participant connection for chat contacts that are not using a websocket. For more information about message streaming, Enable real-time chat message streaming in the Amazon Connect Administrator Guide.

Feature specifications: For information about feature specifications, such as the allowed number of open websocket connections per participant, see Feature specifications in the Amazon Connect Administrator Guide.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

This is a convenience which creates an instance of the CreateParticipantConnectionRequest.Builder avoiding the need to create one manually via CreateParticipantConnectionRequest.builder()

Parameters:

createParticipantConnectionRequest - A Consumer that will call methods on CreateParticipantConnectionRequest.Builder to create a request.

Returns:

Result of the CreateParticipantConnection operation returned by the service.

See Also:

• AWS API Documentation

describeView

default DescribeViewResponse describeView(DescribeViewRequest describeViewRequest)
                                   throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ResourceNotFoundException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Retrieves the view for the specified view token.

For security recommendations, see Amazon Connect Chat security best practices.

Parameters:

describeViewRequest -

Returns:

Result of the DescribeView operation returned by the service.

See Also:

• AWS API Documentation

describeView

default DescribeViewResponse describeView(Consumer<DescribeViewRequest.Builder> describeViewRequest)
                                   throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ResourceNotFoundException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Retrieves the view for the specified view token.

For security recommendations, see Amazon Connect Chat security best practices.

This is a convenience which creates an instance of the DescribeViewRequest.Builder avoiding the need to create one manually via DescribeViewRequest.builder()

Parameters:

describeViewRequest - A Consumer that will call methods on DescribeViewRequest.Builder to create a request.

Returns:

Result of the DescribeView operation returned by the service.

See Also:

• AWS API Documentation

disconnectParticipant

default DisconnectParticipantResponse disconnectParticipant(DisconnectParticipantRequest disconnectParticipantRequest)
                                                     throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Disconnects a participant.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

Parameters:

disconnectParticipantRequest -

Returns:

Result of the DisconnectParticipant operation returned by the service.

See Also:

• AWS API Documentation

disconnectParticipant

default DisconnectParticipantResponse disconnectParticipant(Consumer<DisconnectParticipantRequest.Builder> disconnectParticipantRequest)
                                                     throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Disconnects a participant.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

This is a convenience which creates an instance of the DisconnectParticipantRequest.Builder avoiding the need to create one manually via DisconnectParticipantRequest.builder()

Parameters:

disconnectParticipantRequest - A Consumer that will call methods on DisconnectParticipantRequest.Builder to create a request.

Returns:

Result of the DisconnectParticipant operation returned by the service.

See Also:

• AWS API Documentation

getAttachment

default GetAttachmentResponse getAttachment(GetAttachmentRequest getAttachmentRequest)
                                     throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Provides a pre-signed URL for download of a completed attachment. This is an asynchronous API for use with active contacts.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

Parameters:

getAttachmentRequest -

Returns:

Result of the GetAttachment operation returned by the service.

See Also:

• AWS API Documentation

getAttachment

default GetAttachmentResponse getAttachment(Consumer<GetAttachmentRequest.Builder> getAttachmentRequest)
                                     throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Provides a pre-signed URL for download of a completed attachment. This is an asynchronous API for use with active contacts.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

This is a convenience which creates an instance of the GetAttachmentRequest.Builder avoiding the need to create one manually via GetAttachmentRequest.builder()

Parameters:

getAttachmentRequest - A Consumer that will call methods on GetAttachmentRequest.Builder to create a request.

Returns:

Result of the GetAttachment operation returned by the service.

See Also:

• AWS API Documentation

getAuthenticationUrl

default GetAuthenticationUrlResponse getAuthenticationUrl(GetAuthenticationUrlRequest getAuthenticationUrlRequest)
                                                   throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Retrieves the AuthenticationUrl for the current authentication session for the AuthenticateCustomer flow block.

For security recommendations, see Amazon Connect Chat security best practices.

• This API can only be called within one minute of receiving the authenticationInitiated event.

• The current supported channel is chat. This API is not supported for Apple Messages for Business, WhatsApp, or SMS chats.

Parameters:

getAuthenticationUrlRequest -

Returns:

Result of the GetAuthenticationUrl operation returned by the service.

See Also:

• AWS API Documentation

getAuthenticationUrl

default GetAuthenticationUrlResponse getAuthenticationUrl(Consumer<GetAuthenticationUrlRequest.Builder> getAuthenticationUrlRequest)
                                                   throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Retrieves the AuthenticationUrl for the current authentication session for the AuthenticateCustomer flow block.

For security recommendations, see Amazon Connect Chat security best practices.

• This API can only be called within one minute of receiving the authenticationInitiated event.

• The current supported channel is chat. This API is not supported for Apple Messages for Business, WhatsApp, or SMS chats.

This is a convenience which creates an instance of the GetAuthenticationUrlRequest.Builder avoiding the need to create one manually via GetAuthenticationUrlRequest.builder()

Parameters:

getAuthenticationUrlRequest - A Consumer that will call methods on GetAuthenticationUrlRequest.Builder to create a request.

Returns:

Result of the GetAuthenticationUrl operation returned by the service.

See Also:

• AWS API Documentation

getTranscript

default GetTranscriptResponse getTranscript(GetTranscriptRequest getTranscriptRequest)
                                     throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Retrieves a transcript of the session, including details about any attachments. For information about accessing past chat contact transcripts for a persistent chat, see Enable persistent chat.

For security recommendations, see Amazon Connect Chat security best practices.

If you have a process that consumes events in the transcript of an chat that has ended, note that chat transcripts contain the following event content types if the event has occurred during the chat session:

• application/vnd.amazonaws.connect.event.participant.left

• application/vnd.amazonaws.connect.event.participant.joined

• application/vnd.amazonaws.connect.event.chat.ended

• application/vnd.amazonaws.connect.event.transfer.succeeded

• application/vnd.amazonaws.connect.event.transfer.failed

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

Parameters:

getTranscriptRequest -

Returns:

Result of the GetTranscript operation returned by the service.

See Also:

• AWS API Documentation

getTranscript

default GetTranscriptResponse getTranscript(Consumer<GetTranscriptRequest.Builder> getTranscriptRequest)
                                     throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Retrieves a transcript of the session, including details about any attachments. For information about accessing past chat contact transcripts for a persistent chat, see Enable persistent chat.

For security recommendations, see Amazon Connect Chat security best practices.

If you have a process that consumes events in the transcript of an chat that has ended, note that chat transcripts contain the following event content types if the event has occurred during the chat session:

• application/vnd.amazonaws.connect.event.participant.left

• application/vnd.amazonaws.connect.event.participant.joined

• application/vnd.amazonaws.connect.event.chat.ended

• application/vnd.amazonaws.connect.event.transfer.succeeded

• application/vnd.amazonaws.connect.event.transfer.failed

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

This is a convenience which creates an instance of the GetTranscriptRequest.Builder avoiding the need to create one manually via GetTranscriptRequest.builder()

Parameters:

getTranscriptRequest - A Consumer that will call methods on GetTranscriptRequest.Builder to create a request.

Returns:

Result of the GetTranscript operation returned by the service.

See Also:

• AWS API Documentation

getTranscriptPaginator

default GetTranscriptIterable getTranscriptPaginator(GetTranscriptRequest getTranscriptRequest)
                                              throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

This is a variant of getTranscript(software.amazon.awssdk.services.connectparticipant.model.GetTranscriptRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.connectparticipant.paginators.GetTranscriptIterable responses = client.getTranscriptPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.connectparticipant.paginators.GetTranscriptIterable responses = client
             .getTranscriptPaginator(request);
     for (software.amazon.awssdk.services.connectparticipant.model.GetTranscriptResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.connectparticipant.paginators.GetTranscriptIterable responses = client.getTranscriptPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the getTranscript(software.amazon.awssdk.services.connectparticipant.model.GetTranscriptRequest) operation.

Parameters:

getTranscriptRequest -

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

getTranscriptPaginator

default GetTranscriptIterable getTranscriptPaginator(Consumer<GetTranscriptRequest.Builder> getTranscriptRequest)
                                              throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

This is a variant of getTranscript(software.amazon.awssdk.services.connectparticipant.model.GetTranscriptRequest) operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.

When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.

The following are few ways to iterate through the response pages:

1) Using a Stream

 
 software.amazon.awssdk.services.connectparticipant.paginators.GetTranscriptIterable responses = client.getTranscriptPaginator(request);
 responses.stream().forEach(....);
 
 

2) Using For loop

 {
     @code
     software.amazon.awssdk.services.connectparticipant.paginators.GetTranscriptIterable responses = client
             .getTranscriptPaginator(request);
     for (software.amazon.awssdk.services.connectparticipant.model.GetTranscriptResponse response : responses) {
         // do something;
     }
 }
 

3) Use iterator directly

 
 software.amazon.awssdk.services.connectparticipant.paginators.GetTranscriptIterable responses = client.getTranscriptPaginator(request);
 responses.iterator().forEachRemaining(....);
 
 

Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

Note: If you prefer to have control on service calls, use the getTranscript(software.amazon.awssdk.services.connectparticipant.model.GetTranscriptRequest) operation.

This is a convenience which creates an instance of the GetTranscriptRequest.Builder avoiding the need to create one manually via GetTranscriptRequest.builder()

Parameters:

getTranscriptRequest - A Consumer that will call methods on GetTranscriptRequest.Builder to create a request.

Returns:

A custom iterable that can be used to iterate through all the response pages.

See Also:

• AWS API Documentation

sendEvent

default SendEventResponse sendEvent(SendEventRequest sendEventRequest)
                             throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
ConflictException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

The application/vnd.amazonaws.connect.event.connection.acknowledged ContentType will no longer be supported starting December 31, 2024. This event has been migrated to the CreateParticipantConnection API using the ConnectParticipant field.

Sends an event. Message receipts are not supported when there are more than two active participants in the chat. Using the SendEvent API for message receipts when a supervisor is barged-in will result in a conflict exception.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

Parameters:

sendEventRequest -

Returns:

Result of the SendEvent operation returned by the service.

See Also:

• AWS API Documentation

sendEvent

default SendEventResponse sendEvent(Consumer<SendEventRequest.Builder> sendEventRequest)
                             throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
ConflictException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

The application/vnd.amazonaws.connect.event.connection.acknowledged ContentType will no longer be supported starting December 31, 2024. This event has been migrated to the CreateParticipantConnection API using the ConnectParticipant field.

Sends an event. Message receipts are not supported when there are more than two active participants in the chat. Using the SendEvent API for message receipts when a supervisor is barged-in will result in a conflict exception.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

This is a convenience which creates an instance of the SendEventRequest.Builder avoiding the need to create one manually via SendEventRequest.builder()

Parameters:

sendEventRequest - A Consumer that will call methods on SendEventRequest.Builder to create a request.

Returns:

Result of the SendEvent operation returned by the service.

See Also:

• AWS API Documentation

sendMessage

default SendMessageResponse sendMessage(SendMessageRequest sendMessageRequest)
                                 throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Sends a message.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

Parameters:

sendMessageRequest -

Returns:

Result of the SendMessage operation returned by the service.

See Also:

• AWS API Documentation

sendMessage

default SendMessageResponse sendMessage(Consumer<SendMessageRequest.Builder> sendMessageRequest)
                                 throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Sends a message.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

This is a convenience which creates an instance of the SendMessageRequest.Builder avoiding the need to create one manually via SendMessageRequest.builder()

Parameters:

sendMessageRequest - A Consumer that will call methods on SendMessageRequest.Builder to create a request.

Returns:

Result of the SendMessage operation returned by the service.

See Also:

• AWS API Documentation

startAttachmentUpload

default StartAttachmentUploadResponse startAttachmentUpload(StartAttachmentUploadRequest startAttachmentUploadRequest)
                                                     throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
ServiceQuotaExceededException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Provides a pre-signed Amazon S3 URL in response for uploading the file directly to S3.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

Parameters:

startAttachmentUploadRequest -

Returns:

Result of the StartAttachmentUpload operation returned by the service.

See Also:

• AWS API Documentation

startAttachmentUpload

default StartAttachmentUploadResponse startAttachmentUpload(Consumer<StartAttachmentUploadRequest.Builder> startAttachmentUploadRequest)
                                                     throws AccessDeniedException,
InternalServerException,
ThrottlingException,
ValidationException,
ServiceQuotaExceededException,
AwsServiceException,
SdkClientException,
ConnectParticipantException

Provides a pre-signed Amazon S3 URL in response for uploading the file directly to S3.

For security recommendations, see Amazon Connect Chat security best practices.

ConnectionToken is used for invoking this API instead of ParticipantToken.

The Amazon Connect Participant Service APIs do not use Signature Version 4 authentication.

This is a convenience which creates an instance of the StartAttachmentUploadRequest.Builder avoiding the need to create one manually via StartAttachmentUploadRequest.builder()

Parameters:

startAttachmentUploadRequest - A Consumer that will call methods on StartAttachmentUploadRequest.Builder to create a request.

Returns:

Result of the StartAttachmentUpload operation returned by the service.

See Also:

• AWS API Documentation

create

static ConnectParticipantClient create()

Create a ConnectParticipantClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

builder

static ConnectParticipantClientBuilder builder()

Create a builder that can be used to configure and create a ConnectParticipantClient.

serviceMetadata

static ServiceMetadata serviceMetadata()

serviceClientConfiguration

default ConnectParticipantServiceClientConfiguration serviceClientConfiguration()

Description copied from interface: SdkClient

The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration

Specified by:

serviceClientConfiguration in interface AwsClient

Specified by:

serviceClientConfiguration in interface SdkClient

Returns:

SdkServiceClientConfiguration