AWS API Changes

2023/07/25 - Amazon Connect Wisdom Service - 5 updated api methods

Changes This release added two new data types: AssistantIntegrationConfiguration, and SessionIntegrationConfiguration to support Wisdom integration with Amazon Connect Chat

CreateAssistant (updated)

Link ¶
Changes (response)

{'assistant': {'integrationConfiguration': {'topicIntegrationArn': 'string'}}}

Creates an Amazon Connect Wisdom assistant.

See also: AWS API Documentation

Request Syntax

client.create_assistant(
    clientToken='string',
    description='string',
    name='string',
    serverSideEncryptionConfiguration={
        'kmsKeyId': 'string'
    },
    tags={
        'string': 'string'
    },
    type='AGENT'
)

type clientToken

string

param clientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see Making retries safe with idempotent APIs.

This field is autopopulated if not provided.

type description

string

param description

The description of the assistant.

type name

string

param name

[REQUIRED]

The name of the assistant.

type serverSideEncryptionConfiguration

dict

param serverSideEncryptionConfiguration

The KMS key used for encryption.

kmsKeyId (string) --

The KMS key. For information about valid ID values, see Key identifiers (KeyId).

type tags

dict

param tags

The tags used to organize, track, or control access for this resource.

(string) --
- (string) --

type type

string

param type

[REQUIRED]

The type of assistant.

rtype

dict

returns

Response Syntax

{
    'assistant': {
        'assistantArn': 'string',
        'assistantId': 'string',
        'description': 'string',
        'integrationConfiguration': {
            'topicIntegrationArn': 'string'
        },
        'name': 'string',
        'serverSideEncryptionConfiguration': {
            'kmsKeyId': 'string'
        },
        'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETED',
        'tags': {
            'string': 'string'
        },
        'type': 'AGENT'
    }
}

Response Structure

(dict) --
- assistant (dict) --
  
  Information about the assistant.
  - assistantArn (string) --
    
    The Amazon Resource Name (ARN) of the Wisdom assistant.
  - assistantId (string) --
    
    The identifier of the Wisdom assistant.
  - description (string) --
    
    The description.
  - integrationConfiguration (dict) --
    
    The configuration information for the Wisdom assistant integration.
    - topicIntegrationArn (string) --
      
      The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
  - name (string) --
    
    The name.
  - serverSideEncryptionConfiguration (dict) --
    
    The KMS key used for encryption.
    - kmsKeyId (string) --
      
      The KMS key. For information about valid ID values, see Key identifiers (KeyId).
  - status (string) --
    
    The status of the assistant.
  - tags (dict) --
    
    The tags used to organize, track, or control access for this resource.
    - (string) --
      - (string) --
  - type (string) --
    
    The type of assistant.

CreateSession (updated)

Link ¶
Changes (response)

{'session': {'integrationConfiguration': {'topicIntegrationArn': 'string'}}}

Creates a session. A session is a contextual container used for generating recommendations. Amazon Connect creates a new Wisdom session for each contact on which Wisdom is enabled.

See also: AWS API Documentation

Request Syntax

client.create_session(
    assistantId='string',
    clientToken='string',
    description='string',
    name='string',
    tags={
        'string': 'string'
    }
)

type assistantId

string

param assistantId

[REQUIRED]

The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.

type clientToken

string

param clientToken

This field is autopopulated if not provided.

type description

string

param description

The description.

type name

string

param name

[REQUIRED]

The name of the session.

type tags

dict

param tags

The tags used to organize, track, or control access for this resource.

(string) --
- (string) --

rtype

dict

returns

Response Syntax

