Connect / Client / list_contact_references

list_contact_references

Connect.Client.list_contact_references(**kwargs)

This API is in preview release for Amazon Connect and is subject to change.

For the specified referenceTypes, returns a list of references associated with the contact. References are links to documents that are related to a contact, such as emails, attachments, or URLs.

See also: AWS API Documentation

Request Syntax

response = client.list_contact_references(
    InstanceId='string',
    ContactId='string',
    ReferenceTypes=[
        'URL'|'ATTACHMENT'|'CONTACT_ANALYSIS'|'NUMBER'|'STRING'|'DATE'|'EMAIL'|'EMAIL_MESSAGE',
    ],
    NextToken='string'
)

Parameters:

• InstanceId (string) –

  [REQUIRED]

  The identifier of the Amazon Connect instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

• ContactId (string) –

  [REQUIRED]

  The identifier of the initial contact.

• ReferenceTypes (list) –

  [REQUIRED]

  The type of reference.

  • (string) –

• NextToken (string) –

  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.

  Warning

  This is not expected to be set, because the value returned in the previous response is always null.

Return type:

dict

Returns:

Response Syntax

{
    'ReferenceSummaryList': [
        {
            'Url': {
                'Name': 'string',
                'Value': 'string'
            },
            'Attachment': {
                'Name': 'string',
                'Value': 'string',
                'Status': 'AVAILABLE'|'DELETED'|'APPROVED'|'REJECTED'|'PROCESSING'|'FAILED',
                'Arn': 'string'
            },
            'EmailMessage': {
                'Name': 'string',
                'Arn': 'string'
            },
            'String': {
                'Name': 'string',
                'Value': 'string'
            },
            'Number': {
                'Name': 'string',
                'Value': 'string'
            },
            'Date': {
                'Name': 'string',
                'Value': 'string'
            },
            'Email': {
                'Name': 'string',
                'Value': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) –

  • ReferenceSummaryList (list) –

    Information about the flows.

    • (dict) –

      Contains summary information about a reference. ReferenceSummary contains only one non null field between the URL and attachment based on the reference type.

      Note

      This is a Tagged Union structure. Only one of the following top level keys will be set: Url, Attachment, EmailMessage, String, Number, Date, Email. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

      'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
      

      • Url (dict) –

        Information about the reference when the referenceType is URL. Otherwise, null.

        • Name (string) –

          Identifier of the URL reference.

        • Value (string) –

          A valid URL.

      • Attachment (dict) –

        Information about the reference when the referenceType is ATTACHMENT. Otherwise, null.

        • Name (string) –

          Identifier of the attachment reference.

        • Value (string) –

          The location path of the attachment reference.

        • Status (string) –

          Status of the attachment reference type.

        • Arn (string) –

          The Amazon Resource Name (ARN) of the attachment reference.

      • EmailMessage (dict) –

        Information about the reference when the referenceType is EMAIL_MESSAGE. Otherwise, null.

        • Name (string) –

          The name of the email message reference

        • Arn (string) –

          The Amazon Resource Name (ARN) of the email message reference

      • String (dict) –

        Information about a reference when the referenceType is STRING. Otherwise, null.

        • Name (string) –

          Identifier of the string reference.

        • Value (string) –

          A valid string.

      • Number (dict) –

        Information about a reference when the referenceType is NUMBER. Otherwise, null.

        • Name (string) –

          Identifier of the number reference.

        • Value (string) –

          A valid number.

      • Date (dict) –

        Information about a reference when the referenceType is DATE. Otherwise, null.

        • Name (string) –

          Identifier of the date reference.

        • Value (string) –

          A valid date.

      • Email (dict) –

        Information about a reference when the referenceType is EMAIL. Otherwise, null.

        • Name (string) –

          Identifier of the email reference.

        • Value (string) –

          A valid email address.

  • NextToken (string) –

    If there are additional results, this is the token for the next set of results.

    Warning

    This is always returned as null in the response.

Exceptions

• Connect.Client.exceptions.InvalidRequestException

• Connect.Client.exceptions.InvalidParameterException

• Connect.Client.exceptions.ResourceNotFoundException

• Connect.Client.exceptions.InternalServiceException

• Connect.Client.exceptions.ThrottlingException