com.amazonaws.services.connectparticipant

Class AmazonConnectParticipantClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.connectparticipant.AmazonConnectParticipantClient

All Implemented Interfaces:

AmazonConnectParticipant

Direct Known Subclasses:

AmazonConnectParticipantAsyncClient

public class AmazonConnectParticipantClient
extends AmazonWebServiceClient
implements AmazonConnectParticipant

Client for accessing Amazon Connect Participant. All service calls made using this client are blocking, and will not return until the service call completes.

Amazon Connect is a cloud-based contact center solution that makes it easy to set up and manage a customer contact center and provide reliable customer engagement at any scale.

Amazon Connect enables customer contacts through voice or chat.

The APIs described here are used by chat participants, such as agents and customers.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Constructor Summary

Constructors

Constructor and Description
AmazonConnectParticipantClient() Constructs a new client to invoke service methods on AmazonConnectParticipant.
AmazonConnectParticipantClient(ClientConfiguration clientConfiguration) Constructs a new client to invoke service methods on AmazonConnectParticipant.
AmazonConnectParticipantClient(ClientConfiguration clientConfiguration, HttpClient httpClient) Constructs a new client to invoke service methods on AmazonConnectParticipant using the specified client configuration options and request metric collector.
AmazonConnectParticipantClient(ClientConfiguration clientConfiguration, com.amazonaws.metrics.RequestMetricCollector requestMetricCollector) Constructs a new client to invoke service methods on AmazonConnectParticipant using the specified client configuration options and request metric collector.

Method Summary

Modifier and Type	Method and Description
CompleteAttachmentUploadResult	completeAttachmentUpload(CompleteAttachmentUploadRequest completeAttachmentUploadRequest) Allows you to confirm that the attachment has been uploaded using the pre-signed URL provided in StartAttachmentUpload API.
CreateParticipantConnectionResult	createParticipantConnection(CreateParticipantConnectionRequest createParticipantConnectionRequest) Creates the participant's connection.
DisconnectParticipantResult	disconnectParticipant(DisconnectParticipantRequest disconnectParticipantRequest) Disconnects a participant.
GetAttachmentResult	getAttachment(GetAttachmentRequest getAttachmentRequest) Provides a pre-signed URL for download of a completed attachment.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Deprecated. ResponseMetadata cache can hold up to 50 requests and responses in memory and will cause memory issue. This method now always returns null.
GetTranscriptResult	getTranscript(GetTranscriptRequest getTranscriptRequest) Retrieves a transcript of the session, including details about any attachments.
SendEventResult	sendEvent(SendEventRequest sendEventRequest) Sends an event.
SendMessageResult	sendMessage(SendMessageRequest sendMessageRequest) Sends a message.
StartAttachmentUploadResult	startAttachmentUpload(StartAttachmentUploadRequest startAttachmentUploadRequest) Provides a pre-signed Amazon S3 URL in response for uploading the file directly to S3.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, getEndpoint, getEndpointPrefix, getRegions, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerRegionOverride, getTimeOffset, removeRequestHandler, removeRequestHandler, setConfiguration, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.amazonaws.services.connectparticipant.AmazonConnectParticipant

setEndpoint, setRegion, shutdown

Constructor Detail

AmazonConnectParticipantClient

public AmazonConnectParticipantClient()

Constructs a new client to invoke service methods on AmazonConnectParticipant.

All service calls made using this new client object are blocking, and will not return until the service call completes.

AmazonConnectParticipantClient

public AmazonConnectParticipantClient(ClientConfiguration clientConfiguration)

Constructs a new client to invoke service methods on AmazonConnectParticipant. All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

clientConfiguration - The client configuration options controlling how this client connects to AmazonConnectParticipant (ex: proxy settings, retry counts, etc.).

AmazonConnectParticipantClient

public AmazonConnectParticipantClient(ClientConfiguration clientConfiguration,
                                      com.amazonaws.metrics.RequestMetricCollector requestMetricCollector)

Constructs a new client to invoke service methods on AmazonConnectParticipant using the specified client configuration options and request metric collector.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

clientConfiguration - The client configuration options controlling how this client connects to AmazonConnectParticipant (ex: proxy settings, retry counts, etc.).

requestMetricCollector - optional request metric collector

AmazonConnectParticipantClient

public AmazonConnectParticipantClient(ClientConfiguration clientConfiguration,
                                      HttpClient httpClient)

Constructs a new client to invoke service methods on AmazonConnectParticipant using the specified client configuration options and request metric collector.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

clientConfiguration - The client configuration options controlling how this client connects to AmazonConnectParticipant (ex: proxy settings, retry counts, etc.).

httpClient - A http client

Method Detail

completeAttachmentUpload

public CompleteAttachmentUploadResult completeAttachmentUpload(CompleteAttachmentUploadRequest completeAttachmentUploadRequest)
                                                        throws AmazonServiceException,
                                                               AmazonClientException

Allows you to confirm that the attachment has been uploaded using the pre-signed URL provided in StartAttachmentUpload API.

Specified by:

completeAttachmentUpload in interface AmazonConnectParticipant

Parameters:

completeAttachmentUploadRequest -

Returns:

