Integrating an Amazon Connect Customer Profiles Domain with Amazon Connect by API

Overview

This article provides guidance for customers using API-driven Amazon Connect implementations to integrate Customer Profiles with Amazon Connect Data.

Pre-Requisites:

1. Have an Amazon Connect Instance created either by using the AWS Console, AWS SDK, or AWS CloudFormation deployment.
2. Have a Customer Profiles Domain created either through the AWS SDK or AWS CloudFormation deployment.

Key Step: To Integrate an existing Amazon Connect Instance with an existing Customer Profiles Domain, you have to create a Customer Profiles Integration using the Amazon Connect Instance ARN as the Integration URI.

• Set DomainName to your Customer Profiles domain name
• Set Uri to your Connect Instance ARN

Integration Method using PutIntegration API

The PutIntegration API can be used to integrate a Customer Profiles domain with Amazon Connect. Below are two sample code snippets written in Javascript and Python3.

Javascript (AWS SDK V3)

import { ConnectClient } from "@aws-sdk/client-connect";
const connect = new ConnectClient({});
await connect.send(new PutIntegrationCommand({
  DomainName: 'ExampleDomain',
  Uri: 'arn:aws:connect:us-east-1:123456789012:instance/11111111-1111-1111-1111-111111111111' 
}));

Python3 (Boto3 SDK)

import boto3
connect = boto3.client('connect')
connect.put_integration(
  DomainName='ExampleDomain',
  Uri='arn:aws:connect:us-east-1:123456789012:instance/11111111-1111-1111-1111-111111111111',
)

Integration using AWS CloudFormation

The AWS::CustomerProfiles::Integration resource can be used to integrate a Customer Profiles domain with Amazon Connect in CloudFormation. Below are two sample templates written in YAML and JSON format that will integrate a given Customer Profiles domain with the specified Connect Instance ARN.

YAML

AWSTemplateFormatVersion: 2010-09-09
Resources:
  CustomerProfilesConnectIntegration:
    Type: AWS::CustomerProfiles::Integration  
    Properties:
        DomainName: ExampleDomain
        ObjectTypeName: CTR
        Uri: arn:aws:connect:us-east-1:123456789012:instance/11111111-1111-1111-1111-111111111111

JSON

{
	"AWSTemplateFormatVersion": "2010-09-09",
	"Resources": {
	  "CustomerProfilesConnectIntegration": {
	    "Type": "AWS::CustomerProfiles::Integration",
	    "Properties": {
	      "DomainName": "ExampleDomain",
	      "ObjectTypeName": "CTR",
	      "Uri": "arn:aws:connect:us-east-1:123456789012:instance/11111111-1111-1111-1111-111111111111"
	    }
	  }
	}
}

Summary

Integrating Amazon Connect with Customer Profiles provides a unified customer profile across channels. This can be achieved through the PutIntegration API or CloudFormation. The key to enabling this integration is to specifying the Connect Instance ARN as the integration URI in either integration method.