{
    'session': {
        'description': 'string',
        'integrationConfiguration': {
            'topicIntegrationArn': 'string'
        },
        'name': 'string',
        'sessionArn': 'string',
        'sessionId': 'string',
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

(dict) --
- session (dict) --
  
  The session.
  - description (string) --
    
    The description of the session.
  - integrationConfiguration (dict) --
    
    The configuration information for the session integration.
    - topicIntegrationArn (string) --
      
      The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
  - name (string) --
    
    The name of the session.
  - sessionArn (string) --
    
    The Amazon Resource Name (ARN) of the session.
  - sessionId (string) --
    
    The identifier of the session.
  - tags (dict) --
    
    The tags used to organize, track, or control access for this resource.
    - (string) --
      - (string) --

GetAssistant (updated)

Link ¶
Changes (response)

{'assistant': {'integrationConfiguration': {'topicIntegrationArn': 'string'}}}

Retrieves information about an assistant.

See also: AWS API Documentation

Request Syntax

client.get_assistant(
    assistantId='string'
)

type assistantId

string

param assistantId

[REQUIRED]

The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.

rtype

dict

returns

Response Syntax

{
    'assistant': {
        'assistantArn': 'string',
        'assistantId': 'string',
        'description': 'string',
        'integrationConfiguration': {
            'topicIntegrationArn': 'string'
        },
        'name': 'string',
        'serverSideEncryptionConfiguration': {
            'kmsKeyId': 'string'
        },
        'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETED',
        'tags': {
            'string': 'string'
        },
        'type': 'AGENT'
    }
}

Response Structure

(dict) --
- assistant (dict) --
  
  Information about the assistant.
  - assistantArn (string) --
    
    The Amazon Resource Name (ARN) of the Wisdom assistant.
  - assistantId (string) --
    
    The identifier of the Wisdom assistant.
  - description (string) --
    
    The description.
  - integrationConfiguration (dict) --
    
    The configuration information for the Wisdom assistant integration.
    - topicIntegrationArn (string) --
      
      The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
  - name (string) --
    
    The name.
  - serverSideEncryptionConfiguration (dict) --
    
    The KMS key used for encryption.
    - kmsKeyId (string) --
      
      The KMS key. For information about valid ID values, see Key identifiers (KeyId).
  - status (string) --
    
    The status of the assistant.
  - tags (dict) --
    
    The tags used to organize, track, or control access for this resource.
    - (string) --
      - (string) --
  - type (string) --
    
    The type of assistant.

GetSession (updated)

Link ¶
Changes (response)

{'session': {'integrationConfiguration': {'topicIntegrationArn': 'string'}}}

Retrieves information for a specified session.

See also: AWS API Documentation

Request Syntax

client.get_session(
    assistantId='string',
    sessionId='string'
)

type assistantId

string

param assistantId

[REQUIRED]

The identifier of the Wisdom assistant. Can be either the ID or the ARN. URLs cannot contain the ARN.

type sessionId

string

param sessionId

[REQUIRED]

The identifier of the session. Can be either the ID or the ARN. URLs cannot contain the ARN.

rtype

dict

returns

Response Syntax

{
    'session': {
        'description': 'string',
        'integrationConfiguration': {
            'topicIntegrationArn': 'string'
        },
        'name': 'string',
        'sessionArn': 'string',
        'sessionId': 'string',
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

(dict) --
- session (dict) --
  
  The session.
  - description (string) --
    
    The description of the session.
  - integrationConfiguration (dict) --
    
    The configuration information for the session integration.
    - topicIntegrationArn (string) --
      
      The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
  - name (string) --
    
    The name of the session.
  - sessionArn (string) --
    
    The Amazon Resource Name (ARN) of the session.
  - sessionId (string) --
    
    The identifier of the session.
  - tags (dict) --
    
    The tags used to organize, track, or control access for this resource.
    - (string) --
      - (string) --

ListAssistants (updated)

Link ¶
Changes (response)

{'assistantSummaries': {'integrationConfiguration': {'topicIntegrationArn': 'string'}}}

Lists information about assistants.

See also: AWS API Documentation

Request Syntax

client.list_assistants(
    maxResults=123,
    nextToken='string'
)

type maxResults

integer

param maxResults

The maximum number of results to return per page.

type nextToken

string

param nextToken

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

rtype

dict

returns

Response Syntax

{
    'assistantSummaries': [
        {
            'assistantArn': 'string',
            'assistantId': 'string',
            'description': 'string',
            'integrationConfiguration': {
                'topicIntegrationArn': 'string'
            },
            'name': 'string',
            'serverSideEncryptionConfiguration': {
                'kmsKeyId': 'string'
            },
            'status': 'CREATE_IN_PROGRESS'|'CREATE_FAILED'|'ACTIVE'|'DELETE_IN_PROGRESS'|'DELETE_FAILED'|'DELETED',
            'tags': {
                'string': 'string'
            },
            'type': 'AGENT'
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) --
- assistantSummaries (list) --
  
  Information about the assistants.
  - (dict) --
    
    Summary information about the assistant.
    - assistantArn (string) --
      
      The Amazon Resource Name (ARN) of the Wisdom assistant.
    - assistantId (string) --
      
      The identifier of the Wisdom assistant.
    - description (string) --
      
      The description of the assistant.
    - integrationConfiguration (dict) --
      
      The configuration information for the Wisdom assistant integration.
      - topicIntegrationArn (string) --
        
        The Amazon Resource Name (ARN) of the integrated Amazon SNS topic used for streaming chat messages.
    - name (string) --
      
      The name of the assistant.
    - serverSideEncryptionConfiguration (dict) --
      
      The KMS key used for encryption.
      - kmsKeyId (string) --
        
        The KMS key. For information about valid ID values, see Key identifiers (KeyId).
    - status (string) --
      
      The status of the assistant.
    - tags (dict) --
      
      The tags used to organize, track, or control access for this resource.
      - (string) --
        
        (string) --
    - type (string) --
      
      The type of the assistant.
- nextToken (string) --
  
  If there are additional results, this is the token for the next set of results.