"documentation":"<p>Creates the participant's connection. Note that ParticipantToken is used for invoking this API instead of ConnectionToken.</p> <p>The participant token is valid for the lifetime of the participant – until they are part of a contact.</p> <p>The response URL for <code>WEBSOCKET</code> Type has a connect expiry timeout of 100s. Clients must manually connect to the returned websocket URL and subscribe to the desired topic. </p> <p>For chat, you need to publish the following on the established websocket connection:</p> <p> <code>{\"topic\":\"aws/subscribe\",\"content\":{\"topics\":[\"aws/chat\"]}}</code> </p> <p>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.</p> <note> <p>The Amazon Connect Participant Service APIs do not use <a href=\"https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">Signature Version 4 authentication</a>.</p> </note>"
"documentation":"<p>Disconnects a participant. Note that ConnectionToken is used for invoking this API instead of ParticipantToken.</p> <p>The Amazon Connect Participant Service APIs do not use <a href=\"https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">Signature Version 4 authentication</a>.</p>"
},
"GetAttachment":{
"name":"GetAttachment",
"http":{
"method":"POST",
"requestUri":"/participant/attachment"
},
"input":{"shape":"GetAttachmentRequest"},
"output":{"shape":"GetAttachmentResponse"},
"errors":[
{"shape":"AccessDeniedException"},
{"shape":"InternalServerException"},
{"shape":"ThrottlingException"},
{"shape":"ValidationException"}
],
"documentation":"<p>Provides a pre-signed URL for download of a completed attachment. This is an asynchronous API for use with active contacts.</p>"
"documentation":"<p>Retrieves a transcript of the session, including details about any attachments. Note that ConnectionToken is used for invoking this API instead of ParticipantToken.</p> <p>The Amazon Connect Participant Service APIs do not use <a href=\"https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">Signature Version 4 authentication</a>.</p>"
"documentation":"<p>Sends an event. Note that ConnectionToken is used for invoking this API instead of ParticipantToken.</p> <p>The Amazon Connect Participant Service APIs do not use <a href=\"https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">Signature Version 4 authentication</a>.</p>"
"documentation":"<p>Sends a message. Note that ConnectionToken is used for invoking this API instead of ParticipantToken.</p> <note> <p>The Amazon Connect Participant Service APIs do not use <a href=\"https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">Signature Version 4 authentication</a>.</p> </note>"
"documentation":"<p>Describes the MIME file type of the attachment. For a list of supported file types, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#feature-limits\">Feature specifications</a> in the <i>Amazon Connect Administrator Guide</i>.</p>"
},
"AttachmentId":{
"shape":"ArtifactId",
"documentation":"<p>A unique identifier for the attachment.</p>"
},
"AttachmentName":{
"shape":"AttachmentName",
"documentation":"<p>A case-sensitive name of the attachment being uploaded.</p>"
},
"Status":{
"shape":"ArtifactStatus",
"documentation":"<p>Status of the attachment.</p>"
}
},
"documentation":"<p>The case-insensitive input to indicate standard MIME type that describes the format of the file that will be uploaded.</p>"
"documentation":"<p>The expiration of the token.</p> <p>It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.</p>"
"documentation":"<p>This is a header parameter.</p> <p>The Participant Token as obtained from <a href=\"https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html\">StartChatContact</a> API response.</p>",
"documentation":"<p>A unique identifier for the attachment.</p>"
},
"ConnectionToken":{
"shape":"ParticipantToken",
"documentation":"<p>The authentication token associated with the participant's connection.</p>",
"location":"header",
"locationName":"X-Amz-Bearer"
}
}
},
"GetAttachmentResponse":{
"type":"structure",
"members":{
"Url":{
"shape":"PreSignedAttachmentUrl",
"documentation":"<p>The pre-signed URL using which file would be downloaded from Amazon S3 by the API caller.</p>"
},
"UrlExpiry":{
"shape":"ISO8601Datetime",
"documentation":"<p>The expiration time of the URL in ISO timestamp. It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.</p>"
"documentation":"<p>The contactId from the current contact chain for which transcript is needed.</p>"
},
"MaxResults":{
"shape":"MaxResults",
"documentation":"<p>The maximum number of results to return in the page. Default: 10. </p>",
"box":true
},
"NextToken":{
"shape":"NextToken",
"documentation":"<p>The pagination token. Use the value returned previously in the next subsequent request to retrieve the next set of results.</p>"
},
"ScanDirection":{
"shape":"ScanDirection",
"documentation":"<p>The direction from StartPosition from which to retrieve message. Default: BACKWARD when no StartPosition is provided, FORWARD with StartPosition. </p>"
},
"SortOrder":{
"shape":"SortKey",
"documentation":"<p>The sort order for the records. Default: DESCENDING.</p>"
},
"StartPosition":{
"shape":"StartPosition",
"documentation":"<p>A filtering option for where to start.</p>"
},
"ConnectionToken":{
"shape":"ParticipantToken",
"documentation":"<p>The authentication token associated with the participant's connection.</p>",
"location":"header",
"locationName":"X-Amz-Bearer"
}
}
},
"GetTranscriptResponse":{
"type":"structure",
"members":{
"InitialContactId":{
"shape":"ContactId",
"documentation":"<p>The initial contact ID for the contact. </p>"
},
"Transcript":{
"shape":"Transcript",
"documentation":"<p>The list of messages in the session.</p>"
},
"NextToken":{
"shape":"NextToken",
"documentation":"<p>The pagination token. Use the value returned previously in the next subsequent request to retrieve the next set of results.</p>"
}
}
},
"ISO8601Datetime":{"type":"string"},
"Instant":{
"type":"string",
"max":100,
"min":1
},
"InternalServerException":{
"type":"structure",
"required":["Message"],
"members":{
"Message":{"shape":"Message"}
},
"documentation":"<p>This exception occurs when there is an internal failure in the Amazon Connect service.</p>",
"error":{"httpStatusCode":500},
"exception":true,
"fault":true
},
"Item":{
"type":"structure",
"members":{
"AbsoluteTime":{
"shape":"Instant",
"documentation":"<p>The time when the message or event was sent.</p> <p>It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.</p>"
},
"Content":{
"shape":"ChatContent",
"documentation":"<p>The content of the message or event.</p>"
},
"ContentType":{
"shape":"ChatContentType",
"documentation":"<p>The type of content of the item.</p>"
},
"Id":{
"shape":"ChatItemId",
"documentation":"<p>The ID of the item.</p>"
},
"Type":{
"shape":"ChatItemType",
"documentation":"<p>Type of the item: message or event. </p>"
},
"ParticipantId":{
"shape":"ParticipantId",
"documentation":"<p>The ID of the sender in the session.</p>"
},
"DisplayName":{
"shape":"DisplayName",
"documentation":"<p>The chat display name of the sender.</p>"
},
"ParticipantRole":{
"shape":"ParticipantRole",
"documentation":"<p>The role of the sender. For example, is it a customer, agent, or system.</p>"
"documentation":"<p>The content type of the request. Supported types are:</p> <ul> <li> <p>application/vnd.amazonaws.connect.event.typing</p> </li> <li> <p>application/vnd.amazonaws.connect.event.connection.acknowledged</p> </li> </ul>"
},
"Content":{
"shape":"ChatContent",
"documentation":"<p>The content of the event to be sent (for example, message text). This is not yet supported.</p>"
},
"ClientToken":{
"shape":"ClientToken",
"documentation":"<p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.</p>",
"idempotencyToken":true
},
"ConnectionToken":{
"shape":"ParticipantToken",
"documentation":"<p>The authentication token associated with the participant's connection.</p>",
"location":"header",
"locationName":"X-Amz-Bearer"
}
}
},
"SendEventResponse":{
"type":"structure",
"members":{
"Id":{
"shape":"ChatItemId",
"documentation":"<p>The ID of the response.</p>"
},
"AbsoluteTime":{
"shape":"Instant",
"documentation":"<p>The time when the event was sent.</p> <p>It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.</p>"
}
}
},
"SendMessageRequest":{
"type":"structure",
"required":[
"ContentType",
"Content",
"ConnectionToken"
],
"members":{
"ContentType":{
"shape":"ChatContentType",
"documentation":"<p>The type of the content. Supported types are text/plain.</p>"
},
"Content":{
"shape":"ChatContent",
"documentation":"<p>The content of the message.</p>"
},
"ClientToken":{
"shape":"ClientToken",
"documentation":"<p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.</p>",
"idempotencyToken":true
},
"ConnectionToken":{
"shape":"ParticipantToken",
"documentation":"<p>The authentication token associated with the connection.</p>",
"location":"header",
"locationName":"X-Amz-Bearer"
}
}
},
"SendMessageResponse":{
"type":"structure",
"members":{
"Id":{
"shape":"ChatItemId",
"documentation":"<p>The ID of the message.</p>"
},
"AbsoluteTime":{
"shape":"Instant",
"documentation":"<p>The time when the message was sent.</p> <p>It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.</p>"
"documentation":"<p>Describes the MIME file type of the attachment. For a list of supported file types, see <a href=\"https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-service-limits.html#feature-limits\">Feature specifications</a> in the <i>Amazon Connect Administrator Guide</i>.</p>"
},
"AttachmentSizeInBytes":{
"shape":"AttachmentSizeInBytes",
"documentation":"<p>The size of the attachment in bytes.</p>"
},
"AttachmentName":{
"shape":"AttachmentName",
"documentation":"<p>A case-sensitive name of the attachment being uploaded.</p>"
},
"ClientToken":{
"shape":"NonEmptyClientToken",
"documentation":"<p>A unique case sensitive identifier to support idempotency of request.</p>",
"idempotencyToken":true
},
"ConnectionToken":{
"shape":"ParticipantToken",
"documentation":"<p>The authentication token associated with the participant's connection.</p>",
"location":"header",
"locationName":"X-Amz-Bearer"
}
}
},
"StartAttachmentUploadResponse":{
"type":"structure",
"members":{
"AttachmentId":{
"shape":"ArtifactId",
"documentation":"<p>A unique identifier for the attachment.</p>"
},
"UploadMetadata":{
"shape":"UploadMetadata",
"documentation":"<p>Fields to be used while uploading the attachment.</p>"
"documentation":"<p>The ID of the message or event where to start. </p>"
},
"AbsoluteTime":{
"shape":"Instant",
"documentation":"<p>The time in ISO format where to start.</p> <p>It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.</p>"
},
"MostRecent":{
"shape":"MostRecent",
"documentation":"<p>The start position of the most recent message where you want to start. </p>"
}
},
"documentation":"<p>A filtering option for where to start. For example, if you sent 100 messages, start with message 50. </p>"
},
"ThrottlingException":{
"type":"structure",
"required":["Message"],
"members":{
"Message":{"shape":"Message"}
},
"documentation":"<p>The request was denied due to request throttling.</p>",
"documentation":"<p>The pre-signed URL using which file would be downloaded from Amazon S3 by the API caller.</p>"
},
"UrlExpiry":{
"shape":"ISO8601Datetime",
"documentation":"<p>The expiration time of the URL in ISO timestamp. It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.</p>"
},
"HeadersToInclude":{
"shape":"UploadMetadataSignedHeaders",
"documentation":"<p>The headers to be provided while uploading the file to the URL.</p>"
}
},
"documentation":"<p>Fields to be used while uploading the attachment.</p>"
"documentation":"<p>The input fails to satisfy the constraints specified by Amazon Connect.</p>",
"error":{"httpStatusCode":400},
"exception":true
},
"Websocket":{
"type":"structure",
"members":{
"Url":{
"shape":"PreSignedConnectionUrl",
"documentation":"<p>The URL of the websocket.</p>"
},
"ConnectionExpiry":{
"shape":"ISO8601Datetime",
"documentation":"<p>The URL expiration timestamp in ISO date format.</p> <p>It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.</p>"
}
},
"documentation":"<p>The websocket for the participant's connection.</p>"
}
},
"documentation":"<p>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.</p> <p>Amazon Connect enables customer contacts through voice or chat.</p> <p>The APIs described here are used by chat participants, such as agents and customers.</p>"