- Print
- DarkLight
- PDF
Who can do this? Tech admin
Import Amazon Connect calls to Gong. If you use Salesforce Voice Cloud to make and record calls, see Salesforce Service Cloud Voice with Amazon connect to set up the connection between Gong and Amazon Connect.
Overview
Amazon Connect saves calls in two files:
Call recordings are saved as .wav files
Call metadata, known as contact trace records (CTR), are saved as JSON or zip files
Gong scans the CTRs, and identifies which calls to import based on two rules:
The call owner matches a Gong user with import telephony calls enabled.
The length of the recording is over the minimum import threshold set in your company settings.
Gong extracts the link to the audio file from the CTR, and then imports the call.
Gong can retrieve Amazon Connect call recordings and CTRs only from Amazon Simple Storage Service (Amazon S3). However, they are not saved there by default.
Note:
This article describes native Amazon Connect screens and functionalities. The settings described may vary slightly in the Service Cloud Voice bundle.
Step 1: Set up Amazon Connect to store calls in S3
In your AWS Console, go to Amazon Connect settings > Data Storage.
Enable Call recordings.
Choose the desired S3 bucket to store the call recordings.
Step 2: Configure CTRs to be stored in S3
Export CTRs stored in Amazon Connect by streaming these events to an Amazon Kinesis Data Firehose delivery stream. The Amazon Kinesis Data Firehose can be configured to deliver the CTRs to an S3 bucket.
In your AWS console, go to Amazon Kinesis, select Kinesis Data Firehose, and then click Create delivery stream.
Choose the source and destination:
Set the source to Direct PUT, meaning the data will be pushed directly from Amazon Connect into the Firehose delivery stream.
Set the destination to Amazon S3.
In the Delivery stream name, enter a meaningful name.
Make sure that Transform and convert records settings are Disabled (as they are by default).
For the destination settings:
Provide a valid Amazon S3 bucket. Gong recommends setting the retention period for the S3 bucket to between 1 and 3 months. This is to ensure all calls are imported to Gong and if necessary, to allow enough time for troubleshooting.
Leave Dynamic partitioning disabled.
Leave the optional prefix settings blank.
Note:
By default, Kinesis Data Firehose appends the prefix “YYYY/MM/dd/HH” (in UTC) to the data it delivers to Amazon S3. Gong requires this format to successfully import calls.
Choose Create delivery stream and wait for the delivery stream to become active.
This can take several minutes.
In your AWS console, go to Amazon Connect settings > Data Streaming.
Make sure that data streaming is enabled.
In the Contact Trace Records area, choose Kinesis Firehose, and select the delivery stream created above.
Click Save.
Step 3: Ensure Gong can access both S3 buckets
There are 2 ways you can give Gong access to your S3 buckets:
Create general access credentials for both S3 buckets, and set Gong to retrieve CTR/metadata files and audio/recordings using those credentials.
Have Gong define a dedicated user to access both S3 buckets to retrieve CTR/metadata files and audio/recordings - contact Gong Support to set this up.
Whatever way you chose, make sure that you have all the information you need to enable the integration in step 4:
AWS S3 access key ID (for general access method only)
AWS S3 secret access key (for general access method only)
S3 path - the file path to the CTR files set up in step 2.
Step 4: Enable the Gong-Amazon Connect integration
Before you begin: Make sure that there is at least one call from the past week in the call recording and CTR S3 buckets. This call is used to validate the path when the integration is enabled.
In Gong, click Company settings > Data Capture > Telephony systems.
Click + Add telephony system and then choose Amazon Connect.
According to your chosen access method, enter:
S3 Access Key ID (for general access method only)
S3 Secret Access Key (for general access method only)
The S3 region of the S3 bucket
Add the S3 metadata path - this is the path to the metadata files in the folder structure you set up in step 2.
We get the location of the call recording from the metadata (CTR) file, so there's no need to specify it.
Select the Speaker Channel to the desired channel.
Click CONNECT.
Supported dialer features
This table lists how different features are supported. See Supported dialer features for more details of each feature.
Feature | Description | Supported |
---|---|---|
Additional call types | In addition to regular calls, imports:
| No |
Call disposition | Imports the call outcome | No |
Purpose | Imports the call purpose | No |
Call direction | Indicates whether the call is inbound or outbound | Yes |
Import past calls | When setting up the integration, automatically imports the last 90 days of calls | Yes |
User matching | The field in the call used to match the Gong user to the dialer user | Combine user’s name with company domain name to create an email |
Speaker experience | Indicates if the call is recorded using stereo or mono | Stereo |
Must be connected through a CRM | Some systems must be connected through a CRM in order to make a call | No |