UpdateContactRecordingBehavior - Amazon Connect


Sets contact recording behavior, including analysis behavior and which participants of the contact to record.

Parameter object

{ "RecordingBehavior": { an object that holds the recording behavior "RecordedParticipants": [ ] a list of participants to record, chosen from "Agent" and "Customer". An empty list disables recording. Must be set statically. "ScreenRecordedParticipants": [ ] a list of participants for which to record their screen, can only include "Agent". Must be set statically. }, "AnalyticsBehavior": { an object that holds the analytics behavior. Can only be set if the RecordedParticipants contains both Agent and Customer "Enabled": either "True" or "False". Must be set statically. "AnalyticsLanguage": Must be one of languages supported by Contact Lens post-call analysis. Must be set statically. Use the format xx-XX, for example, en-US for US English. "AnalyticsRedactionBehavior": either Enabled or Disabled. Defaults to Disabled if not set. Determines whether to redact sensitive data, such as personal information, in the Contact Lens output file and audio recording. "AnalyticsRedactionResults": either "RedactedAndOriginal" or "RedactedOnly". Can be set dynamically. Determines whether the customer gets both the redacted and the original transcripts and audio files, or just the redacted transcripts and audio files. "AnalyticsRedactionMaskMode": either "EntityType" or "PII". Must be set statically. "AnalyticsRedactionEntities": ["BANK_ACCOUNT_NUMBER", "BANK_ROUTING", "CREDIT_DEBIT_NUMBER", "CREDIT_DEBIT_CVV", "CREDIT_DEBIT_EXPIRY", "INTERNATIONAL_BANK_ACCOUNT_NUMBER", "PIN", "SWIFT_CODE", "CA_HEALTH_NUMBER", "UK_NATIONAL_HEALTH_SERVICE_NUMBER", "CA_SOCIAL_INSURANCE_NUMBER", "SSN", "UK_NATIONAL_INSURANCE_NUMBER", "PASSPORT_NUMBER", "DRIVER_ID", "IN_AADHAAR", "NAME", "AGE", "EMAIL", "PHONE", "ADDRESS", "US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER", "UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER", "IN_PERMANENT_ACCOUNT_NUMBER", "IN_NREGA", "AWS_ACCESS_KEY", "AWS_SECRET_KEY", "IP_ADDRESS", "MAC_ADDRESS", "PASSWORD", "URL", "USERNAME", "LICENSE_PLATE", "VEHICLE_IDENTIFICATION_NUMBER", "IN_VOTER_NUMBER", "DATE_TIME", "AGENT_DISPLAY_NAME", "CUSTOMER_DISPLAY_NAME", "ATTACHMENT_NAME"], "ChannelConfiguration": { "Chat": { "AnalyticsModes": ["ContactLens"] Can only be set to ContactLens }, "Voice": { "AnalyticsModes": ["RealTime"] Can be set to RealTime and PostContact } } } }
  • AnalyticsRedactionMaskMode: Optional, String. Allowed values:

    • PII: All PII data is replaced with [PII]. For example, Jane Doe is replaced with [PII]

    • EntityType: Each PII entity is replaced with its type. For example, Jane Doe is replaced with [NAME].

    • If no value is provided, the default PII is used.

  • AnalyticsRedactionEntities: Optional, Array of strings.


    • An empty array is not allowed.

    • If AnalyticsRedactionEntities is not present, the default "redact all PII data" is used.

For more information on sensitive data redaction, see Enable redaction of sensitive data in the Amazon Connect Administrator's Guide.

For a list of languages supported by Contact Lens post-call analysis, see Contact Lens supported languages. For the 4-character language code to use, see Supported languages in the Amazon Transcribe Developer Guide.

Results and conditions





This is supported only in contact flows, transfer flows, outbound whispers, and customer queue flows. This is not supported in agent/customer whispers or hold flows.

Analytics is only supported by the voice channel.

Corresponding block in the UI

Set recording and analytics behavior