feat(client-connect): This release supports showing PreferredAgentRouting step via DescribeContact API.

Author: awstools

clients/client-connect/src/commands/DescribeContactCommand.ts

@@ -123,6 +123,13 @@ export interface DescribeContactCommandOutput extends DescribeContactResponse, _
  * //               Name: "STRING_VALUE",
  * //               Value: "STRING_VALUE",
  * //               ProficiencyLevel: Number("float"),
+ * //               MatchCriteria: { // MatchCriteria
+ * //                 AgentsCriteria: { // AgentsCriteria
+ * //                   AgentIds: [ // AgentIds
+ * //                     "STRING_VALUE",
+ * //                   ],
+ * //                 },
+ * //               },
  * //               ComparisonOperator: "STRING_VALUE",
  * //             },
  * //             AndExpression: [ // Expressions
@@ -131,6 +138,13 @@ export interface DescribeContactCommandOutput extends DescribeContactResponse, _
  * //                   Name: "STRING_VALUE",
  * //                   Value: "STRING_VALUE",
  * //                   ProficiencyLevel: Number("float"),
+ * //                   MatchCriteria: {
+ * //                     AgentsCriteria: {
+ * //                       AgentIds: [
+ * //                         "STRING_VALUE",
+ * //                       ],
+ * //                     },
+ * //                   },
  * //                   ComparisonOperator: "STRING_VALUE",
  * //                 },
  * //                 AndExpression: [

clients/client-connect/src/commands/ImportPhoneNumberCommand.ts

@@ -31,6 +31,22 @@ export interface ImportPhoneNumberCommandOutput extends ImportPhoneNumberRespons
  * <p>Imports a claimed phone number from an external service, such as Amazon Pinpoint, into an
  *     Amazon Connect instance. You can call this API only in the same Amazon Web Services Region
  *    where the Amazon Connect instance was created.</p>
+ *          <important>
+ *             <p>Call the <a href="https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html">DescribePhoneNumber</a> API
+ *     to verify the status of a previous <code>ImportPhoneNumber</code> operation. </p>
+ *          </important>
+ *          <p>If you plan to claim or import numbers and then release numbers frequently, contact us for a
+ *    service quota exception. Otherwise, it is possible you will be blocked from claiming and
+ *    releasing any more numbers until up to 180 days past the oldest number released has expired. </p>
+ *          <p> By default you can claim or import and then release up to 200% of your maximum number of
+ *    active phone numbers. If you claim or import and then release phone numbers using the UI or API
+ *    during a rolling 180 day cycle that exceeds 200% of your phone number service level quota, you
+ *    will be blocked from claiming or importing any more numbers until 180 days past the oldest number
+ *    released has expired. </p>
+ *          <p>For example, if you already have 99 claimed or imported numbers and a service level quota of
+ *    99 phone numbers, and in any 180 day period you release 99, claim 99, and then release 99, you
+ *    will have exceeded the 200% limit. At that point you are blocked from claiming any more numbers
+ *    until you open an Amazon Web Services Support ticket. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-connect/src/commands/ListUsersCommand.ts

