This is a guide for integrating your Amazon Connect Instance with eMite.
...
Oveview of Stack Components
...
- EmiteDomain
- AWS Elasticsearch Domain that will store data used by eMite such as the Contact Trace Records (CTRs) and Metrics, Observations
- EmiteAgentEvents
- AWS Kinesis Stream that gets Agent Events data from Amazon Connect
- EmiteCtrFirehose
- AWS Kinesis Firehose that will send CTR data from Amazon Connect to Elasticsearch
- EmiteCtrFirehoseRole
- IAM Role that Kinesis Firehose will use
- EmiteCtrFirehosePolicy
- IAM Policy with various permissions requird by Kinesis Firehose
- EmiteRole
- IAM Role that eMite will use to get data from Kinesis Streams and Amazon Connect.
- EmiteKinesisPolicy
- IAM Policy to allow read access to Kinesis Stream
- EmiteAmazonConnectPolicy
- IAM Policy to allow read access to AmazonConnect instance
- EmiteCtrFailedRecordsBucket
- AWS S3 Bucket that will store any CTR records that Firehose fails to send to Elasticsearch
Deploying the Stack
Login to your AWS Console using an AWS Administrator account.
- Go to CloudFormation > Stacks
- Click Create Stack
Create Stack
- Prerequisite - Prepare Template
- Select Template is Ready
- Specify Template
- Select source as Amazon S3 URL
- URL: https://emite-configfiles.s3-ap-southeast-2.amazonaws.com/public-download/cloudformation-templates/latest/EmiteForAmazonConnect-SaaS
- Click Next
...
Specify Stack DetailsLoad the eMite Cloudformation template on the console
- On the eMite Onboarding page, under Step 1, click the Cloudformation URL Link
- This will take you to your cloudformation console on the same region as your amazon connect instance.
- This also automatically loads the eMite cloudformation template, as well as load some default parameters.
Define Stack Parameters
- Stack Name
- Input your preferred stack name
- E.g. emite-amazonconnect-stack
- Parameters
- AgentEventsStreamName
- Name of the Agent Events Kinesis stream. You can leave this as default
- Default: connect-agentevents
- AmazonConnectInstanceARN
- Open a new console window and go to Amazon Connnect > select your Amazon Connect instance
- On the overview tab, copy the Instance ARN
- CtrFirehoseName
- Name of the Firehose used for sending CTR data from Amazon Connect to ElasticsearchConnect to Elasticsearch.
- You can leave this as default
- Default: connect-ctrfirehose
- ESDomainName
- Name of the elasticsearch domain. You can leave this as default
- Default: emite-kinesis-connect
- CustomerID
- Autogenerated Unique Customer ID provided by eMite
- You can find this on the registration page.Please don't change this value
- EmiteAccountID
- eMite AWS Account ID, you can find this on the registration page.
- Please don't change this value
- EmiteIP
- Autogenerated eMite Server IP, you can find this on the registration page.
- Please don't change this value
- AgentEventsStreamName
- Click Next
Configure Stack Options
...
- Go to Amazon Connnect > select your Amazon Connect instance
- Go to Data Streaming
- Tick Enable data streaming
- Contact Trace Records
- Select Kinesis Firehose
- Select connect-ctrfirehose
- Agent Events
- Select Kinesis Stream
- Select connect-agentevents
Complete Registration / Send data to eMite team
...