Salesforce Service Cloud Voice with Amazon connect
  • 16 Jun 2024
  • 2 minute read
  • Contributors
  • Dark
    Light
  • PDF

Salesforce Service Cloud Voice with Amazon connect

  • Dark
    Light
  • PDF

Article summary

To integrate Salesforce Service Cloud Voice with Gong, follow these steps: First, enable call recordings in Amazon Connect and select an S3 bucket for storage. Next, configure Kinesis to store CTR logs in S3 by creating a Kinesis Firehose that connects to your CTR log stream. Then, set up a custom contact flow using a Lambda function to retrieve the agent's email address and save it in the CTR file. Ensure Gong has access to the S3 buckets by either creating general access credentials or defining a dedicated user. Finally, enable the Gong Amazon Connect integration by entering the necessary S3 access details and ensuring at least one recent call exists in the S3 buckets for validation. This process allows Gong to retrieve call metadata and recordings effectively.

If you use Salesforce Service Cloud Voice (SCV), follow the steps in this article in order to set up your integration with Gong.

Step 1: Set up Amazon Connect to store calls in S3

  1. In your AWS Console, go to Amazon Connect settings > Data Storage.

  2. Make sure your Call recordings are enabeld.

    AmazonConnect_data_storage2

  3. If the Call recordings were not enabled, choose the S3 bucket to store the call recordings.

    AmazonConnect_call_recording

Step 2: Configure CTRs to be stored in S3

You will already have a kinesis stream for your CTR logs. Connect the kinesis stream to a firehose delivery stream as follows:

  1. Login to you AWS console and create a Kinesis Firehose. See Amazon's documentation on how to create a Kinesis Firehose.

  2. Configure the Kinesis settings as follows:

    1. Select the source and destination as follows:

      • Source: AmazonKinesis Data Streams

      • Destination: Amazon S3

    2. In the Source settings, select your CTR log Kinesis stream.

    3. In Delivery stream name, provide a meaningful name.

    4. In Transform and convert records:

      1. Data transformation must be disabled

      2. Record format conversion must be disabled

    5. In Destination settings enter the following:

      1. S3 bucket: enter s3://

      2. S3 bucket prefix: enter ctr/

      3. Click Create delivery system. It takes approximately 5 minutes for the delivery system to be created.

Step 3: Set up a custom contact flow

If your Amazon connect instance is configured to use Salesforce SSO, the userId in the CTR file is the Id for the Salesforce user, and not the Gong user email. The userId is used to associate the call with the Gong user. Therefore, you must set up a flow which utilizes functions to retrieve the correct email address and save it in the CTR file.

To set up the custom contact flow:

  1. Create a lambda function, which accepts an agent ARN and returns the agent’s email address.

  2. Set up a custom contact flow which is triggered when a call is made. The flow runs the lambda function which retrieves the user's email address and then runs the Set contact attributesblock which assigns the email to the Agent_email attribute in the CTR file.

      AmazonConnect_contact_flow.png

Step 4: Ensure Gong can access both S3 buckets

There are 2 ways you can give Gong access to your S3 buckets:

  1. Create general access credentials for both S3 buckets, and set Gong to retrieve CTR/metadata files and audio/recordings using those credentials.

  2. Contact Gong support to define a dedicated user to access both S3 buckets to retrieve CTR/metadata files and audio/recordings.

Whatever way you chose, make sure that you have all the information you need to enable the integration:

  • 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 5: 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.

  1. In Gong, click Company settings > Data Capture > Telephony systems.

  2. Click + Add telephony system and then choose Amazon Connect.

  3. 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

  4. 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.

  5. Select the Speaker Channel to the desired channel.

  6. Click CONNECT.


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

AI, a genAI helper, will scrub our help center to give you an answer that summarizes our content. Ask a question in plain language and let me do the rest.