Class: AWS.ConnectCases
- Inherits:
-
AWS.Service
- Object
- AWS.Service
- AWS.ConnectCases
- Identifier:
- connectcases
- API Version:
- 2022-10-03
- Defined in:
- (unknown)
Overview
Constructs a service interface object. Each API operation is exposed as a function on service.
Service Description
With Amazon Connect Cases, your agents can track and manage customer issues that require multiple interactions, follow-up tasks, and teams in your contact center. A case represents a customer issue. It records the issue, the steps and interactions taken to resolve the issue, and the outcome. For more information, see Amazon Connect Cases in the Amazon Connect Administrator Guide.
Sending a Request Using ConnectCases
var connectcases = new AWS.ConnectCases();
connectcases.batchGetField(params, function (err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Locking the API Version
In order to ensure that the ConnectCases object uses this specific API, you can
construct the object by passing the apiVersion
option to the constructor:
var connectcases = new AWS.ConnectCases({apiVersion: '2022-10-03'});
You can also set the API version globally in AWS.config.apiVersions
using
the connectcases service identifier:
AWS.config.apiVersions = {
connectcases: '2022-10-03',
// other service API versions
};
var connectcases = new AWS.ConnectCases();
Constructor Summary collapse
-
new AWS.ConnectCases(options = {}) ⇒ Object
constructor
Constructs a service object.
Property Summary collapse
-
endpoint ⇒ AWS.Endpoint
readwrite
An Endpoint object representing the endpoint URL for service requests.
Properties inherited from AWS.Service
Method Summary collapse
-
batchGetField(params = {}, callback) ⇒ AWS.Request
Returns the description for the list of fields in the request parameters.
-
batchPutFieldOptions(params = {}, callback) ⇒ AWS.Request
Creates and updates a set of field options for a single select field in a Cases domain.
.
-
createCase(params = {}, callback) ⇒ AWS.Request
Note: If you provide a value for
PerformedBy.UserArn
you must also have connect:DescribeUser permission on the User ARN resource that you provide<p>Creates a case in the specified Cases domain.
-
createDomain(params = {}, callback) ⇒ AWS.Request
Creates a domain, which is a container for all case data, such as cases, fields, templates and layouts.
-
createField(params = {}, callback) ⇒ AWS.Request
Creates a field in the Cases domain.
-
createLayout(params = {}, callback) ⇒ AWS.Request
Creates a layout in the Cases domain.
-
createRelatedItem(params = {}, callback) ⇒ AWS.Request
Creates a related item (comments, tasks, and contacts) and associates it with a case.
-
A Related Item is a resource that is associated with a case.
-
-
createTemplate(params = {}, callback) ⇒ AWS.Request
Creates a template in the Cases domain.
-
deleteDomain(params = {}, callback) ⇒ AWS.Request
Deletes a Cases domain.
<note> <p>After deleting your domain you must disassociate the deleted domain from your Amazon Connect instance with another API call before being able to use Cases again with this Amazon Connect instance.
-
deleteField(params = {}, callback) ⇒ AWS.Request
Deletes a field from a cases template.
-
deleteLayout(params = {}, callback) ⇒ AWS.Request
Deletes a layout from a cases template.
-
deleteTemplate(params = {}, callback) ⇒ AWS.Request
Deletes a cases template.
-
getCase(params = {}, callback) ⇒ AWS.Request
Returns information about a specific case if it exists.
-
getCaseAuditEvents(params = {}, callback) ⇒ AWS.Request
Returns the audit history about a specific case if it exists.
.
-
getCaseEventConfiguration(params = {}, callback) ⇒ AWS.Request
Returns the case event publishing configuration.
.
-
getDomain(params = {}, callback) ⇒ AWS.Request
Returns information about a specific domain if it exists.
-
getLayout(params = {}, callback) ⇒ AWS.Request
Returns the details for the requested layout.
.
-
getTemplate(params = {}, callback) ⇒ AWS.Request
Returns the details for the requested template.
-
listCasesForContact(params = {}, callback) ⇒ AWS.Request
Lists cases for a given contact.
.
-
listDomains(params = {}, callback) ⇒ AWS.Request
Lists all cases domains in the Amazon Web Services account.
-
listFieldOptions(params = {}, callback) ⇒ AWS.Request
Lists all of the field options for a field identifier in the domain.
-
listFields(params = {}, callback) ⇒ AWS.Request
Lists all fields in a Cases domain.
.
-
listLayouts(params = {}, callback) ⇒ AWS.Request
Lists all layouts in the given cases domain.
-
listTagsForResource(params = {}, callback) ⇒ AWS.Request
Lists tags for a resource.
.
-
listTemplates(params = {}, callback) ⇒ AWS.Request
Lists all of the templates in a Cases domain.
-
putCaseEventConfiguration(params = {}, callback) ⇒ AWS.Request
Adds case event publishing configuration.
-
searchCases(params = {}, callback) ⇒ AWS.Request
Searches for cases within their associated Cases domain.
-
searchRelatedItems(params = {}, callback) ⇒ AWS.Request
Searches for related items that are associated with a case.
Note: If no filters are provided, this returns all related items associated with a case.- tagResource(params = {}, callback) ⇒ AWS.Request
Adds tags to a resource.
.
- untagResource(params = {}, callback) ⇒ AWS.Request
Untags a resource.
.
- updateCase(params = {}, callback) ⇒ AWS.Request
Note: If you provide a value forPerformedBy.UserArn
you must also have connect:DescribeUser permission on the User ARN resource that you provide<p>Updates the values of fields on a case.
- updateField(params = {}, callback) ⇒ AWS.Request
Updates the properties of an existing field.
- updateLayout(params = {}, callback) ⇒ AWS.Request
Updates the attributes of an existing layout.
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
A
ValidationException
is returned when you add non-existentfieldIds
to a layout.Note: Title and Status fields cannot be part of layouts because they are not configurable.- updateTemplate(params = {}, callback) ⇒ AWS.Request
Updates the attributes of an existing template.
Methods inherited from AWS.Service
makeRequest, makeUnauthenticatedRequest, waitFor, setupRequestListeners, defineService
Constructor Details
new AWS.ConnectCases(options = {}) ⇒ Object
Constructs a service object. This object has one method for each API operation.
Property Details
Method Details
batchGetField(params = {}, callback) ⇒ AWS.Request
Returns the description for the list of fields in the request parameters.
batchPutFieldOptions(params = {}, callback) ⇒ AWS.Request
Creates and updates a set of field options for a single select field in a Cases domain.
createCase(params = {}, callback) ⇒ AWS.Request
Note: If you provide a value forPerformedBy.UserArn
you must also have connect:DescribeUser permission on the User ARN resource that you provide<p>Creates a case in the specified Cases domain. Case system and custom fields are taken as an array id/value pairs with a declared data types.</p> <p>The following fields are required when creating a case:</p> <ul> <li> <p> <code>customer_id</code> - You must provide the full customer profile ARN in this format: <code>arn:aws:profile:your_AWS_Region:your_AWS_account ID:domains/your_profiles_domain_name/profiles/profile_ID</code> </p> </li> <li> <p> <code>title</code> </p> </li> </ul>
createDomain(params = {}, callback) ⇒ AWS.Request
Creates a domain, which is a container for all case data, such as cases, fields, templates and layouts. Each Amazon Connect instance can be associated with only one Cases domain.
This will not associate your connect instance to Cases domain. Instead, use the Amazon Connect CreateIntegrationAssociation API. You need specific IAM permissions to successfully associate the Cases domain. For more information, see Onboard to Cases.
</important>
createField(params = {}, callback) ⇒ AWS.Request
Creates a field in the Cases domain. This field is used to define the case object model (that is, defines what data can be captured on cases) in a Cases domain.
createLayout(params = {}, callback) ⇒ AWS.Request
Creates a layout in the Cases domain. Layouts define the following configuration in the top section and More Info tab of the Cases user interface:
-
Fields to display to the users
-
Field ordering
Note: Title and Status fields cannot be part of layouts since they are not configurable.createRelatedItem(params = {}, callback) ⇒ AWS.Request
Creates a related item (comments, tasks, and contacts) and associates it with a case.
-
A Related Item is a resource that is associated with a case. It may or may not have an external identifier linking it to an external resource (for example, a
contactArn
). All Related Items have their own internal identifier, therelatedItemArn
. Examples of related items includecomments
andcontacts
. -
If you provide a value for
performedBy.userArn
you must also have DescribeUser permission on the ARN of the user that you provide.
</note>
createTemplate(params = {}, callback) ⇒ AWS.Request
Creates a template in the Cases domain. This template is used to define the case object model (that is, to define what data can be captured on cases) in a Cases domain. A template must have a unique name within a domain, and it must reference existing field IDs and layout IDs. Additionally, multiple fields with same IDs are not allowed within the same Template. A template can be either Active or Inactive, as indicated by its status. Inactive templates cannot be used to create cases.
deleteDomain(params = {}, callback) ⇒ AWS.Request
Deletes a Cases domain.
<note> <p>After deleting your domain you must disassociate the deleted domain from your Amazon Connect instance with another API call before being able to use Cases again with this Amazon Connect instance. See <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteIntegrationAssociation.html">DeleteIntegrationAssociation</a>.</p> </note>
deleteField(params = {}, callback) ⇒ AWS.Request
Deletes a field from a cases template. You can delete up to 100 fields per domain.
After a field is deleted:
-
You can still retrieve the field by calling
BatchGetField
. -
You cannot update a deleted field by calling
UpdateField
; it throws aValidationException
. -
Deleted fields are not included in the
ListFields
response. -
Calling
CreateCase
with a deleted field throws aValidationException
denoting which field IDs in the request have been deleted. -
Calling
GetCase
with a deleted field ID returns the deleted field's value if one exists. -
Calling
UpdateCase
with a deleted field ID throws aValidationException
if the case does not already contain a value for the deleted field. Otherwise it succeeds, allowing you to update or remove (usingemptyValue: {}
) the field's value from the case. -
GetTemplate
does not return field IDs for deleted fields. -
GetLayout
does not return field IDs for deleted fields. -
Calling
SearchCases
with the deleted field ID as a filter returns any cases that have a value for the deleted field that matches the filter criteria. -
Calling
SearchCases
with asearchTerm
value that matches a deleted field's value on a case returns the case in the response. -
Calling
BatchPutFieldOptions
with a deleted field ID throw aValidationException
. -
Calling
GetCaseEventConfiguration
does not return field IDs for deleted fields.
deleteLayout(params = {}, callback) ⇒ AWS.Request
Deletes a layout from a cases template. You can delete up to 100 layouts per domain.
<p>After a layout is deleted:</p> <ul> <li> <p>You can still retrieve the layout by calling <code>GetLayout</code>.</p> </li> <li> <p>You cannot update a deleted layout by calling <code>UpdateLayout</code>; it throws a <code>ValidationException</code>.</p> </li> <li> <p>Deleted layouts are not included in the <code>ListLayouts</code> response.</p> </li> </ul>
deleteTemplate(params = {}, callback) ⇒ AWS.Request
Deletes a cases template. You can delete up to 100 templates per domain.
<p>After a cases template is deleted:</p> <ul> <li> <p>You can still retrieve the template by calling <code>GetTemplate</code>.</p> </li> <li> <p>You cannot update the template. </p> </li> <li> <p>You cannot create a case by using the deleted template.</p> </li> <li> <p>Deleted templates are not included in the <code>ListTemplates</code> response.</p> </li> </ul>
getCase(params = {}, callback) ⇒ AWS.Request
Returns information about a specific case if it exists.
getCaseAuditEvents(params = {}, callback) ⇒ AWS.Request
Returns the audit history about a specific case if it exists.
getCaseEventConfiguration(params = {}, callback) ⇒ AWS.Request
Returns the case event publishing configuration.
getDomain(params = {}, callback) ⇒ AWS.Request
Returns information about a specific domain if it exists.
listDomains(params = {}, callback) ⇒ AWS.Request
Lists all cases domains in the Amazon Web Services account. Each list item is a condensed summary object of the domain.
listFieldOptions(params = {}, callback) ⇒ AWS.Request
Lists all of the field options for a field identifier in the domain.
listLayouts(params = {}, callback) ⇒ AWS.Request
Lists all layouts in the given cases domain. Each list item is a condensed summary object of the layout.
listTemplates(params = {}, callback) ⇒ AWS.Request
Lists all of the templates in a Cases domain. Each list item is a condensed summary object of the template.
putCaseEventConfiguration(params = {}, callback) ⇒ AWS.Request
Adds case event publishing configuration. For a complete list of fields you can add to the event message, see Create case fields in the Amazon Connect Administrator Guide
searchCases(params = {}, callback) ⇒ AWS.Request
Searches for cases within their associated Cases domain. Search results are returned as a paginated list of abridged case documents.
Note: Forcustomer_id
you must provide the full customer profile ARN in this format:arn:aws:profile:your AWS Region:your AWS account ID:domains/profiles domain name/profiles/profile ID
.searchRelatedItems(params = {}, callback) ⇒ AWS.Request
Searches for related items that are associated with a case.
Note: If no filters are provided, this returns all related items associated with a case.updateCase(params = {}, callback) ⇒ AWS.Request
Note: If you provide a value forPerformedBy.UserArn
you must also have connect:DescribeUser permission on the User ARN resource that you provide<p>Updates the values of fields on a case. Fields to be updated are received as an array of id/value pairs identical to the <code>CreateCase</code> input .</p> <p>If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.</p>
updateLayout(params = {}, callback) ⇒ AWS.Request
Updates the attributes of an existing layout.
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
A
ValidationException
is returned when you add non-existentfieldIds
to a layout.Note: Title and Status fields cannot be part of layouts because they are not configurable.updateTemplate(params = {}, callback) ⇒ AWS.Request
Updates the attributes of an existing template. The template attributes that can be modified include
name
,description
,layoutConfiguration
,requiredFields
, andstatus
. At least one of these attributes must not be null. If a null value is provided for a given attribute, that attribute is ignored and its current value is preserved. - tagResource(params = {}, callback) ⇒ AWS.Request