Before you start
- An Amazon Connect integration already streaming Contact Trace Records (CTRs).
- An Operata account with Admin role and your Operata Group ID.
- AWS IAM permissions to deploy CloudFormation in the region hosting your Amazon Lex V2 bots.
- Amazon Lex V2 bots wired into your Amazon Connect contact flows.
- Lex conversation logging enabled on each bot alias you want to monitor. Operata consumes text logs; audio logs are not required.
Steps
1. Send Operata the install details
Contact Operata Support with:- AWS region hosting your Lex bots.
- CloudWatch log group name for the Lex conversation logs —
usually
/aws/lex/<log-group-name>. To find it for a specific bot, open the Amazon Lex console, select the bot, open Deployment → Aliases, and copy the CloudWatch Log Group Name value from the right-hand panel. - Operata Group ID — Operata can confirm yours if you do not have it on hand.
2. Open the quick-create link
Click the link to open the CloudFormation console. Every parameter is pre-populated except the API key.3. Enter your Operata API token
Paste an Operata API token into the API key parameter. Create one in the Operata console under Settings → Config → API. See the Operata help article for the full lifecycle.4. Deploy the stack
Acknowledge the IAM resource creation and click Create stack. The stack reachesCREATE_COMPLETE in around five minutes. CloudFormation provisions:
5. (Optional) Tag the new resources
Apply your cost-allocation and ownership tags. See Tag your AWS resources.6. Place a test contact through the bot
Trigger a call that routes to your Lex bot through an Amazon Connect contact flow. Interact by voice or DTMF as your flow expects. End the contact cleanly.Verify
In the Operata console, open Calls and Logs → Summary and locate the test contact. The Lex conversation events appear within five minutes of contact end and join the Contact Trace Record (CTR) byContactId.
If nothing appears after five minutes, see Troubleshooting.
Data collected
Each event carries a Lex conversation log entry, including:- Session ID and bot identifiers.
- Intent names and recognition confidence scores.
- Slot values (subject to redaction).
- Utterance text (subject to redaction).
- Session attributes.
- Fulfillment status and Lambda response data.
- Conversation timestamps.
Privacy
Raw Lex logs contain customer utterances and slot values. The integration ships a redaction Lambda that runs in your AWS account before any log leaves AWS. See:- Lex redaction schema — the field-tier schema and the mandatory keep-list.
- Concept: Privacy and redaction — the model the redaction Lambda enforces.
Charges
All AWS service charges from this stack appear on your AWS bill. The Lex integration is included in every Operata plan at no Operata cost. Primary cost factors:- EventBridge event processing.
- CloudWatch Logs data transfer out of CloudWatch.
- Secrets Manager (rolled into the API destination charge).
Deploying alongside other stacks
The Lex stack runs independently of the CTR, Contact Lens, and contact-flow logs stacks. Add or remove any stack without affecting the others.Related
- Lex redaction schema — strip PII fields before logs leave AWS.
- Install Contact Flow Logs collection — pair Lex bot data with the broader IVR path.
- Concept: Cloud Collector — the Operata-side runtime that joins Lex events to contacts.
- Troubleshoot the AWS integration — missing events, IAM debugging, Amazon EventBridge Pipe failures.