@@ -6,7 +6,8 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { ConnectClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ConnectClient";
 import { commonParams } from "../endpoint/EndpointParameters";
-import { ListUsersRequest, ListUsersResponse } from "../models/models_1";
+import { ListUsersRequest } from "../models/models_1";
+import { ListUsersResponse } from "../models/models_2";
 import { de_ListUsersCommand, se_ListUsersCommand } from "../protocols/Aws_restJson1";
 
 /**

clients/client-connect/src/commands/ListViewsCommand.ts

@@ -6,8 +6,7 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { ConnectClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ConnectClient";
 import { commonParams } from "../endpoint/EndpointParameters";
-import { ListViewsRequest } from "../models/models_1";
-import { ListViewsResponse, ListViewsResponseFilterSensitiveLog } from "../models/models_2";
+import { ListViewsRequest, ListViewsResponse, ListViewsResponseFilterSensitiveLog } from "../models/models_2";
 import { de_ListViewsCommand, se_ListViewsCommand } from "../protocols/Aws_restJson1";
 
 /**

clients/client-connect/src/commands/StartChatContactCommand.ts

@@ -47,8 +47,20 @@ export interface StartChatContactCommandOutput extends StartChatContactResponse,
  *          <p>If you use the <code>ChatDurationInMinutes</code> 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. </p>
- *          <p>For more information about chat, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/chat.html">Chat</a> in the <i>Amazon Connect
- *     Administrator Guide</i>.</p>
+ *          <p>For more information about chat, see the following topics in the <i>Amazon Connect
+ *    Administrator Guide</i>: </p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/connect/latest/adminguide/web-and-mobile-chat.html">Concepts: Web and mobile messaging capabilities in Amazon Connect</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>
+ *                </p>
+ *             </li>
+ *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-connect/src/commands/StartContactStreamingCommand.ts

@@ -31,6 +31,20 @@ export interface StartContactStreamingCommandOutput extends StartContactStreamin
  * <p> Initiates real-time message streaming for a new chat contact.</p>
  *          <p> For more information about message streaming, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/chat-message-streaming.html">Enable real-time chat message
  *     streaming</a> in the <i>Amazon Connect Administrator Guide</i>.</p>
+ *          <p>For more information about chat, see the following topics in the <i>Amazon Connect
+ *    Administrator Guide</i>: </p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/connect/latest/adminguide/web-and-mobile-chat.html">Concepts: Web and mobile messaging capabilities in Amazon Connect</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat">Amazon Connect Chat security best practices</a>
+ *                </p>
+ *             </li>
+ *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-connect/src/models/models_0.ts

@@ -501,7 +501,8 @@ export interface DeviceInfo {
 }
 
 /**
- * <p>Information about the agent hierarchy. Hierarchies can be configured with up to five levels.</p>
+ * <p>Information about the agent hierarchy. Hierarchies can be configured with up to five
+ *    levels.</p>
  * @public
  */
 export interface HierarchyGroups {
@@ -591,8 +592,10 @@ export interface AudioQualityMetricsInfo {
   QualityScore?: number;
 
   /**
-   * <p>List of potential issues causing degradation of quality on a media connection. If the service did not detect any potential quality issues the list is empty.</p>
-   *          <p>Valid values: <code>HighPacketLoss</code> | <code>HighRoundTripTime</code> | <code>HighJitterBuffer</code>
+   * <p>List of potential issues causing degradation of quality on a media connection. If the
+   *    service did not detect any potential quality issues the list is empty.</p>
+   *          <p>Valid values: <code>HighPacketLoss</code> | <code>HighRoundTripTime</code> |
+   *     <code>HighJitterBuffer</code>
    *          </p>
    * @public
    */
@@ -611,6 +614,20 @@ export interface AgentQualityMetrics {
   Audio?: AudioQualityMetricsInfo;
 }
 
+/**
+ * <p>Can be used to define a list of preferred agents to target the contact within the queue.
+ *    Note that agents must have the queue in their routing profile in order to be offered the
+ *    contact.</p>
+ * @public
+ */
+export interface AgentsCriteria {
+  /**
+   * <p>An object to specify a list of agents, by Agent ID.</p>
+   * @public
+   */
+  AgentIds?: string[];
+}
+
 /**
  * @public
  * @enum
@@ -4360,7 +4377,7 @@ export interface FieldValueUnion {
   BooleanValue?: boolean;
 
   /**
-   * <p>a Double number value type.</p>
+   * <p>A Double number value type.</p>
    * @public
    */
   DoubleValue?: number;
@@ -6689,7 +6706,8 @@ export interface Customer {
  */
 export interface CustomerVoiceActivity {
   /**
-   * <p>Timestamp that measures the beginning of the customer greeting from an outbound voice call.</p>
+   * <p>Timestamp that measures the beginning of the customer greeting from an outbound voice
+   *    call.</p>
    * @public
    */
   GreetingStartTimestamp?: Date;
@@ -6707,7 +6725,8 @@ export interface CustomerVoiceActivity {
  */
 export interface DisconnectDetails {
   /**
-   * <p>Indicates the potential disconnection issues for a call. This field is not populated if the service does not detect potential issues.</p>
+   * <p>Indicates the potential disconnection issues for a call. This field is not populated if the
+   *    service does not detect potential issues.</p>
    * @public
    */
   PotentialDisconnectIssue?: string;
@@ -6779,6 +6798,18 @@ export interface Expiry {
   ExpiryTimestamp?: Date;
 }
 
+/**
+ * <p>An object to define <code>AgentsCriteria</code>.</p>
+ * @public
+ */
+export interface MatchCriteria {
+  /**
+   * <p>An object to define <code>AgentIds</code>.</p>
+   * @public
+   */
+  AgentsCriteria?: AgentsCriteria;
+}
+
 /**
  * <p>An object to specify the predefined attribute condition.</p>
  * @public
@@ -6802,6 +6833,12 @@ export interface AttributeCondition {
    */
   ProficiencyLevel?: number;
 
+  /**
+   * <p>An object to define <code>AgentsCriteria</code>.</p>
+   * @public
+   */
+  MatchCriteria?: MatchCriteria;
+
   /**
    * <p>The operator of the condition.</p>
    * @public
@@ -7031,86 +7068,6 @@ export interface EvaluationNote {
   Value?: string;
 }
 
-/**
- * @public
- * @enum
- */
-export const EvaluationStatus = {
-  DRAFT: "DRAFT",
-  SUBMITTED: "SUBMITTED",
-} as const;
-
-/**
- * @public
- */
-export type EvaluationStatus = (typeof EvaluationStatus)[keyof typeof EvaluationStatus];
-
-/**
- * <p>Information about a contact evaluation.</p>
- * @public
- */
-export interface Evaluation {
-  /**
-   * <p>A unique identifier for the contact evaluation.</p>
-   * @public
-   */
-  EvaluationId: string | undefined;
-
-  /**
-   * <p>The Amazon Resource Name (ARN) for the contact evaluation resource.</p>
-   * @public
-   */
-  EvaluationArn: string | undefined;
-
-  /**
-   * <p>Metadata about the contact evaluation.</p>
-   * @public
-   */
-  Metadata: EvaluationMetadata | undefined;
-
-  /**
-   * <p>A map of question identifiers to answer value.</p>
-   * @public
-   */
-  Answers: Record<string, EvaluationAnswerOutput> | undefined;
-
-  /**
-   * <p>A map of question identifiers to note value.</p>
-   * @public
-   */
-  Notes: Record<string, EvaluationNote> | undefined;
-
-  /**
-   * <p>The status of the contact evaluation.</p>
-   * @public
-   */
-  Status: EvaluationStatus | undefined;
-
-  /**
-   * <p>A map of item (section or question) identifiers to score value.</p>
-   * @public
-   */
-  Scores?: Record<string, EvaluationScore>;
-
-  /**
-   * <p>The timestamp for when the evaluation was created.</p>
-   * @public
-   */
-  CreatedTime: Date | undefined;
-
-  /**
-   * <p>The timestamp for when the evaluation was last updated.</p>
-   * @public
-   */
-  LastModifiedTime: Date | undefined;
-
-  /**
-   * <p>The tags used to organize, track, or control access for this resource. For example, \{ "Tags": \{"key1":"value1", "key2":"value2"\} \}.</p>
-   * @public
-   */
-  Tags?: Record<string, string>;
-}
-
 /**
  * @internal
  */