Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

Version 1 Next »

This is a guide for integrating your Amazon Connect Instance with eMite.

This involves the deployment of several additional components on your AWS Cloud, such as Kinesis streams, firehose and elasticsearch.

For easier deployment of these components - we can make use of a Cloudformation template to create a Cloudformation stack.

This guide assumes all components will be deployed in the same region as the Amazon Connect instance, and also all under the same AWS Account.

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
  • CTRFirehosePolicy
    • 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

Specify Stack Details

  • 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 Elasticsearch
      • Default: connect-ctrfirehose
    • ESDomainName
      • Name of the elasticsearch domain. You can leave this as default
      • Default: emite-kinesis-connect
    • CustomerID
      • Unique Customer ID provided by eMite
      • You can find this on the registration page:
    • EmiteIP
      • eMite Server IP you can find this on the registration page:
  • Click Next

Configure Stack Options

  • You can skip the other options here, and click Next

Review

  • Tick this box under Capabilities - since the Cloudformation stack will be creating IAM roles/policies
  • Click Create Stack

Check Status of Stack Creation

On the Cloudformation Console > Stacks, click the stack you created.

You should see the the current status on Stack Info tab, and more details under the Event tab

Wait for Status to change to CREATE_COMPLETE before proceeding to the next step below.

Complete Registration / Send data to eMite team

Please input the below values on the registration page (if from AWS Marketplace):

  • EmiteRole ARN
    • On the Cloudformation Console > Stacks, click the stack you created.
    • Go to the Outputs Tab
    • Copy the ARN returned for EmiteRoleARN
  • Amazon Connect Instance ARN
    • Go to Amazon Connnect > select your Amazon Connect instance
    • On the overview tab, copy the Instance ARN
  • Kinesis Stream ARN
    • On the Cloudformation Console > Stacks, click the stack you created.
    • Go to the Outputs Tab
    • Copy the ARN returned for KinesisStreamARN
  • Elasticsearch Endpoint URL
    • On the Cloudformation Console > Stacks, click the stack you created.
    • Go to the Outputs Tab
    • Copy the URL returned for ESDomainEndpointURL



  • No labels