completeAttachmentUploadResult The response from the CompleteAttachmentUpload service method, as returned by Amazon Connect Participant.

Throws:

AccessDeniedException

InternalServerException

ThrottlingException

ValidationException

ServiceQuotaExceededException

ConflictException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Connect Participant indicating either a problem with the data in the request, or a server side issue.

createParticipantConnection

public CreateParticipantConnectionResult createParticipantConnection(CreateParticipantConnectionRequest createParticipantConnectionRequest)
                                                              throws AmazonServiceException,
                                                                     AmazonClientException

Creates the participant's connection. Note that 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.

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

Specified by:

createParticipantConnection in interface AmazonConnectParticipant

Parameters:

createParticipantConnectionRequest -

Returns:

createParticipantConnectionResult The response from the CreateParticipantConnection service method, as returned by Amazon Connect Participant.

Throws:

AccessDeniedException

InternalServerException

ThrottlingException

ValidationException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Connect Participant indicating either a problem with the data in the request, or a server side issue.

disconnectParticipant

public DisconnectParticipantResult disconnectParticipant(DisconnectParticipantRequest disconnectParticipantRequest)
                                                  throws AmazonServiceException,
                                                         AmazonClientException

Disconnects a participant. Note that ConnectionToken is used for invoking this API instead of ParticipantToken.

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

Specified by:

disconnectParticipant in interface AmazonConnectParticipant

Parameters:

disconnectParticipantRequest -

Returns:

disconnectParticipantResult The response from the DisconnectParticipant service method, as returned by Amazon Connect Participant.

Throws:

AccessDeniedException

InternalServerException

ThrottlingException

ValidationException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Connect Participant indicating either a problem with the data in the request, or a server side issue.

getAttachment

public GetAttachmentResult getAttachment(GetAttachmentRequest getAttachmentRequest)
                                  throws AmazonServiceException,
                                         AmazonClientException

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

Specified by:

getAttachment in interface AmazonConnectParticipant

Parameters:

getAttachmentRequest -

Returns:

getAttachmentResult The response from the GetAttachment service method, as returned by Amazon Connect Participant.

Throws:

AccessDeniedException

InternalServerException

ThrottlingException

ValidationException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Connect Participant indicating either a problem with the data in the request, or a server side issue.

getTranscript

public GetTranscriptResult getTranscript(GetTranscriptRequest getTranscriptRequest)
                                  throws AmazonServiceException,
                                         AmazonClientException

Retrieves a transcript of the session, including details about any attachments. Note that ConnectionToken is used for invoking this API instead of ParticipantToken.

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

Specified by:

getTranscript in interface AmazonConnectParticipant

Parameters:

getTranscriptRequest -

Returns:

getTranscriptResult The response from the GetTranscript service method, as returned by Amazon Connect Participant.

Throws:

AccessDeniedException

InternalServerException

ThrottlingException

ValidationException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Connect Participant indicating either a problem with the data in the request, or a server side issue.

sendEvent

public SendEventResult sendEvent(SendEventRequest sendEventRequest)
                          throws AmazonServiceException,
                                 AmazonClientException

Sends an event. Note that ConnectionToken is used for invoking this API instead of ParticipantToken.

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

Specified by:

sendEvent in interface AmazonConnectParticipant

Parameters:

sendEventRequest -

Returns:

sendEventResult The response from the SendEvent service method, as returned by Amazon Connect Participant.

Throws:

AccessDeniedException

InternalServerException

ThrottlingException

ValidationException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Connect Participant indicating either a problem with the data in the request, or a server side issue.

sendMessage

public SendMessageResult sendMessage(SendMessageRequest sendMessageRequest)
                              throws AmazonServiceException,
                                     AmazonClientException

Sends a message. Note that ConnectionToken is used for invoking this API instead of ParticipantToken.

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

Specified by:

sendMessage in interface AmazonConnectParticipant

Parameters:

sendMessageRequest -

Returns:

sendMessageResult The response from the SendMessage service method, as returned by Amazon Connect Participant.

Throws:

AccessDeniedException

InternalServerException

ThrottlingException

ValidationException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Connect Participant indicating either a problem with the data in the request, or a server side issue.

startAttachmentUpload

public StartAttachmentUploadResult startAttachmentUpload(StartAttachmentUploadRequest startAttachmentUploadRequest)
                                                  throws AmazonServiceException,
                                                         AmazonClientException

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

Specified by:

startAttachmentUpload in interface AmazonConnectParticipant

Parameters:

startAttachmentUploadRequest -

Returns:

startAttachmentUploadResult The response from the StartAttachmentUpload service method, as returned by Amazon Connect Participant.

Throws:

AccessDeniedException

InternalServerException

ThrottlingException

ValidationException

ServiceQuotaExceededException

AmazonClientException - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.

AmazonServiceException - If an error response is returned by Amazon Connect Participant indicating either a problem with the data in the request, or a server side issue.

getCachedResponseMetadata

@Deprecated
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Deprecated. ResponseMetadata cache can hold up to 50 requests and responses in memory and will cause memory issue. This method now always returns null.

Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.

Specified by:

getCachedResponseMetadata in interface AmazonConnectParticipant

Parameters:

request - The originally executed request

Returns:

The response metadata for the specified request, or null if none is available.